listings/in (GET)

Ressourcen-Pfad

/api_rst/v2/listings/in

http://www.yellowmap.de/api_rst/v2/listings/in

Beschreibung

Über diese Suche können Listings in der Nähe eines Standorts gefunden werden. Die Standortangabe kann auf verschiedene Weise erfolgen:

1. Angabe einer Adresse in einem Feld: „Karlsstraße 1, Karlsruhe“ oder „CAS-Weg“.
2. Angabe von Adressbestandteilen in unterschiedlichen Feldern: Für die Postleitzahl beispielsweise „76131“.

Parameter

Name Beschreibung Datentyp
singleslot In diesem Feld können Adressbestandteile in beliebiger Reihenfolge angegeben werden. Ist erforderlich, falls die Stadt oder die Postleitzahl nicht angegeben wird.
[erforderlich]
string
isoCountryCode ISO-Angabe des Landes.
[erforderlich]
string
zip Postleitzahl oder Stadt ist erforderlich.
[erforderlich]
string
city Postleitzahl oder Stadt ist erforderlich.
[erforderlich]
string
street Straße und Hausnummer. string
maxRadius Suchradius (Standard: 1000 Meter)
maxRadius = -1 bedeutet: keine Suchradius-Begrenzung; es findet eine automatische Suchoptimierung statt.
uint
branches Branchencodes, nach denen man suchen kann.
Mehrere Branchen können über UND oder ODER logisch verknüpft werden. Klammern werden nicht unterstützt. Beachten Sie bitte, dass ODER stärker ist als UND.
Beispiel: A|B|C&B|C|D
Falls Stichworte und Branchen angegeben sind, wird eine reine Branchensuche durchgeführt.
string
catchwords Stichworte, nach denen gesucht werden soll. Mehrere Stichworte werden durch Komma getrennt.
Falls Stichworte und Branchen angegeben sind, wird eine reine Branchensuche durchgeführt.
string
freefilter Zusätzlicher Filter, der unter bestimmten Bedingungen eingesetzt werden kann. string
top Die Anzahl an Listings, die zurückkommen werden sollen (Standard: 10). uint
orderBy Gibt an, wie das Ergebnis sortiert werden soll (Standard: DISTANCE_COMPANY_NAME). SORT_CONDITIONS
page Seite, die zurückgegeben werden soll (Standard: 1). uint
perPage Gibt an, wie viele Listings pro Seite zurückgegeben werden sollen. uint
isoLocale ISO-Angabe der angeforderten Kultur (Locale). string
localIsoCountryCode ISO-Landcode der Webseite, auf der Inhalte angezeigt werden. string
channel Optionaler Parameter für die Protokollierung. string
coordFormatOut Koordinatenformat im Ausgabcontainer (Standard: GEODECIMAL_POINT). COORD_FORMAT
version Gibt an, dass ein Container mit der versionsabhängigen Struktur zurückgegeben werden soll (siehe Versionierung). string
addition Parameter, über den zusätzliche Angaben übergeben werden können (nur sinnvoll unter bestimmten Bedingungen).
Bei Bedarf teilen wir Ihnen die notwendigen Übergabeparameter mit: Kontakt
string

Request Header

Name Beschreibung
Authorization Siehe Autorisierung

Rückgabe (application/json)

Der Rückgabecontainer ist vom Typ SearchListingResponse.

Beispiel

Codebeispiel: listings/in (GET)

<html>
   <script src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
   <script>
      $.ajax({
         url: "http://www.yellowmap.de/api_rst/v2/listings/in",
         data: {
            zip: "77830",
            isoCountryCode: "DE",
            branches: "GAUT"
         },
         type: "GET",
         headers: {
            Authorization: "YM SYSTEM_PARTNER:SECURITY_ID"
         }
      }).done(function(data) {
         alert("Count of results: " + data.geoItems.length);
   </script>
</html>

Fehler

Fehler sind vom Typ ErrorResponse.

Fehlercode Beschreibung
400
BAD REQUEST, die Anfrage wurde falsch gestellt.
401
UNAUTHORIZED, ungültige Kombination aus systemPartner und securityId.
403
FORBIDDEN, systemPartner und securityId sind korrekt, aber der Zugriff auf die gewünschten Daten ist nicht
erlaubt.
404 NOT FOUND
500 SERVER ERROR, es ist etwas Unvorhergesehenes eingetreten.
Bitte setzen Sie sich mit uns in Verbindung: Support