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.