Spatial queryPro

spatial_search

Ricerca cross-source di POI entro un raggio attorno a una coppia (lat, lon). Restituisce le feature più vicine da gis.points — tabella unificata di milioni di punti d'interesse italiani che copre healthcare, education, commerce, mobility, culture, environment e altro — ordinati per distanza, con filtro tema opzionale.

Use cases

Arricchisci un annuncio immobiliare con il numero e l'identità di scuole, farmacie, supermercati e fermate del trasporto pubblico nelle vicinanze.
Alimenta un agente AI che risponde a “cosa c'è qui intorno?” senza SQL manuale né database POI separato.
Costruisci uno score rapido di qualità del quartiere combinando i conteggi dei servizi essenziali a piedi.
Filtra per singolo tema (es. healthcare) per analisi di catchment domain-specific.

Arguments

Name	Type	Required	Description
lat	number	required	Latitude in WGS84 (EPSG:4326).
lon	number	required	Longitude in WGS84.
radius_m	number	required	Search radius in meters. Range 1 – 50,000. Tier-capped: 1km Free, 5km Pro, 25km Max.
theme	string	optional	Filter by theme schema (healthcare, commerce, education, mobility, culture, environment, …).
limit	integer	optional	Max results. Range 1 – 500. Default 100.

Example request

curl

bash

curl -X POST https://mcp.qubitdata.it/mcp \
  -H "Authorization: Bearer $QUBITDATA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "spatial_search",
      "arguments": {
            "lat": 45.4642,
            "lon": 9.19,
            "radius_m": 800,
            "theme": "healthcare",
            "limit": 20
      }
    }
  }'

Example response

JSON-RPC 2.0 result

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[\n  { \"name\": \"Farmacia del Duomo\", \"source\": \"healthcare.farmacie\", \"theme\": \"healthcare\", \"distance_m\": 142, \"lat\": 45.4634, \"lon\": 9.1908 },\n  { \"name\": \"Ospedale Maggiore Policlinico\", \"source\": \"healthcare.minsalute_strutture\", \"theme\": \"healthcare\", \"distance_m\": 612, \"lat\": 45.4587, \"lon\": 9.1932 }\n]"
      }
    ]
  }
}

Prompt da provare

Incollali in Claude Desktop, Cursor o un qualsiasi client MCP collegato a https://mcp.qubitdata.it/mcp.

Claude Desktop

Quali strutture sanitarie ci sono entro 1km da Piazza Duomo, Milano? Elenca nome e distanza.
Cursor

Usa spatial_search per trovare le 30 scuole più vicine entro 2km da (45.4642, 9.1900).
Client MCP custom

Mostra tutti i POI entro 500m dall'indirizzo salvato dell'utente, raggruppati per tema.

Get started

Registrati per una free key e richiama il tool dal tuo agente. Servono cap geografici più ampi o quota più alta? Vedi pricing.

Last updated: 2026-05-04