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