Bing Maps

Der Adapter greift auf Bing Maps über dessen Webservice-Schnittstelle in Version 1 zu und ermittelt die geografischen Informationen zu einer Adresse. Zudem kann eine Route inklusive Wegpunkten berechnet und eine URL zu einem Bing Maps Kartenausschnitt erzeugt werden. Der Adapter gibt seine Ergebnisse wahlweise als XML- oder JSON-Dokument aus.

Um die Bing Maps API nutzen zu können, wird ein Bing Maps API Key benötigt.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Funktions-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
CreateBingURL: URL zu einem Bing Maps Webservice

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: de.softproject.integration.adapter.geo.microsoft.BingMapsAdapter : Hauptklasse (Standard)
bingMapsKey	Schlüssel zur Nutzung der Bing Maps API
outputFormat	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 (Entspricht dem HTTP-Status-Code 200)
0 (empty)	Die Anfrage war zwar erfolgreich, jedoch wurde kein Ergebnis zurückgegeben
-1 (failed)	Die Anfrage schlug aufgrund eines technischen Fehlers fehl
-HTTP-Status-Code	Die Anfrage wurde ausgeführt, jedoch mit einem Status-Code ungleich 200 beendet. Fehlerinterpretation entsprechend dem HTTP-Status-Code.