Azure Maps bibliothèque de client render sdk pour Java - version 1.0.0-beta.2

Article
07/20/2023

Azure Maps bibliothèque de client render sdk pour Java.

Ce package contient le Kit de développement logiciel (SDK) Microsoft Azure pour la gestion du rendu qui contient Azure Maps API REST render. Azure Maps Render récupère des informations copyrigt ou des vignettes map/state. Pour obtenir de la documentation sur l’utilisation de ce package, consultez Azure Maps Render.

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

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-render</artifactId>
    <version>1.0.0-beta.2</version>
</dependency>

Inclure les packages recommandés

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

Le package Azure Identity et le package HTTP Azure Core Netty 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 builder
MapsRenderClientBuilder builder = new MapsRenderClientBuilder();
builder.credential(tokenCredential);
builder.mapsClientId(System.getenv("MAPS_CLIENT_ID"));
builder.httpLogOptions(new HttpLogOptions().setLogLevel(HttpLogDetailLevel.BODY_AND_HEADERS));

// Builds a client
MapsRenderClient client = builder.buildClient();

L’exemple de code suppose qu’Azure est global. AzureEnvironment.AZURE Modifiez la 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

Get Map Tile

System.out.println("Get Map Tile");
MapTileOptions mapTileOptions = new MapTileOptions();
mapTileOptions.setTilesetId(TilesetId.MICROSOFT_BASE_ROAD);
mapTileOptions.setTileIndex(new TileIndex().setX(10).setY(22).setZ(6));
client.getMapTile(mapTileOptions);

Obtenir un ensemble de vignettes de carte

System.out.println("Get Map Tileset");
new TilesetId();
client.getMapTileset(TilesetId.MICROSOFT_BASE);

Obtenir l’attribution de carte

System.out.println("Get Map Attribution");
GeoBoundingBox bounds = new GeoBoundingBox(-122.414162, 47.57949, -122.247157, 47.668372);
new TilesetId();
client.getMapAttribution(TilesetId.MICROSOFT_BASE, 6, bounds);

Obtenir la légende du droit d’auteur

System.out.println("Get Copyright Caption");
client.getCopyrightCaption();

Obtenir une image statique de carte

System.out.println("Get Map Static Image");
GeoBoundingBox bbox = new GeoBoundingBox(1.355233, 42.982261, 24.980233, 56.526017);
new StaticMapLayer();
new RasterTileFormat();
MapStaticImageOptions mapStaticImageOptions = new MapStaticImageOptions().setStaticMapLayer(StaticMapLayer.BASIC)
    .setMapImageStyle(MapImageStyle.MAIN).setZoom(2)
    .setBoundingBox(bbox).setRasterTileFormat(RasterTileFormat.PNG);
client.getMapStaticImage(mapStaticImageOptions).toStream();

Obtenir les droits d’auteur à partir du cadre englobant

GeoBoundingBox boundingBox = new GeoBoundingBox(52.41064, 4.84228, 52.41072, 4.84239);
client.getCopyrightFromBoundingBox(boundingBox, true);

Obtenir les droits d’auteur pour la vignette

client.getCopyrightForTile(new TileIndex().setX(9).setY(22).setZ(6), true);

Obtenir les droits d’auteur pour le monde

client.getCopyrightForWorld(true);

Dépannage

Lorsque vous interagissez avec les services Azure Maps, les erreurs retournées par le service Maps correspondent aux mêmes codes 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 « Requête incorrecte ». 400

Étapes suivantes

Plusieurs exemples Azure Maps du Kit de développement logiciel (SDK) Render Java sont disponibles dans le dépôt GitHub du SDK. Exemples de rendu Azure Maps

Contribution

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

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

Impressions

Partager via