Azure Maps bibliothèque cliente d’élévation du SDK pour Java - version 1.0.0-beta.2

Article
09/21/2023

(Déconseillé)

Azure Maps bibliothèque cliente d’élévation du SDK pour Java.

Ce package contient la bibliothèque cliente Elevation du SDK Azure Maps qui contient Azure Maps API Elevation. Pour obtenir de la documentation sur l’utilisation de ce package, consultez Azure Maps API REST d’élévation.

| Code source Documentation de référence sur les | APIDocumentation | sur l’API REST | Documentation produit Échantillons

Important

Veuillez noter que ce package a été déprécié et ne sera plus en service ou mis à jour après le 5 mai 2023. Toutes les autres API Azure Maps, services et tilesetID ne sont pas affectés par cette mise hors service. Reportez-vous au guide de migration Elevation Services Retirement pour obtenir des conseils sur la mise à niveau. Pour plus d’informations, reportez-vous à notre politique de dépréciation (https://aka.ms/azsdk/support-policies).

Documentation

Diverses documentations sont disponibles pour vous aider à démarrer

Documentation de référence de l’API

Prise en main

Prérequis

Kit de développement Java (JDK) avec la version 8 ou ultérieure
Abonnement Azure

Ajout du package à votre produit

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

Inclure les packages recommandés

Les bibliothèques de gestion Azure nécessitent une TokenCredential implémentation pour l’authentification et une HttpClient implémentation pour le client HTTP.

Le package Azure Identity et le package HTTP Netty Azure Core fournissent l’implémentation par défaut.

Authentification

Par défaut, l’authentification par jeton Azure Active Directory dépend de la configuration correcte des variables d’environnement suivantes.

AZURE_CLIENT_ID pour l’ID client Azure.
AZURE_TENANT_ID pour l’ID de locataire Azure.
AZURE_CLIENT_SECRET ou AZURE_CLIENT_CERTIFICATE_PATH pour la clé secrète client ou le certificat client.

En outre, l’ID d’abonnement Azure peut être configuré via la variable d’environnement AZURE_SUBSCRIPTION_ID.

Avec la configuration ci-dessus, azure le client peut être authentifié par le code suivant :

// 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();

L’exemple de code suppose qu’Azure est global. Modifiez la AzureEnvironment.AZURE variable dans le cas contraire.

Pour plus d’options , consultez Authentification.

Concepts clés

Consultez Conception d’API pour une présentation générale de la conception et des concepts clés sur les bibliothèques de gestion Azure.

Exemples

Obtenir des données pour les points

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

Obtenir des données pour Polyline

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

Obtenir des données pour le cadre englobant

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

Dépannage

Lorsque vous interagissez avec les services Azure Maps, les erreurs retournées par le service Maps correspondent aux mêmes codes de status HTTP retournés pour les demandes d’API REST.

Par exemple, si vous effectuez une recherche avec une coordonnée non valide, une erreur est retournée, indiquant « Demande incorrecte ». 400

Étapes suivantes

Plusieurs exemples Azure Maps sdk Java Elevation sont disponibles dans le référentiel GitHub du SDK. exemples d’élévation de Azure Maps

Contribution

Pour plus d’informations sur la contribution à ce dépôt, consultez le guide de contribution.

Fourchez-le
Créer votre branche de fonctionnalité (git checkout -b my-new-feature)
Valider vos modifications (git commit -am 'Add some feature')
Envoyer (push) vers la branche (git push origin my-new-feature)
Créer une demande de tirage

Impressions

Partager via