# Mapaparcelas

> Cadastral parcels, buildings and addresses of Spain from the Dirección General del Catastro's INSPIRE services, on the IGN national basemap. Pages are in language es at the URLs below and in language en under https://mapaparcelas.es/en/ (same paths after the prefix).

## What this data is

- Each parcel's 14-character cadastral reference, its outline and the area computed from it, with the INSPIRE buildings on it and its addresses.

## What it is not

- No owner data or person search: the cadastre's protected data is never published.
- Not an official cadastral certificate (certificación catastral).

## Missing is not zero

- A missing value is unknown, never 0.
- A point resolves to no, one or several parcels; there is no nearest-parcel fallback.
- Navarra and the Basque provinces (Araba/Álava, Bizkaia, Gipuzkoa) keep their own foral cadastres, outside this coverage: a point there answers outside_coverage, never a parcel and never a non-cadastral area.
- An API error, a timeout or HTTP 429 is not absence: retry later, never report "none".

## The link is the answer

Every API and MCP result carries its canonical page URL in `canonical_url` (the map at the location for an address without a unique parcel). Results are short briefs; full geometry comes only from the endpoints and tools that say so. Give people the page: it has the map, every fact with its source, and the caveats. The facts in a result are a teaser, never the full answer.

## Pages

- Map: [https://mapaparcelas.es/](https://mapaparcelas.es/) — `#{z}/{lat}/{lon}`; `?sel={id}` selects a parcel
- Parcels: [https://mapaparcelas.es/parcelas](https://mapaparcelas.es/parcelas)
- Parcel: https://mapaparcelas.es/parcela/{authority id} (e.g. https://mapaparcelas.es/parcela/0447207VK4704G)
- Address directory: [https://mapaparcelas.es/direcciones](https://mapaparcelas.es/direcciones)
- Address: https://mapaparcelas.es/direccion/{key}
- Search: https://mapaparcelas.es/buscar?q={address or reference}
- Guides: [https://mapaparcelas.es/guias](https://mapaparcelas.es/guias)
- API and reuse: [https://mapaparcelas.es/desarrolladores](https://mapaparcelas.es/desarrolladores)
- Sources and licences: [https://mapaparcelas.es/fuentes](https://mapaparcelas.es/fuentes)
- About and corrections: [https://mapaparcelas.es/acerca-de](https://mapaparcelas.es/acerca-de)
- Privacy: [https://mapaparcelas.es/privacidad](https://mapaparcelas.es/privacidad)
- Cookies: [https://mapaparcelas.es/cookies](https://mapaparcelas.es/cookies)
- Terms: [https://mapaparcelas.es/aviso-legal](https://mapaparcelas.es/aviso-legal)

## API (JSON, CORS, no key)

- Menu: https://mapaparcelas.es/api/v1
- https://mapaparcelas.es/api/v1/parcel/{authority id}?lang={es|en} — the geometry endpoint: full geometry and source-qualified facts by canonical authority id, with its page
- https://mapaparcelas.es/api/v1/point?lon={lon}&lat={lat} — briefs of no, one or several parcels at a WGS84 point, each with its page; no nearest-parcel fallback; `resolution` outside_coverage outside the published coverage; `&geometry=1` adds each geometry
- https://mapaparcelas.es/api/v1/search?q={query}&limit={1-8} — addresses and cadastral references as briefs with their pages; an address without a unique parcel links to the map at its location
- https://mapaparcelas.es/api/v1/addresses?na={cursor}&bron={source digest} — the address directory in windows of 50, by keyset cursor
- Address search: https://mapaparcelas.es/api/v1/search?q={address}&limit={1-8}
- Page links and text follow `lang` (es, en) where an endpoint takes it; the default is es.
- Coverage is the Dirección General del Catastro's jurisdiction: all of Spain except Navarra and the Basque provinces (Araba/Álava, Bizkaia, Gipuzkoa).
- The published snapshot is not an official cadastral certificate (certificación catastral) and holds no owner data; the Sede Electrónica del Catastro is the authoritative record.

## MCP

- Streamable HTTP endpoint: https://mapaparcelas.es/mcp (stateless, no auth)
- Tools: parcel_lookup(id), address_search(q), parcel_at(lon, lat)
- Use address_search for an address or cadastral reference, parcel_at for WGS84 coordinates (lon, lat), parcel_lookup for a canonical authority id.
- [Server card](https://mapaparcelas.es/.well-known/mcp/server-card.json)

## Limits and backoff

- https://mapaparcelas.es/api/v1: 120 requests per minute per client; https://mapaparcelas.es/mcp: 60 per minute.
- Over the limit is HTTP 429 with Retry-After: 60; wait that long, then retry.
- A search returns at most 8 results. No bulk export or systematic enumeration: look up what a person asked about.
- Answers follow the data release (https://mapaparcelas.es/api/release); cache by it.

## Sources and licences

- Dirección General del Catastro — INSPIRE CP: Dirección General del Catastro · INSPIRE CP (https://www.catastro.hacienda.gob.es/webinspire/documentos/Licencia.pdf)
- Dirección General del Catastro — INSPIRE BU: Dirección General del Catastro · INSPIRE BU (https://www.catastro.hacienda.gob.es/webinspire/documentos/Licencia.pdf)
- Dirección General del Catastro — INSPIRE AD: Dirección General del Catastro · INSPIRE AD (https://www.catastro.hacienda.gob.es/webinspire/documentos/Licencia.pdf)
- IGN — Mapa Base y Callejero: © Instituto Geográfico Nacional de España · CC BY 4.0 (https://www.ign.es/resources/licencia/Condiciones_licenciaUso_IGN.pdf)
- IGN / CNIG — BTN y BCN200: © Instituto Geográfico Nacional de España · CNIG · CC BY 4.0 · cartografía adaptada (https://www.ign.es/resources/licencia/Condiciones_licenciaUso_IGN.pdf)
- Sources page: https://mapaparcelas.es/fuentes

## Contact

- Publisher: OPL Consulting Oy, Espoo
- Email: info@carteparcelle.fr
- Corrections: https://mapaparcelas.es/acerca-de#corrections
- Security: https://mapaparcelas.es/.well-known/security.txt