1. Home
  2. Dokumente
  3. Adresssuchen
  4. Erste Schritte

Erste Schritte

Vorbedingungen für die Benutzung der Schnittstelle

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.

Wie können wir helfen?