Cadastre GPSCadastre GPS

Documentation API

Reference complete de l'API cadastrale

Base URL

https://api.parcelgps.com

Authentification

Toutes les requetes API necessitent une API key envoyee dans l'en-tete X-API-Key.

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

Obtenez votre API key gratuite sur votre tableau de bord developpeur.

Codes d'erreur

StatusDescription
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

Obtenir les donnees d'une parcelle par reference cadastrale (14 ou 20 caracteres).

Parametres

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

Exemple de reponse

{
  "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

Geocodage inverse : trouver la parcelle cadastrale a des coordonnees GPS.

Parametres

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"

Exemple de reponse

{
  "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

Rechercher une parcelle cadastrale par adresse postale.

Parametres

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"

Exemple de reponse

{
  "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

Obtenir les donnees d'une parcelle portugaise par reference cadastrale.

Parametres

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

Exemple de reponse

{
  "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

Obtenir les donnees d'une parcelle francaise par reference cadastrale.

Parametres

: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"

Exemple de reponse

{
  "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

Obtenir les donnees d'une parcelle italienne par reference catastale.

Parametres

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

Exemple de reponse

{
  "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

Obtenir les donnees d'une parcelle allemande (NRW) par reference cadastrale.

Parametres

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

Exemple de reponse

{
  "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

Endpoints supplementaires (plan Pro ou superieur requis).

GET/catastro/:refcat/polygon

Obtenir le polygone GeoJSON d'une parcelle.

Parametres

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

Exemple de reponse

{
  "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

Obtenir les donnees de potentiel solaire (PVGIS) d'une parcelle europeenne.

Parametres

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

Exemple de reponse

{
  "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

Exporter les donnees de parcelle au format KML (Google Earth).

Parametres

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

Exemple de reponse

<?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

Exporter les donnees de parcelle au format GPX (navigateurs GPS).

Parametres

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

Exemple de reponse

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