normatia

Python client for the Normatia API: Spanish parcels with their constraints and planning, municipalities with their technical data, and regulations as data, article by article.

pip install normatia

from normatia import Normatia

client = Normatia()  # reads NORMATIA_API_KEY

parcel = client.get_parcel("6963301TG3466N", include=["constraints", "zoning"])
for layer in parcel["constraints"]["layers"]:
    if layer["affected"]:  # None is "no data", never "not affected"
        print(layer["layer"], layer["summary"])

place = client.get_place("ES-41091")
print(place["technical_data"]["climate_zone"])  # {'value': 'B4', 'source': {'citation': 'CTE DB-HE, Anejo B', ...}}

for regulation in client.iter_regulations(place="ES-41091", scope="municipal"):
    print(regulation["slug"], regulation["current_version"]["curated"])

Async, with the same methods:

from normatia import AsyncNormatia

async with AsyncNormatia() as client:
    me = await client.get_me()

Sandbox keys

A sandbox key (sk-normatia-test-..., from Mi cuenta > Claves API > Clave de prueba) works with the same client and needs no API activation: it answers with about fifty fixed parcels and the public catalog, without quota. client.get_sandbox() lists the parcels; client.is_sandbox tells which kind of key the client has.

Errors

Every error is a NormatiaError with status_code, code (branch on it), message, request_id (send it to support) and retry_after. By status: AuthenticationError (401), ForbiddenError (403), NotFoundError (404), ValidationError (422), RateLimitError (429), ServiceUnavailableError (503) and APIError (the rest).

from normatia import NotFoundError

try:
    client.get_parcel("4141412VG4444S")
except NotFoundError as e:
    print(e.code, e.request_id)  # parcel_not_found, req_...

GET requests are retried twice on 429 rate_limit_exceeded, 502, 503, 504 and network errors, waiting Retry-After when the API sends it (max_retries= to change it). ask and verify spend a credit and are never retried.

Methods

Responses are plain dicts, typed with TypedDict for editors (normatia.types).

License

MIT