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

Artikel
09/22/2023

(Veraltet)

Azure Maps SDK-Erweiterungsclientbibliothek für Java.

Dieses Paket enthält die Clientbibliothek Azure Maps SDK Elevation, die Azure Maps Elevation-APIs enthält. Eine Dokumentation zur Verwendung dieses Pakets finden Sie unter Azure Maps ELEVATION-REST-APIs.

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

Wichtig

Bitte beachten Sie, dass dieses Paket veraltet ist und nach dem 5. Mai 2023 nicht mehr in Betrieb ist oder beibehalten wird. Alle anderen Azure Maps-APIs, Dienste und Kachelnet-IDs sind von dieser Einstellung nicht betroffen. Anleitungen zum Upgrade finden Sie im Migrationsleitfaden Einstellung von Elevation Services . Weitere Informationen finden Sie in unserer Einstellungsrichtlinie (https://aka.ms/azsdk/support-policies).

Dokumentation

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

API-Referenzdokumentation

Erste Schritte

Voraussetzungen

Java Development Kit (JDK) mit Version 8 oder höher
Azure-Abonnement

Hinzufügen des Pakets zu Ihrem Produkt

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

Einschließen der empfohlenen Pakete

Azure-Verwaltungsbibliotheken 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.

Authentication

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 client
ElevationClient client = new ElevationClientBuilder()
    .credential(tokenCredential)
    .elevationClientId(System.getenv("MAPS_CLIENT_ID"))
    .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

Abrufen von Daten für Punkte

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

Abrufen von Daten für Polyline

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

Abrufen von Daten für den Begrenzungsrahmen

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

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 Beispiele für Azure Maps Elevation Java SDK stehen Ihnen im GitHub-Repository des SDK zur Verfügung. Azure Maps Höhenbeispiele

Mitwirken

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

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

Aufrufe

Freigeben über