GeoAutoCompletion (GAC) v2 API

The GeoAutoCompletion (GAC) v2 API replaces the deprecated Region auto
completion API.

Author: fmielke

Immocaster/Immobilienscout/Rest.php

@@ -444,16 +444,28 @@ private function _getAttachment($aArgs)
 	}
 
 	/**
-     * Abfrage der Geo-Informationen per Stadtname, oder
-	 * per Anfangsbuchstaben einer Region.
-	 *
+     * Abfrage von Geo-Objekten anhand eines Inputs
+     *
+     * @param array $aArgs
+     * @return mixed
+     */
+	private function _getGeoAutocompletionSuggestion($aArgs)
+	{
+		$aRequired = array('i','country');
+		$req = $this->doRequest('gis/v2.0/geoautocomplete/'.$aArgs['country'],$aArgs,$aRequired,__FUNCTION__);
+		return parent::getContent($req);
+	}
+
+	/**
+     * Abfrage von Geo-Objekten anhand einer Geo-Entity-ID
+     *
      * @param array $aArgs
      * @return mixed
      */
-	private function _getRegions($aArgs)
+	private function _getGeoAutocompletionEntity($aArgs)
 	{
-		$aRequired = array('q');
-		$req = $this->doRequest('search/v1.0/region',$aArgs,$aRequired,__FUNCTION__);
+		$aRequired = array('id','country');
+		$req = $this->doRequest('gis/v2.0/geoautocomplete/'.$aArgs['country'].'/entity/'.$aArgs['id'],$aArgs,$aRequired,__FUNCTION__);
 		return parent::getContent($req);
 	}
 

README.txt

@@ -1,4 +1,4 @@
-Immocaster PHP SDK v1.1.82
+Immocaster PHP SDK v1.1.83
 ==========================
 Author:     Norman Braun (http://www.medienopfer98.de)
 Copyright:  Immobilien Scout GmbH
@@ -9,6 +9,9 @@ Das PHP SDK von ImmobilienScout24 steht unter der FreeBSD Lizenz zur Verfügung
 History
 =======
 
+SDK Version 1.1.83
+- The GeoAutoCompletion (GAC) v2 API ersetzt die als DEPRECATED markierte Region auto completion API. Migrationshilfe: https://api.immobilienscout24.de/our-apis/gis/migrate-regionautocompletionv1-to-geoautocompletionv2.html 
+
 SDK Version 1.1.82
 - Nutzen der mysqli, anstatt der veralteten mysql Funktionen. Powered by kalunari.
 

index.php

@@ -103,17 +103,33 @@
 <?php
 
 /**
- * Regionen ermitteln.
+ * Geodaten (Suggestion) ermitteln.
+ */
+echo '<h2>GIS - GeoAutoCompletion (GAC) v2 API Suggestion Ressource</h2><br>
+      API Dokumentation: https://api.immobilienscout24.de/our-apis/gis/geoautocompletion-v2.html#suggestion';
+$aParameter = array('country'=>'DEU', // DEU or AUT
+                    'i'=>'Berlin', // input search query
+                    'l'=>'10', // optional, limit max. 50
+                    't'=>'ALL');  // optional, entity types
+$res        = $oImmocaster->getGeoAutocompletionSuggestion($aParameter);
+echo '<div class="codebox"><textarea>'.$res.'</textarea></div>';
+ 
+/**
+ * Geodaten (Entity) ermitteln.
  */
-echo '<h2>Regionen ermitteln</h2>';
-$aParameter = array('q'=>'Ber');
-$res        = $oImmocaster->getRegions($aParameter);
+echo '<h2>GIS - GeoAutocCmpletion (GAC) v2 API Entity Ressource</h2><br>
+      API Dokumentation: https://api.immobilienscout24.de/our-apis/gis/geoautocompletion-v2.html#entity';
+$aParameter = array('country'=>'DEU', // DEU or AUT
+                    'id'=>'1276003001', // The ID of the entity. You get IDs in the result of the suggestion resource.
+                    'g'=>'WGS84'); // optional, GeoCodingType: One of None, GeoId, Lambert, WGS84 (optional)
+$res        = $oImmocaster->getGeoAutocompletionEntity($aParameter);
 echo '<div class="codebox"><textarea>'.$res.'</textarea></div>';
 
 /**
- * Geodaten ermitteln.
+ * Geodaten (Geohierarchy) ermitteln.
  */
-echo '<h2>GIS - Geo Service</h2>';
+echo '<h2>GIS - Geohierarchy</h2><br>
+      API Dokumentation: https://api.immobilienscout24.de/our-apis/gis/geohierarchy.html';
 $aParameter = array('country-id'=>276,'region-id'=>2,'list'=>true);
 $res        = $oImmocaster->geoService($aParameter);
 echo '<div class="codebox"><textarea>'.$res.'</textarea></div>';