Skip to content

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, naturale and varie. Each one is an object with a single per key.
  • 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"
      }
    }
  }
}