Services

GET /api/report/appraisal/<report_uuid>/services

Amenities and public transport within walking distance of the property, already summarised for display, with the map layer to plot them.

Example Request

curl --location 'https://insights.immobiliare.it/api/report/appraisal/e75ad7d5-dad2-4f6c-8db8-02295bd0bd9f/services?show_geo=1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'

Request Fields

Field	Required	Default	Description	Type	Example	Notes
`report_uuid`	yes		UUID of the report, given during the creation	string	`e75ad7d5-dad2-4f6c-8db8-02295bd0bd9f`	Path parameter
`show_geo`	optional	`false`	Adds the `services_map` layer to the response	any	`?show_geo=1`	Any value enables it

JSON keys in the response:

radius: Radius the search was performed in, as a display string such as 500 m.

The categories are banks, hospitals, parks, pharmacies, schools, shops, supermarkets and transportation. Each one has the same shape:

title: Label of the category, in Italian.
description: Summary of what was found, in Italian, such as 1 entro 500 m or Primi 3 di 3 entro 500 m. It is null when the category has no result.
items: Short list of what was found. Entries are display strings, and depending on the category they are either names of places (Nuova Farmacia) or aggregated counts (10 di abbigliamento, 13 Fermate bus).

services_map

GeoJSON FeatureCollection with one Point per amenity, only returned when show_geo is set. The category of each point is encoded in the icon it carries, in markerIconOptions.iconUrl.

Already summarised, and capped

This block is presentation oriented: items holds only the first few results, as description states, while services_map carries every point found. When a category has no result, items is an empty array and description is null.

Inconsistent casing in title

Category titles are not normalised: banks returns BANCHE in capitals while the others return title case, such as Farmacie and Ospedali. Normalise the casing before display, or use your own labels.

Example Response

Note

The items lists and the map layer are truncated in the example below, the actual response returns all the results found around the property.

{
  "_metadata": {
    "message": "",
    "query": {},
    "status": 200
  },
  "data": {
    "banks": {
      "description": "1 entro 500 m",
      "items": [
        "Banca Popolare Di Vice"
      ],
      "title": "BANCHE"
    },
    "hospitals": {
      "description": null,
      "items": [],
      "title": "Ospedali"
    },
    "parks": {
      "description": null,
      "items": [],
      "title": "Parchi"
    },
    "pharmacies": {
      "description": "1 entro 500 m",
      "items": [
        "Nuova Farmacia"
      ],
      "title": "Farmacie"
    },
    "radius": "500 m",
    "schools": {
      "description": "Primi 3 di 3 entro 500 m",
      "items": [
        "ALBERTO MANZI",
        "PAPA GIOVANNI XXIII"
      ],
      "title": "Scuole"
    },
    "services_map": {
      "features": [
        {
          "coordinates": [
            11.04264,
            43.86394
          ],
          "markerIconOptions": {
            "iconSize": [
              22,
              22
            ],
            "iconUrl": "https://pdf-generator-dev.realitycs.it/static/images/icone-b2c/pallino_BANCHE_SERVIZI.png"
          },
          "properties": {},
          "type": "Point"
        }
      ],
      "type": "FeatureCollection"
    },
    "shops": {
      "description": "26 entro 500 m",
      "items": [
        "10 di abbigliamento",
        "9 di servizi"
      ],
      "title": "Negozi"
    },
    "supermarkets": {
      "description": "1 entro 500 m",
      "items": [
        "Simply"
      ],
      "title": "Supermercati"
    },
    "transportation": {
      "description": "13 entro 500 m",
      "items": [
        "13 Fermate bus"
      ],
      "title": "Trasporti"
    }
  }
}