Land use
GET /contesto/uso-suolo
How the land around the point is used, broken down by destination, with the prevailing one called out.
Example Request
curl --location 'https://sandbox-context.realitycs.it/contesto/uso-suolo?latitudine=43.32215&longitudine=11.3259&raggio=250' \
--header 'Authorization: Bearer <token>'
Request Fields
| Field | Required | Default | Description | Type | Example | Notes |
|---|---|---|---|---|---|---|
latitudine | yes | Latitude of the point | number | 43.32215 | ||
longitudine | yes | Longitude of the point | number | 11.3259 | ||
raggio | optional | 500 | Search radius around the point, in metres | number | 250 | From 1 to 1000 |
JSON keys in the response:
- destinazione_uso.uso_suolo_per.dettaglio: Share of each land use, in percentage. The six destinations are
residenziale,commerciale,industriale,agricola,naturaleandvarie. Each one is an object with a singleperkey. - destinazione_uso.uso_suolo_per.prevalente: Name of the destination with the largest share, as a lowercase string matching one of the six keys above.
Every destination is always present
The six keys are returned even when their share is 0, so the block has a fixed shape and the percentages add up to 100. You can render all six without checking for missing keys.
Nesting is deeper than it looks
The value of a destination is not the number itself but an object wrapping it: the residential share is at destinazione_uso.uso_suolo_per.dettaglio.residenziale.per, four levels below the root.
Example Response
{
"contesto": {
"destinazione_uso": {
"uso_suolo_per": {
"dettaglio": {
"agricola": {
"per": 0
},
"commerciale": {
"per": 0
},
"industriale": {
"per": 0
},
"naturale": {
"per": 0
},
"residenziale": {
"per": 100
},
"varie": {
"per": 0
}
},
"prevalente": "residenziale"
}
}
}
}