X4 Produktdokumentation

Google Maps

Dieser Adapter greift über das Google Maps SDK for Java auf die Google Maps Platform zu und ermittelt die geografischen Informationen zu einer Adresse. Zudem kann eine Route inklusive Wegpunkten berechnet und eine URL zu einem Google-Maps-Kartenausschnitt erzeugt werden. Der Adapter gibt seine Ergebnisse wahlweise als XML- oder JSON-Dokument aus.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Weitere Informationen zu den Parametern, Statuswerten sowie Input und Output der einzelnen Operationen finden Sie auf den entsprechenden Unterseiten.

Mögliche Werte:

  • Geocode: Konvertiert eine Adresse in Koordinaten (Längengrad und Breitengrad).

  • ReverseGeocode: Konvertiert Koordinaten (Längengrad und Breitengrad) in eine lesbare Adresse.

  • GetRoutes: Berechnet eine Route zwischen zwei oder mehreren Standorten.

  • CreateGoogleURL: Erzeugt eine URL für Google APIs, insbesondere für die Maps Static API.

Parameter

apiKey

✳️

Dieser Parameter ist erforderlich.

API-Schlüssel zur Authentifizierung bei Google Maps

Mögliche Werte:

  • Eindeutige alphanumerische Zeichenkette

Hinweis:

Alternativ können – sofern unterstützt – OAuth.2.0-Mechanismen für die Authentifizierung verwendet werden.

privateKey

Dieser Parameter wird nur für die Operation CreateGoogleURL benötigt.

Privater Schlüssel zum Generieren des URL-Signatur-Secrets

Mögliche Werte:

  • Beliebige gültige Zeichenkette

outputFormat

Ausgabeformat für die API-Antwort definieren

Mögliche Werte:

  • xml (Standard): XML-Dokument ausgeben

  • json: JSON-Dokument ausgeben

timeout

Zeitbeschränkung für TCP-Verbindung in Millisekunden

Mögliche Werte:

  • Beliebige ganze Zahl

  • 0: Keine Zeitbeschränkung

  • 20000 (Standard): Verbindungsaufbau nach 20 Sekunden abbrechen