Skip to content

Geo Auto Complete

In this Tutorials you can see how to use geo auto complete. The GeoAutoCompletion (GAC) provides a list of resources identified by the following URL autocompletion and suggestion for the German part of the IS24 Geohierarchy as well as for German zip codes and German streets. We also support Austria (but not with all types of search parameters as in Germany)

The full documentation of GAC you can find here

Example 1

Request

Methode: GET
Request-URL:

https://rest.sandbox-immobilienscout24.de/restapi/api/gis/v2.0/geoautocomplete/DEU?i=Berl&l=10&t=quarterOrTown

Response

JSON:

[
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001046",
      "label":"Berlin - Mitte (Mitte)",
      "geopath":{
        "uri":"/de/berlin/berlin/mitte-mitte"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]

  },
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001011",
      "label":"Berlin - Charlottenburg (Charlottenburg)",
      "geopath":{
        "uri":"/de/berlin/berlin/charlottenburg-charlottenburg"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]

  },
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001034",
      "label":"Berlin - Kreuzberg (Kreuzberg)",
      "geopath":{
        "uri":"/de/berlin/berlin/kreuzberg-kreuzberg"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]

  },
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001054",
      "label":"Berlin - Prenzlauer Berg (Prenzlauer Berg)",
      "geopath":{
        "uri":"/de/berlin/berlin/prenzlauer-berg-prenzlauer-berg"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]

  },
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001061",
      "label":"Berlin - Schöneberg (Schöneberg)",
      "geopath":{
        "uri":"/de/berlin/berlin/schoeneberg-schoeneberg"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]

  },
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001017",
      "label":"Berlin - Friedrichshain (Friedrichshain)",
      "geopath":{
        "uri":"/de/berlin/berlin/friedrichshain-friedrichshain"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]

  },
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001076",
      "label":"Berlin - Wilmersdorf (Wilmersdorf)",
      "geopath":{
        "uri":"/de/berlin/berlin/wilmersdorf-wilmersdorf"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]

  },
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001048",
      "label":"Berlin - Neukölln (Neukölln)",
      "geopath":{
        "uri":"/de/berlin/berlin/neukoelln-neukoelln"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]

  },
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001068",
      "label":"Berlin - Tiergarten (Tiergarten)",
      "geopath":{
        "uri":"/de/berlin/berlin/tiergarten-tiergarten"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]

  },
  {
    "entity":{
      "type":"quarterOrTown",
      "id":"1276003001065",
      "label":"Berlin - Steglitz (Steglitz)",
      "geopath":{
        "uri":"/de/berlin/berlin/steglitz-steglitz"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":4
      }
    ]
  }
]

Example 2

Request

Methode: GET
Request-URL:

https://rest.sandbox-immobilienscout24.de/restapi/api/gis/v2.0/geoautocomplete/DEU?i=104&l=10&t=postcode

Response

JSON:

[
  {
    "entity":{
      "type":"postcode",
      "id":"P276-10405-BERLIN",
      "label":"10405 Berlin",
      "value":"10405",
      "geopath":{
        "uri":"/de/10405/berlin"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":3
      }
    ]

  },
  {
    "entity":{
      "type":"postcode",
      "id":"P276-10407-BERLIN",
      "label":"10407 Berlin",
      "value":"10407",
      "geopath":{
        "uri":"/de/10407/berlin"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":3
      }
    ]

  },
  {
    "entity":{
      "type":"postcode",
      "id":"P276-10409-BERLIN",
      "label":"10409 Berlin",
      "value":"10409",
      "geopath":{
        "uri":"/de/10409/berlin"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":3
      }
    ]

  },
  {
    "entity":{
      "type":"postcode",
      "id":"P276-10435-BERLIN",
      "label":"10435 Berlin",
      "value":"10435",
      "geopath":{
        "uri":"/de/10435/berlin"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":3
      }
    ]

  },
  {
    "entity":{
      "type":"postcode",
      "id":"P276-10437-BERLIN",
      "label":"10437 Berlin",
      "value":"10437",
      "geopath":{
        "uri":"/de/10437/berlin"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":3
      }
    ]

  },
  {
    "entity":{
      "type":"postcode",
      "id":"P276-10439-BERLIN",
      "label":"10439 Berlin",
      "value":"10439",
      "geopath":{
        "uri":"/de/10439/berlin"
      }

    },
    "matches":[
      {
        "offset":0,
        "length":3
      }
    ]
  }
]