Kataster GPSKataster GPS

API-Dokumentation

Vollständige Kataster-API-Referenz

Base URL

https://api.parcelgps.com

Authentifizierung

Alle API-Anfragen erfordern einen API-Key im X-API-Key-Header.

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

Erhalten Sie Ihren kostenlosen API-Key auf Ihrem Entwickler-Dashboard.

Fehlercodes

StatusBeschreibung
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

Flurstückdaten per Katasterreferenz abrufen (14 oder 20 Zeichen).

Parameter

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

Antwortbeispiel

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

Umgekehrte Geokodierung: Katasterflurstuck an GPS-Koordinaten finden.

Parameter

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"

Antwortbeispiel

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

Katasterflurstuck per Postadresse suchen.

Parameter

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"

Antwortbeispiel

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

Portugiesische Flurstückdaten per Katasterreferenz abrufen.

Parameter

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

Antwortbeispiel

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

Französische Flurstückdaten per Katasterreferenz abrufen.

Parameter

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

Antwortbeispiel

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

Italienische Flurstückdaten per Katasterreferenz abrufen.

Parameter

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

Antwortbeispiel

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

Deutsche (NRW) Flurstückdaten per Katasterreferenz abrufen.

Parameter

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

Antwortbeispiel

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

Zusätzliche Endpunkte (erfordern Pro-Plan oder hoher).

GET/catastro/:refcat/polygon

GeoJSON-Polygon eines Flurstucks abrufen.

Parameter

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

Antwortbeispiel

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

Solarpotenzial-Daten (PVGIS) eines europäischen Flurstucks abrufen.

Parameter

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

Antwortbeispiel

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

Flurstückdaten im KML-Format exportieren (Google Earth).

Parameter

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

Antwortbeispiel

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

Flurstückdaten im GPX-Format exportieren (GPS-Navigationsgerate).

Parameter

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

Antwortbeispiel

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