Freigeben über

Azure Maps SDK Renderclientbibliothek für Java – Version 1.0.0-beta.2

  • Artikel

Azure Maps SDK Renderclientbibliothek für Java.

Dieses Paket enthält das Microsoft Azure SDK für Renderverwaltung, das Azure Maps Render-REST-APIs enthält. Azure Maps Render ruft Kopierinformationen oder Karten-/Zustandskacheln ab. Eine Dokumentation zur Verwendung dieses Pakets finden Sie unter Azure Maps Rendern.

Quellcode | API-Referenzdokumentation | REST-API-Dokumentation | Produktdokumentation | Proben

Dokumentation

Es stehen verschiedene Dokumentationen zur Verfügung, die Ihnen den Einstieg erleichtern

Erste Schritte

Voraussetzungen

Hinzufügen des Pakets zu Ihrem Produkt

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

Azure Maps Bibliotheken erfordern eine TokenCredential Implementierung für die Authentifizierung und eine HttpClient Implementierung für den HTTP-Client.

Das Azure Identity-Paket und das Azure Core Netty-HTTP-Paket stellen die Standardimplementierung bereit.

Authentifizierung

Standardmäßig hängt die Azure Active Directory-Tokenauthentifizierung von der korrekten Konfiguration der folgenden Umgebungsvariablen ab.

  • AZURE_CLIENT_ID für die Azure-Client-ID.
  • AZURE_TENANT_ID für die Azure-Mandanten-ID.
  • AZURE_CLIENT_SECRET oder AZURE_CLIENT_CERTIFICATE_PATH für geheime Clientschlüssel oder Clientzertifikate.

Darüber hinaus kann die Azure-Abonnement-ID über die Umgebungsvariable AZURE_SUBSCRIPTION_IDkonfiguriert werden.

Mit der obigen Konfiguration kann der azure Client mit folgendem Code authentifiziert werden:

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

Im Beispielcode wird von einer globalen Azure-Instanz ausgegangen. Ändern AzureEnvironment.AZURE Sie die Variable, falls andernfalls.

Weitere Optionen finden Sie unter Authentifizierung .

Wichtige Begriffe

Unter API-Entwurf finden Sie eine allgemeine Einführung in den Entwurf und die wichtigsten Konzepte zu Azure-Verwaltungsbibliotheken.

Beispiele

Get Map Tile (Kartenkachel abrufen)

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

Abrufen des Kartenkachels

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

Abrufen der Zuordnung von Karten

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

Copyright-Beschriftung abrufen

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

Abrufen eines statischen Kartenbilds

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

Copyright aus Begrenzungsrahmen abrufen

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

Copyright für Kachel abrufen

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

Copyright for World abrufen

client.getCopyrightForWorld(true);

Problembehandlung

Wenn Sie mit den Azure Maps Services interagieren, entsprechen die vom Maps-Dienst zurückgegebenen Fehler denselben HTTP-status Codes, die für REST-API-Anforderungen zurückgegeben werden.

Wenn Sie beispielsweise mit einer ungültigen Koordinate suchen, wird ein Fehler zurückgegeben, der auf "Ungültige Anforderung" hinweist.400

Nächste Schritte

Mehrere Azure Maps Render Java SDK-Beispiele stehen Ihnen im GitHub-Repository des SDK zur Verfügung. Azure Maps Renderbeispiele

Mitwirken

Ausführliche Informationen zum Mitwirken an diesem Repository finden Sie im Leitfaden zum Mitwirken.

  1. Verzweigen sie
  2. Erstellen Ihrer Featurebranch (git checkout -b my-new-feature)
  3. Committen Ihrer Änderungen (git commit -am 'Add some feature')
  4. Pushen in den Branch (git push origin my-new-feature)
  5. Erstellen eines neuen Pull Requests

Aufrufe