Listen und Regionen

Hier erfahren Sie alles über Abfragen von kompletten Immobilienbeständen nach Regionen oder Umkreis. Es wird auch erklärt, wie man auf den eigenen Bestand zugreifen kann.

Regionen ermitteln

Für eine Suche nach einer Region benötigt man mindestens drei Buchstaben die als Parameter "q" übergeben werden. Anhand dieser Buchstaben wird eine Autovervollständigung ausgeführt. So erhält man für den Wert "Ber" beispielsweise "Berlin", "Berlin-Kreuzberg" sowie auch "Bergkamen" zurück.

<?php

$aParameter = array('q'=>'Ber');
$res = $oImmocaster->getRegions($aParameter);

?>

Rückgabe

Als Rückgabe erhält man eine Liste mit allen Regionen die mit "Ber" beginnen. Diese Liste enthält neben dem Namen der Region auch die Geo-ID und die Anzahl der gefundenen Objekte in der Region. Eine Liste könnte in etwa so aussehen.

<region:regions xmlns:region="http://rest.immobilienscout24.de/schema/search/region/1.0">
    <region>
        <name>Berlin</name>
        <geoCodeId>1276003001</geoCodeId>
        <amount>10026</amount>
    </region>
    <region>
        <name>Berlin-Spandau (Spandau)</name>
        <geoCodeId>1276003001063</geoCodeId>
        <amount>686</amount>
    </region>
    ...
</region:regions>

Parameter

q - Der Pflichtparameter "q" muss einen String übergeben, der aus mindestens drei Buchstaben besteht. Dieser String steht für die jeweilige Region, die gesucht wird. Z.b. wird bei der Suche nach "ber" u. A. die Stadt Berlin gefunden.

realEstateType - Sobald man der Funktion den Parameter "realEstateType" mitgibt, erhält man die Anzahl der Objekte des jeweiligen Typs als "amount" im Ergebnis zurück.