Skip to content

Geo Hierarchy

The Geo Hierarchy API retrieves all continents on earth, their countries, regions, cities/districts and quarters/towns.

GET /gis/v1.0/continent/{continent-id}/country/{country-id}/region/{region-id}/city/{city-id}/quarter/{quarter-id}

Supported media types:
XML
JSON

Request

Path parameters

URI path Description
/continent returns a list of all continents
/continent/{continent-id} returns details for the specified continent
/continent/{continent-id}/country returns a list of all countries within the specified continent
/continent/{continent-id}/country/{country-id} returns details for the specified country
/continent/{continent-id}/country/{country-id}/region returns a list of all regions within the specified country
/continent/{continent-id}/country/{country-id}/region/{region-id} returns details for the specified region
/continent/{continent-id}/country/{country-id}/region/{region-id}/city returns a list of all cities and districts within the specified region
/continent/{continent-id}/country/{country-id}/region/{region-id}/city/{city-id} returns details for the specified city or district
/continent/{continent-id}/country/{country-id}/region/{region-id}/city/{city-id}/quarter returns a list of all quarters or towns within the specified city or district respectively
/continent/{continent-id}/country/{country-id}/region/{region-id}/city/{city-id}/quarter/{quarter-id} returns details for the specified quarter or town

Example Response

XML:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<gis:continents xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0" xmlns:gis="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:xlink="http://www.w3.org/1999/xlink">
    <Continent xlink:href="http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/1" id="1" label="Europa"/>
    <Continent xlink:href="http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/2" id="2" label="Asien"/>
    <Continent xlink:href="http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/3" id="3" label="Afrika"/>
    <Continent xlink:href="http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/4" id="4" label="Amerika"/>
    <Continent xlink:href="http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/5" id="5" label="Australien"/>
    <Continent xlink:href="http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/6" id="6" label="Antarktika"/>
</gis:continents>

JSON

{
  "gis.continents": [
    {
      "Continent": [
        {
          "@xlink.href": "http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/1",
          "@id": "1",
          "@label": "Europa"
        },
        {
          "@xlink.href": "http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/2",
          "@id": "2",
          "@label": "Asien"
        },
        {
          "@xlink.href": "http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/3",
          "@id": "3",
          "@label": "Afrika"
        },
        {
          "@xlink.href": "http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/4",
          "@id": "4",
          "@label": "Amerika"
        },
        {
          "@xlink.href": "http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/5",
          "@id": "5",
          "@label": "Australien"
        },
        {
          "@xlink.href": "http://rest.immobilienscout24.de/restapi/api/gis/v1.0/continent/6",
          "@id": "6",
          "@label": "Antarktika"
        }
      ]
    }
  ]
}