Context
POST /contesto
Context of the property: demographics of the surrounding area, nearby amenities and public transport stops, each with its distance from the property.
Example Request
curl --location 'https://appraisal.realitycs.it/contesto' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Authorization: Bearer <token>' \
--data-urlencode 'request_uid=a5108688-bf46-4b0a-b6b9-756396769cba'
Request Fields
| Field | Required | Default | Description | Type | Example | Notes |
|---|---|---|---|---|---|---|
request_uid | yes | Identifier of the request | string | a5108688-bf46-4b0a-b6b9-756396769cba | UUID |
JSON keys in the response:
The response is split into three blocks: popolazione, servizi and trasporti.
popolazione
Demographic indicators of the census area. Every entry is an object with a qt value and a desc human readable label in Italian, so the block can be rendered without hardcoding the key names. Values whose key ends with _perc are percentages, the others are absolute counts.
| Key | Description |
|---|---|
p1 | Resident population |
p14_p15_perc | Population aged 0 - 9, in percentage |
p16_p17_perc | Population aged 10 - 19, in percentage |
p18_p19_p20_perc | Population aged 20 - 34, in percentage |
p21_p22_p23_p24_p25_perc | Population aged 35 - 59, in percentage |
p26_p27_p28_perc | Population aged 60 - 74, in percentage |
p29_perc | Population aged over 74, in percentage |
pf1 | Resident households |
pf3_perc | Households of 1 member, in percentage |
pf4_perc | Households of 2 members, in percentage |
pf5_perc | Households of 3 members, in percentage |
pf6_perc | Households of 4 members, in percentage |
pf7_perc | Households of 5 members, in percentage |
pf8_perc | Households of 6 or more members, in percentage |
it_perc | Italian residents, in percentage |
st_perc | Foreign residents, in percentage |
st9_perc | Foreign residents from Europe, in percentage |
st10_perc | Foreign residents from Africa, in percentage |
st11_perc | Foreign residents from America, in percentage |
st12_perc | Foreign residents from Asia, in percentage |
st13_perc | Foreign residents from Oceania, in percentage |
Percentages of foreign residents
st9_perc to st13_perc are shares of the foreign resident population, not of the total population: they add up to 100 among themselves, while st_perc gives the weight of foreigners on the whole area.
servizi
Amenities around the property, grouped by category. Categories are asilo (nursery), banca (bank), farmacia (pharmacy), negozio (shop), ospedale (hospital), parco (park), ristorante (restaurant), scuola (school), supermercato (supermarket) and universita (university).
- nome: Name of the point of interest.
- distanza: Distance from the property, in metres.
- geometry: Encrypted geometry of the point of interest, see the note below.
- geometry_type: Type of the geometry, always
encrypted. - tag: Sub category of the point of interest. Only returned inside
negozio, with values such asabbigliamento,bellezza,servizi.
trasporti
Public transport stops around the property, grouped by category: bus_fermata (bus stop), metro_fermata (underground stop), tram_fermata (tram stop) and stazione (railway station). Entries have the same fields as servizi, without tag.
Empty categories
A category with no result in the surroundings is returned as an empty array rather than being omitted, as parco in the example below.
Encrypted geometries
geometry holds an opaque encrypted token and geometry_type is set to encrypted. The token is meant to be forwarded to the Immobiliare.it mapping components, it cannot be decoded client side.
Example Response
Note
Every category of servizi and trasporti is truncated to a single entry in the example below, the actual response returns all the points of interest found around the property.
{
"contesto": {
"popolazione": {
"it_perc": {
"desc": "italiani residenti percentuale",
"qt": 92.0
},
"p1": {
"desc": "popolazione residente",
"qt": 10984
},
"p14_p15_perc": {
"desc": "popolazione eta 0 - 9 anni percentuale",
"qt": 7.59
},
"p16_p17_perc": {
"desc": "popolazione eta 10 - 19 anni percentuale",
"qt": 8.73
},
"p18_p19_p20_perc": {
"desc": "popolazione eta 20 - 34 anni percentuale",
"qt": 16.57
},
"p21_p22_p23_p24_p25_perc": {
"desc": "popolazione eta 35 - 59 anni percentuale",
"qt": 37.13
},
"p26_p27_p28_perc": {
"desc": "popolazione eta 60 - 74 anni percentuale",
"qt": 17.33
},
"p29_perc": {
"desc": "popolazione eta > 74 anni percentuale",
"qt": 12.65
},
"pf1": {
"desc": "famiglie residenti",
"qt": 6289
},
"pf3_perc": {
"desc": "famiglie 1 componente percentuale",
"qt": 59.66
},
"pf4_perc": {
"desc": "famiglie 2 componenti percentuale",
"qt": 19.81
},
"pf5_perc": {
"desc": "famiglie 3 componenti percentuale",
"qt": 10.6
},
"pf6_perc": {
"desc": "famiglie 4 componenti percentuale",
"qt": 7.44
},
"pf7_perc": {
"desc": "famiglie 5 componenti percentuale",
"qt": 2.08
},
"pf8_perc": {
"desc": "famiglie 6+ componenti percentuale",
"qt": 0.4
},
"st10_perc": {
"desc": "stranieri africa percentuale",
"qt": 8.05
},
"st11_perc": {
"desc": "stranieri america percentuale",
"qt": 19.02
},
"st12_perc": {
"desc": "stranieri asia percentuale",
"qt": 35.08
},
"st13_perc": {
"desc": "stranieri oceania percentuale",
"qt": 0.13
},
"st9_perc": {
"desc": "stranieri europa percentuale",
"qt": 37.72
},
"st_perc": {
"desc": "stranieri residenti percentuale",
"qt": 8.0
}
},
"servizi": {
"asilo": [
{
"distanza": 247,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "SCUOLA DELL'INFANZIA CASA DEI BAMBINI MONTESSORI"
}
],
"banca": [
{
"distanza": 18,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "MONTE DEI PASCHI DI SIENA"
}
],
"farmacia": [
{
"distanza": 126,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "RAIMONDI"
}
],
"negozio": [
{
"distanza": 20,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "BELVEDERE",
"tag": "bellezza"
}
],
"ospedale": [
{
"distanza": 430,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "FATEBENEFRATELLI"
}
],
"parco": [],
"ristorante": [
{
"distanza": 25,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "CANAPE"
}
],
"scuola": [
{
"distanza": 219,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "SCUOLA ELEM.PAR.MONTESSORI S.R.L."
}
],
"supermercato": [
{
"distanza": 128,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "DI.S.MA SAS DI COPPOLA GAETANO & C."
}
],
"universita": [
{
"distanza": 433,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "FACOLTÀ TEOLOGICA DELL'ITALIA SETTENTRIONALE"
}
]
},
"trasporti": {
"bus_fermata": [
{
"distanza": 57,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "MOSCOVA M2"
}
],
"metro_fermata": [
{
"distanza": 112,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "MOSCOVA"
}
],
"stazione": [
{
"distanza": 493,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "MILANO REPUBBLICA"
}
],
"tram_fermata": [
{
"distanza": 404,
"geometry": "gAAAAABqabgJ3Z1vn40grFU8...==",
"geometry_type": "encrypted",
"nome": "P.ZA LEGA LOMBARDA"
}
]
}
}
}
Padded names
Transport stop names may come back right padded with spaces, as "MOSCOVA M2" does in the raw response. Trim the value before displaying it.