Spatial queryPro

nearest_n

Restituisce gli N POI più vicini a (lat, lon), con filtro tema opzionale. Differisce da spatial_search: ritorna sempre fino a N risultati indipendentemente dalla distanza, con cap su max_radius_m. Da usare quando ti serve un numero fisso di risultati, non un raggio fisso.

Use cases

Mostra sempre i 5 ospedali più vicini, anche per utenti lontani da centri urbani.
Alimenta una UI di route-planning che ha bisogno delle K colonnine / fermate più vicine.
Evita risultati vuoti in zone rurali dove un raggio fisso non troverebbe nulla.
Genera un feature pack “più vicino di ogni tipo” chiamando una volta per tema.

Arguments

Name	Type	Required	Description
lat	number	required	Latitude in WGS84.
lon	number	required	Longitude in WGS84.
n	integer	optional	How many results. Range 1 – 100. Default 10.
theme	string	optional	Restrict to a single theme schema.
max_radius_m	number	optional	Hard radius cap (meters). Range 100 – 100,000. Default 50,000. Tier-capped.

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": "nearest_n",
      "arguments": {
            "lat": 41.9028,
            "lon": 12.4964,
            "n": 5,
            "theme": "education"
      }
    }
  }'

Example response

JSON-RPC 2.0 result

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[\n  { \"name\": \"Liceo Visconti\", \"source\": \"education.miur_scuole\", \"distance_m\": 280, \"lat\": 41.9015, \"lon\": 12.4951 },\n  { \"name\": \"Istituto San Giuseppe\", \"source\": \"education.miur_scuole\", \"distance_m\": 412, \"lat\": 41.9061, \"lon\": 12.4992 }\n]"
      }
    ]
  }
}

Prompt da provare

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

Claude Desktop

Mostra le 5 farmacie più vicine al Colosseo.
Cursor

Usa nearest_n con theme=mobility per ritornare le 10 stazioni ferroviarie più vicine alla mia coordinata.
Client MCP custom

Per ogni proprietà nel batch, recupera le 3 scuole più vicine.

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