Compartir a través de

biblioteca cliente de Elevación del SDK de Azure Maps para Java: versión 1.0.0-beta.2

  • Artículo

(Desusado)

Azure Maps biblioteca cliente elevation del SDK para Java.

Este paquete contiene la biblioteca cliente de Elevación del SDK de Azure Maps que contiene Azure Maps ELEVATION API. Para obtener documentación sobre cómo usar este paquete, consulte Azure Maps API rest de Elevación.

Código | fuenteDocumentación | de referencia de APIDocumentación | de la API REST | Documentación del productoMuestras

Importante

Tenga en cuenta que este paquete ha quedado en desuso y ya no estará en servicio ni se mantendrá después del 5 de mayo de 2023. El resto de api de Azure Maps, servicios e iconosetID no se ven afectados por esta retirada. Consulte la guía de migración Retirada de servicios de elevación para obtener instrucciones sobre la actualización. Consulte nuestra directiva de desuso (https://aka.ms/azsdk/support-policies) para obtener más detalles.

Documentación

Hay varias documentación disponibles para ayudarle a empezar.

Introducción

Requisitos previos

Adición del paquete al producto

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-maps-elevation</artifactId>
    <version>1.0.0-beta.2</version>
</dependency>

Las bibliotecas de administración de Azure requieren una TokenCredential implementación para la autenticación y una HttpClient implementación para el cliente HTTP.

El paquete de identidad de Azure y el paquete HTTP de Azure Core Netty proporcionan la implementación predeterminada.

Authentication

De forma predeterminada, la autenticación de tokens de Azure Active Directory depende de la configuración correcta de las siguientes variables de entorno.

  • AZURE_CLIENT_ID para el identificador de cliente de Azure.
  • AZURE_TENANT_ID para el identificador de inquilino de Azure.
  • AZURE_CLIENT_SECRET o AZURE_CLIENT_CERTIFICATE_PATH para el secreto de cliente o el certificado de cliente.

Además, el identificador de suscripción de Azure se puede configurar a través de la variable AZURE_SUBSCRIPTION_IDde entorno .

Con la configuración anterior, azure el cliente se puede autenticar mediante el código siguiente:

// Authenticates using Azure AD building a default credential
// This will look for AZURE_CLIENT_ID, AZURE_TENANT_ID, and AZURE_CLIENT_SECRET env variables
DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build();

// Creates a client
ElevationClient client = new ElevationClientBuilder()
    .credential(tokenCredential)
    .elevationClientId(System.getenv("MAPS_CLIENT_ID"))
    .buildClient();

En el código de ejemplo se supone que Azure global. Cambie la AzureEnvironment.AZURE variable si no.

Consulte Autenticación para obtener más opciones.

Conceptos clave

Consulte Diseño de API para obtener una introducción general sobre el diseño y los conceptos clave en las bibliotecas de administración de Azure.

Ejemplos

Obtener datos para puntos

client.getDataForPoints(Arrays.asList(
    new GeoPosition(-121.66853362143818, 46.84646479863713),
    new GeoPosition(-121.68853362143818, 46.856464798637127)));

Obtención de datos para polilínea

client.getDataForPolyline(Arrays.asList(
    new GeoPosition(-121.66853362143818, 46.84646479863713),
    new GeoPosition(-121.65853362143818, 46.85646479863713)), 5);

Obtener datos para el rectángulo de selección

client.getDataForBoundingBox(new GeoBoundingBox(-121.668533621438, 46.8464647986371,
    -121.658533621438, 46.8564647986371), 3, 3);

Solución de problemas

Al interactuar con los servicios de Azure Maps, los errores devueltos por el servicio Maps corresponden a los mismos códigos de estado HTTP devueltos para las solicitudes de la API REST.

Por ejemplo, si busca con una coordenada no válida, se devuelve un error, que indica "Solicitud incorrecta".400

Pasos siguientes

Hay varios ejemplos de SDK de Java de elevación de Azure Maps disponibles en el repositorio de GitHub del SDK. Muestras de elevación de Azure Maps

Contribuciones

Para más información sobre cómo contribuir a este repositorio, consulte la guía de contribución.

  1. Bifurcarlo
  2. Creación de la rama de características (git checkout -b my-new-feature)
  3. Confirmar los cambios (git commit -am 'Add some feature')
  4. Inserción en la rama (git push origin my-new-feature)
  5. Creación de una nueva solicitud de incorporación de cambios

Impresiones