Backend-Service

Die Backend-Services sind eigenständige Services. Hierbei handelt es sich um eine Enterprise-Funktion der SmartMaps. Die Funktionalität ist in SmartMaps FREE nicht verfügbar. Für die Freischaltung eines Dienstes und weiteren Fragen stehen wir Ihnen gerne in unserem Supportbereich zur Verfügung.

Umkreissuche SOAP

Um die Schnittstelle verwenden zu können, benötigen Sie einen Partnernamen und einen Zugriffsschlüssel (siehe Autorisierung).

SOAP-Service

Formal handelt es sich um einen SOAP-Service (SOAP 1.1 und 1.2), dessen Beschreibung Sie über die Abfrage der WSDL erhalten:

https://www.yellowmap.de/api_ws/v2/AddressSearches.asmx?wsdl  

Grundsätzlich kann der Service auch per http-GET oder http-POST genutzt werden. Wahlweise wird XML oder JSON zurückgegeben. Hierfür gibt es jeweils einen separaten Zugang:

XML

https://www.yellowmap.de/api_ws/v2/AddressSearches.asmx  

JSON/JSONP

https://www.yellowmap.de/api_js/v2/AddressSearches.asmx  

Bitte beachten Sie, dass auch die JSON-Rückgabe in ein XML-Tag eingefasst ist.

Parameter-Konventionen

Die Parameter können in beliebiger Reihenfolge übergeben werden. Einige Parameter sind optional. Diejenigen Parameter, die für einen bestimmten Aufruf benötig werden, sind unter der jeweiligen Aufrufmethode gekennzeichnet.

Bitte beachten Sie, dass die Paramter im UTF-8-Format und URL-codiert übergeben werden müssen.

Test der Schnittstelle

Sie können die Schnittstelle über einen Browser testen. Wenn Sie eines der Suchformulare über einen Browser aufrufen, zum Beispiel

https://www.yellowmap.de/api_ws/v2/AddressSearches.asmx?op=SearchBranchesCoordBasedPosition 

generiert der Webserver Code mit einem Formularfeld action, in dem der Port angegeben ist: www.yellowmap.de:4000/ …

Bevor Sie das Formular in einem Browser abschicken, müssen Sie das :4000 (zum Beispiel mit Hilfe von Firebug) entfernen – andernfalls erhalten Sie einen Netzwerkfehlermeldung.