Regions
POST /locations/regions HTTP/2
Get information on lower division levels, such as borders, population development, the development of unemployment rates, or the average available income per inhabitant.
Example use-cases:
- Display the borders of divisions on a map
- Display general information of different division levels
- Display different charts known from quis.de
- Use different indicators for your calculations and forecasts
Request
curl -X POST 'https://quis.de/api/v2/locations/regions?api_key=<YOUR-API-KEY>' \
-H 'Content-Type: application/json' \
-d '{
"location": {
"address": {
"street": "Gasstraße",
"houseNumber": "10",
"postCode": "22761",
"city": "Hamburg"
}
}
}'
| Field | Description | Type | Remarks |
|---|---|---|---|
| location | Location of the property | Location |
Response
{
"divisionLevel2": {
"id": "00000000",
"name": "Deutschland",
"levelDesignation": "Bundesrepublik",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
9.8845262,
53.580345
],
...
]
]
]
}
},
"divisionLevel4": {
"id": "02",
"name": "Hamburg",
"levelDesignation": "Freie und Hansestadt",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
9.8845262,
53.580345
],
...
]
]
]
}
},
"divisionLevel6": {
"id": "02000",
"name": "Hamburg",
"levelDesignation": "Kreisfreie Stadt",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
9.8845262,
53.580345
],
...
]
]
]
}
},
"divisionLevel8": {
"id": "02000000",
"name": "Hamburg",
"levelDesignation": "Stadt",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
9.8845262,
53.580345
],
...
]
]
]
}
},
"divisionLevel100": {
"id": "22761",
"name": "22761",
"levelDesignation": "Postleitzahl",
"geometry": {
"type": "MultiPolygon",
"coordinates": [
[
[
[
9.8845262,
53.580345
],
...
]
]
]
}
},
"currency": "EUR",
"population": 1801101,
"numberOfApartments": 985422,
"broadbandAvailability": {
"value": 0.98,
"class": "supplied"
},
"futurePotential": 1.0,
"rentalLaw": {
"divisionLevel": "divisionLevel8",
"rentIndexUrl": "https://www.hamburg.de/mietenspiegel/",
"hasRentIndex": true,
"hasRentCap": true,
"hasRentControl": true
},
"ageGroup": {
"below18": 0.09,
"between18And30": 0.12,
"between30And45": 0.25,
"between45And65": 0.24,
"between65And75": 0.2,
"above75": 0.1
},
"household": {
"child": 0.3,
"onePerson": 0.3,
"twoPerson": 0.3,
"threePerson": 0.25,
"fourOrMorePerson": 0.25
},
"populationDevelopment": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "Hamburg",
"data": [
{
"x": "2011-12-31",
"y": 100
},
{
"x": "2012-12-31",
"y": 105
}
]
},
{
"divisionLevel": "divisionLevel2",
"title": "Deutschland",
"data": [
{
"x": "2011-12-31",
"y": 100
},
{
"x": "2012-12-31",
"y": 102
}
]
}
]
},
"populationForecast": {
"series": [
{
"title": "Hamburg",
"divisionLevel": "divisionLevel6",
"data": [
{
"x": "2021-01-01",
"y": 100
},
{
"x": "2025-01-01",
"y": 102.25
}
]
},
...
{
"title": "Deutschland",
"divisionLevel": "divisionLevel2",
"data": [
{
"x": "2021-01-01",
"y": 100
},
{
"x": "2025-01-01",
"y": 101.25
}
]
}
]
},
"ageDistribution": {
"series": [
{
"divisionLevel": "divisionLevel2",
"title": "Hamburg",
"data": [
{
"x": "below_18",
"y": 0.22
},
{
"x": "18_to_29",
"y": 0.18
}
]
},
{
"divisionLevel": "divisionLevel4",
"title": "Deutschland",
"data": [
{
"x": "below_18",
"y": 0.22
},
{
"x": "18_to_29",
"y": 0.18
}
]
}
]
},
"populationDevelopmentByAge": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "below_18",
"data": [
{
"x": "2011-12-31",
"y": 100
},
{
"x": "2012-12-31",
"y": 105
}
]
},
{
"divisionLevel": "divisionLevel8",
"title": "18_to_29",
"data": [
{
"x": "2011-12-31",
"y": 100
},
{
"x": "2012-12-31",
"y": 102
}
]
}
]
},
"migrationBalance": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "immigration",
"data": [
{
"x": "2011-12-31",
"y": 0.0543
},
{
"x": "2012-12-31",
"y": 0.0512
}
]
},
{
"divisionLevel": "divisionLevel8",
"title": "emigration",
"data": [
{
"x": "2011-12-31",
"y": 0.0543
},
{
"x": "2012-12-31",
"y": 0.0512
}
]
}
]
},
"constructionCompletions": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "one_to_two_apartments",
"data": [
{
"x": "2011-12-31",
"y": 0.0543
},
{
"x": "2012-12-31",
"y": 0.0512
}
]
},
{
"divisionLevel": "divisionLevel8",
"title": "more_than_three_apartments",
"data": [
{
"x": "2011-12-31",
"y": 0.0543
},
{
"x": "2012-12-31",
"y": 0.0512
}
]
}
]
},
"unemploymentRates": {
"series": [
{
"divisionLevel": "divisionLevel6",
"title": "unemployment_rate",
"data": [
{
"x": "2011-12-31",
"y": 0.0543
},
{
"x": "2012-12-31",
"y": 0.0512
}
]
},
{
"divisionLevel": "divisionLevel6",
"title": "minimum_benefit_rate",
"data": [
{
"x": "2011-12-31",
"y": 0.0543
},
{
"x": "2012-12-31",
"y": 0.0512
}
]
}
]
},
"immigrantRates": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "Hamburg",
"data": [
{
"x": "2011-12-31",
"y": 0.0543
},
{
"x": "2012-12-31",
"y": 0.0512
}
]
},
{
"divisionLevel": "divisionLevel2",
"title": "Deutschland",
"data": [
{
"x": "2011-12-31",
"y": 0.0543
},
{
"x": "2012-12-31",
"y": 0.0512
}
]
}
]
},
"availableIncome": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "Hamburg",
"data": [
{
"x": "2019-12-31",
"y": 20000.00
}
]
},
{
"divisionLevel": "divisionLevel2",
"title": "Deutschland",
"data": [
{
"x": "2019-12-31",
"y": 20000.00
}
]
}
]
},
"incomeDevelopment": {
"series": [
{
"divisionLevel": "divisionLevel8",
"title": "Hamburg",
"data": [
{
"x": "2011-12-31",
"y": 100
},
{
"x": "2012-12-31",
"y": 105
}
]
},
{
"divisionLevel": "divisionLevel2",
"title": "Deutschland",
"data": [
{
"x": "2011-12-31",
"y": 100
},
{
"x": "2012-12-31",
"y": 102
}
]
}
]
},
"apartmentUsageDistribution": {
"series": [
{
"divisionLevel": "divisionLevel2",
"title": "Hamburg",
"data": [
{
"x": "rental",
"y": 0.22
},
{
"x": "owner",
"y": 0.18
},
{
"x": "other",
"y": 0.07
}
]
},
{
"divisionLevel": "divisionLevel2",
"title": "Deutschland",
"data": [
{
"x": "rental",
"y": 0.22
},
{
"x": "owner",
"y": 0.18
},
{
"x": "other",
"y": 0.07
}
]
}
]
},
"apartmentOwnerDistribution": {
"series": [
{
"divisionLevel": "divisionLevel4",
"title": "Hamburg",
"data": [
{
"x": "private",
"y": 0.22
},
{
"x": "cooperative",
"y": 0.18
},
{
"x": "private_company",
"y": 0.18
},
{
"x": "other",
"y": 0.07
}
]
},
{
"divisionLevel": "divisionLevel2",
"title": "Deutschland",
"data": [
{
"x": "private",
"y": 0.22
},
{
"x": "cooperative",
"y": 0.18
},
{
"x": "private_company",
"y": 0.18
},
{
"x": "other",
"y": 0.07
}
]
}
]
},
"apartmentByLivingAreaDistribution": {
"series": [
{
"divisionLevel": "divisionLevel4",
"title": "Hamburg",
"data": [
{
"x": "below_40",
"y": 0.22
},
{
"x": "40_to_59",
"y": 0.18
},
{
"x": "60_to_79",
"y": 0.18
},
{
"x": "80_to_99",
"y": 0.07
},
{
"x": "100_to_119",
"y": 0.18
},
{
"x": "above_120",
"y": 0.18
},
]
},
{
"divisionLevel": "divisionLevel2",
"title": "Deutschland",
"data": [
{
"x": "below_40",
"y": 0.22
},
{
"x": "40_to_59",
"y": 0.18
},
{
"x": "60_to_79",
"y": 0.18
},
{
"x": "80_to_99",
"y": 0.07
},
{
"x": "100_to_119",
"y": 0.18
},
{
"x": "above_120",
"y": 0.18
},
]
}
]
},
"meta": {
"url": "https://quis.de/app/dashboard?coordinate=53.56238135,9.91097785903008",
"version": "2.15.0"
}
}
| Field | Description | Type | Remarks |
|---|---|---|---|
| divisionLevel2 | The level 2 division | Division | |
| divisionLevel4 | The level 4 division | Division | |
| divisionLevel6 | The level 6 division | Division | |
| divisionLevel8 | The level 8 division | Division | |
| divisionLevel100 | The level 100 division | Division | |
| currency | The local currency | Currency | Important for all kind of prices and price charts |
| population | The population of the level 8 division | integer | |
| numberOfApartments | The numberOfApartments in the level 8 division | integer | |
| broadbandAvailability | The broadband availability of the level 8 division | PercentageClass | possible values for broadbandAvailability.class are not_supplied, partially_supplied, largely_supplied, mainly_supplied, supplied |
| futurePotential | The future potential of the level 6 division | Score | |
| rentalLaw | The rental law of the region | RentalLaw | |
| ageGroup | The age groups for the level 8 division | AgeGroup | |
| household | The households of the level 8 division | Household | |
| populationDevelopment | The relative population development since the year 2011 for different division levels | Chart | |
| populationForecast | The demographic population forecast relative to the base year 2021 for the different division levels | Chart | |
| ageDistribution | The demographic age distribution | Chart | series[i].data[i].x`s enum: AgeGroupClass |
| populationDevelopmentByAge | The relative demographic population development based on 2011 for the level 8 division | Chart | series[i].title`s type is AgeGroupClass |
| migrationBalance | Migration balance and of recent years for the level 8 division | Chart | possible series[i].title`s enum: immigration, emigration, net_migration |
| apartmentConstructions | Number of apartments per building size and 10,000 inhabitants built in recent years for the level 8 division | Chart | possible series[i].title`s enum: one_to_two_apartments, more_than_three_apartments |
| unemploymentRates | Unemployment developement and minimum security rates of recent years for the level 6 division | Chart | possible series[i].title`s enum: unemployment_rate, minimum_benefit_rate |
| immigrantRates | Immigrant rates of recent years for different divisions | Chart | |
| availableIncome | Average available income per inhabitant for different divisions | Chart | |
| incomeDevelopment | The relative income development (base year 2011) for different divisions | Chart | |
| apartmentUsageDistribution | The usage distribution of apartments. | Chart | series[i].data[i].x`s enum: rental, owner, other |
| apartmentOwnerDistribution | The owner distribution of apartments. | Chart | series[i].data[i].x`s enum: private, cooperative, private_company, other |
| apartmentByLivingAreaDistribution | The living area distribution of apartments. | Chart | series[i].data[i].x`s enum: below_40, 40_to_59, 60_to_79, 80_to_99, 100_to_119, above_120 |
| meta | Meta information of the API | Meta |
RentalLaw
| Field | Description | Type | Remarks |
|---|---|---|---|
| divisionLevel | The division level of the rental law | DivisionLevel | |
| rentIndexUrl | Url to the official rent index | string | |
| hasRentIndex | Does the level 8 Division has a rent index? | boolean | |
| hasRentCap | Does the level 8 Division has a rental cap? | boolean | |
| hasRentControl | Does the level 8 Division has a rental control? | boolean |