X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

Google Maps

Der Adapter greift auf Google Maps über dessen Webservice-Schnittstelle zu und ermittelt zu einer Adresse die geografischen Informationen. 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.

Standardmäßig wird die kostenfreie Google Maps API verwendet; Um sämtliche Leistungen uneingeschränkt zu nutzen, können Sie mit diesem Adapter auch die Google Maps API Premier verwenden, indem Sie entsprechende Zugangsdaten in den Adapterparametern clientID und privateKey hinterlegen.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte:

  • Geocode : Zu einer Adresse sämtliche Geoinformationen (Anschrift, Bezirk/Land, Nation, Koordinaten etc.) ermitteln

  • ReverseGeocode: Zu einer Dezimalkoordinate sämtliche Geoinformationen (Anschrift, Bezirk/Land, Nation, Koordinaten etc.) ermitteln

  • GetDirections: Route zwischen einem Start- und Zielpunkt mit beliebig vielen Wegpunkten ermitteln

  • CreateGoogleURL: URL zu einer Google Maps-Kartenausschnitts-Grafik erzeugen (bei Nutzung der Google Maps API Premier zudem mit signierter URL)

Parameter

Adapter

Hauptklasse des Adapters (nicht verändern!)

Mögliche Werte: de.softproject.integration.adapter. geo.google.Google MapsAdapter: Hauptklasse (Standard)

clientID

Kundennummer (Client ID) zur Nutzung der Google Maps API Premier

Mögliche Werte:

  • Beliebige gültige Zeichenkette

  • (leer): Kostenlose Google Maps API verwenden (Standard)

privateKey

Private Key für das Google Maps API Premier (wenn Parameter clientID gesetzt ist)

Mögliche Werte: Beliebige gültige Zeichenkette

outputFormat

Google Maps-Ausgabeformat für Anfragen definieren

Mögliche Werte:

  • xml: XML-Dokument ausgeben

  • json: JSON-Dokument ausgeben

timeout

Zeitbeschränkung für den Verbindungsaufbau in Millisekunden

Mögliche Werte:

  • Beliebige ganze Zahl

  • 0: Keine Zeitbeschränkung

  • 20000: Nach 20 Sekunden den Verbindungsaufbau abbrechen

pxHost

IP-Adresse oder Host-Name eines Proxy-Servers

Mögliche Werte: Beliebige gültige Zeichenkette (z.B. 192.168.1.1)

pxPort

Portnummer des Proxy-Servers

Mögliche Werte: Beliebige ganze Zahl

pxLogin

Benutzername für den Proxy-Server

Mögliche Werte: Beliebige Zeichenkette

pxPwd

Passwort für den Proxy-Server

Mögliche Werte: Beliebige Zeichenkette

Statuswerte

1 (successful)

Die Anfrage war erfolgreich und ein Ergebnis wurde zurückgegeben

0 (empty)

Die Anfrage war zwar erfolgreich, jedoch wurde kein Ergebnis zurückgegeben

-1 (failed)

Die Anfrage schlug aufgrund eines technischen Fehlers fehl