Catasto GPSCatasto GPS

Documentazione API

Riferimento completo dell'API catastale

Base URL

https://api.parcelgps.com

Autenticazione

Tutte le richieste API richiedono una API key inviata nell'intestazione X-API-Key.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/catastro/9872023VH5797S"

Ottieni la tua API key gratuita su la tua dashboard sviluppatore.

Codici di errore

StatusDescrizione
200OK
400Bad Request
401Unauthorized (invalid or missing API key)
404Not Found
429Rate Limit Exceeded
500Internal Server Error

Spain (ES)

Spanish Cadastre — Direccion General del Catastro

GET/catastro/:refcat

Ottenere i dati della particella per riferimento catastale (14 o 20 caratteri).

Parametri

:refcatstringCadastral reference (e.g. 9872023VH5797S0001WX)
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/catastro/9872023VH5797S0001WX"

Esempio di risposta

{
  "success": true,
  "data": {
    "refCatastral": "9872023VH5797S0001WX",
    "pais": "ES",
    "direccion": "CL GRAN VIA 1",
    "codigoPostal": "28013",
    "municipio": "MADRID",
    "provincia": "MADRID",
    "latitud": 40.4168,
    "longitud": -3.7038,
    "googleMapsUrl": "https://maps.google.com/?q=40.4168,-3.7038",
    "uso": "Residencial",
    "clase": "Urbana",
    "superficieConstruida": 125,
    "superficieParcela": 200,
    "anioConstruccion": 1920,
    "coefParticipacion": "12.50",
    "poligono": [[-3.704, 40.416], [-3.703, 40.416], ...],
    "availableFields": {
      "uso": true, "clase": true, "anioConstruccion": true,
      "superficieConstruida": true, "coefParticipacion": true,
      "direccion": true, "busquedaDireccion": true
    }
  },
  "searchesRemaining": 4
}
POST/search/coordinates

Geocodifica inversa: trovare la particella catastale a coordinate GPS.

Parametri

latitudenumberLatitude (WGS84)
longitudenumberLongitude (WGS84)
countrystringCountry code (default: ES)
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude": 40.4168, "longitude": -3.7038, "country": "ES"}' \
  "https://api.parcelgps.com/search/coordinates"

Esempio di risposta

{
  "success": true,
  "data": {
    "referenciaCatastral": "9872023VH5797S0001WX",
    "refCat14": "9872023VH5797S",
    "direccion": "CL GRAN VIA 1",
    "municipio": "MADRID",
    "tipoInmueble": "",
    "coordenadas": { "latitud": 40.4168, "longitud": -3.7038 },
    "googleMapsUrl": "https://maps.google.com/?q=40.4168,-3.7038"
  },
  "searchesRemaining": 3
}
POST/search/address/parse

Cercare particella catastale per indirizzo postale.

Parametri

direccionstringFree-text address (Spain only)
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direccion": "Gran Via 1, Madrid"}' \
  "https://api.parcelgps.com/search/address/parse"

Esempio di risposta

{
  "success": true,
  "data": {
    "referenciaCatastral": "9872023VH5797S0001WX",
    "direccion": "CL GRAN VIA 1",
    "municipio": "MADRID",
    "provincia": "MADRID"
  },
  "searchesRemaining": 2
}

Portugal (PT)

Portuguese Cadastre — Direcao-Geral do Territorio

GET/catastro/:refcat?country=PT

Ottenere i dati di una particella portoghese per riferimento catastale.

Parametri

:refcatstringPortuguese cadastral reference (NIP)
countrystringMust be "PT"
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/catastro/U0512N0003200?country=PT"

Esempio di risposta

{
  "success": true,
  "data": {
    "refCatastral": "U0512N0003200",
    "pais": "PT",
    "latitud": 38.7223,
    "longitud": -9.1393,
    "googleMapsUrl": "https://maps.google.com/?q=38.7223,-9.1393",
    "municipio": "LISBOA",
    "superficieParcela": 450,
    "poligono": [[-9.14, 38.72], ...]
  },
  "searchesRemaining": 4
}

France (FR)

French Cadastre — Cadastre / Geoplateforme

GET/catastro/:refcat?country=FR

Ottenere i dati di una particella francese per riferimento catastale.

Parametri

:refcatstringFrench cadastral reference (e.g. 750560000AB0001)
countrystringMust be "FR"
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/catastro/750560000AB0001?country=FR"

Esempio di risposta

{
  "success": true,
  "data": {
    "refCatastral": "750560000AB0001",
    "pais": "FR",
    "latitud": 48.8566,
    "longitud": 2.3522,
    "googleMapsUrl": "https://maps.google.com/?q=48.8566,2.3522",
    "municipio": "PARIS",
    "provincia": "Paris",
    "superficieParcela": 320,
    "poligono": [[2.35, 48.85], ...]
  },
  "searchesRemaining": 4
}

Italy (IT)

Italian Cadastre — Agenzia delle Entrate

GET/catastro/:refcat?country=IT

Ottenere i dati di una particella italiana per riferimento catastale.

Parametri

:refcatstringItalian cadastral reference
countrystringMust be "IT"
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/catastro/A0420001?country=IT"

Esempio di risposta

{
  "success": true,
  "data": {
    "refCatastral": "A0420001",
    "pais": "IT",
    "latitud": 41.9028,
    "longitud": 12.4964,
    "googleMapsUrl": "https://maps.google.com/?q=41.9028,12.4964",
    "municipio": "ROMA",
    "superficieParcela": 180,
    "poligono": [[12.49, 41.90], ...]
  },
  "searchesRemaining": 4
}

Germany (DE)

German Cadastre — ALKIS (8 Bundesländer)

GET/catastro/:refcat?country=DE

Ottenere i dati di una particella tedesca (NRW) per riferimento catastale.

Parametri

:refcatstringGerman cadastral reference (Flurstückskennzeichen)
countrystringMust be "DE"
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/catastro/05315000200001?country=DE"

Esempio di risposta

{
  "success": true,
  "data": {
    "refCatastral": "05315000200001",
    "pais": "DE",
    "latitud": 50.9375,
    "longitud": 6.9603,
    "googleMapsUrl": "https://maps.google.com/?q=50.9375,6.9603",
    "municipio": "KÖLN",
    "superficieParcela": 520,
    "poligono": [[6.96, 50.93], ...]
  },
  "searchesRemaining": 4
}

Polygon / Solar / Export

Endpoint aggiuntivi (richiedono piano Pro o superiore).

GET/catastro/:refcat/polygon

Ottenere il poligono GeoJSON di una particella.

Parametri

:refcatstringCadastral reference
countrystringCountry code (query param, default: ES)
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/catastro/9872023VH5797S/polygon"

Esempio di risposta

{
  "success": true,
  "data": {
    "refCatastral": "9872023VH5797S",
    "pais": "ES",
    "latitud": 40.4168,
    "longitud": -3.7038,
    "poligono": [[-3.704, 40.416], [-3.703, 40.416], ...]
  },
  "searchesRemaining": 4
}
GET/catastro/:refcat/solar

Ottenere i dati del potenziale solare (PVGIS) di una particella europea.

Parametri

:refcatstringCadastral reference
countrystringCountry code (query param, default: ES)
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/catastro/9872023VH5797S/solar"

Esempio di risposta

{
  "success": true,
  "data": {
    "kwh_year": 4200.0,
    "kw_instalables": 3.5,
    "ahorro_anual_eur": 680.0,
    "amortizacion_anos": 8.5,
    "co2_evitado_kg": 1890.0,
    "irradiacion_media": 1650.5,
    "nota_solar": 4,
    "disponible": true,
    "estado": "ok"
  }
}
GET/export/kml?refcat=:refcat

Esportare i dati della particella in formato KML (Google Earth).

Parametri

refcatstringCadastral reference
countrystringCountry code (default: ES)
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/export/kml?refcat=9872023VH5797S" -o parcel.kml

Esempio di risposta

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <Placemark>
      <name>9872023VH5797S</name>
      ...
    </Placemark>
  </Document>
</kml>
GET/export/gpx?refcat=:refcat

Esportare i dati della particella in formato GPX (navigatori GPS).

Parametri

refcatstringCadastral reference
countrystringCountry code (default: ES)
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parcelgps.com/export/gpx?refcat=9872023VH5797S" -o parcel.gpx

Esempio di risposta

<?xml version="1.0" encoding="UTF-8"?>
<gpx version="1.1">
  <wpt lat="40.4168" lon="-3.7038">
    <name>9872023VH5797S</name>
  </wpt>
</gpx>