Municipios (v1)

Municipios

Los municipios, provincias y comunidades de España con el identificador de toda la API, y los datos técnicos de cada municipio que piden el Código Técnico y la norma sismorresistente: zona climática, sismicidad, nieve, viento, pluviometría, radón, rayo. Cada dato lleva la norma de donde sale. No consumen cuota (grupo de datos).

Endpoint	Qué devuelve
`GET /v1/places?q=`	Los lugares que se llaman así
`GET /v1/places/{place}`	Un lugar; si es un municipio, con su ubicación y sus datos técnicos

Identificadores

Lugar	`geo_id`	También vale
Municipio	`ES-41091` (`ES-` y el código INE)	`41091`
Provincia	`ES-41`	`41`
Comunidad	`ES-C01`
España	`ES`

Es el mismo identificador de place en /v1/regulations y en /v1/coverage.

Buscar

GET /v1/places?q=alcala&level=municipality&limit=5

Parámetro	Descripción
`q`	El nombre, sin distinguir mayúsculas ni tildes, o el código INE
`level`	`region`, `province` o `municipality`
`within`	Solo los que están dentro de ese lugar: `ES-41`, `ES-C01`
`limit`	Hasta 50 (10 por defecto)

Primero salen los que se llaman exactamente así y, entre los municipios, los más poblados. Si hay más que limit, has_more es true: afina la búsqueda con level o within.

{
  "object": "list",
  "data": [
    {
      "object": "place",
      "geo_id": "ES-41903",
      "ine": "41903",
      "name": "Cuervo de Sevilla, El",
      "display_name": "El Cuervo de Sevilla",
      "level": "municipality",
      "province": { "geo_id": "ES-41", "name": "Sevilla" },
      "region": { "geo_id": "ES-C01", "name": "Andalucía" }
    }
  ],
  "has_more": false
}

name es el nombre como lo escribe el INE, con el artículo detrás; display_name, el de enseñar. La búsqueda encuentra los dos: «el cuervo» y «cuervo».

Un municipio

GET /v1/places/ES-41091

{
  "object": "place",
  "geo_id": "ES-41091",
  "ine": "41091",
  "name": "Sevilla",
  "display_name": "Sevilla",
  "level": "municipality",
  "province": { "geo_id": "ES-41", "name": "Sevilla" },
  "region": { "geo_id": "ES-C01", "name": "Andalucía" },
  "location": { "latitude": 37.3862, "longitude": -5.9925, "altitude_m": 11, "area_km2": 142.0048, "population": 689423 },
  "technical_data": {
    "climate_zone": { "value": "B4", "source": { "citation": "CTE DB-HE, Anejo B", "regulation": "cte-db-he" } },
    "design_temperatures": { "winter_p99_c": 4.5, "summer_p1_c": 37.6, "source": null },
    "seismic": {
      "basic_acceleration_g": 0.07, "contribution_coefficient_k": 1.1, "below_0_04g": false,
      "source": { "citation": "NCSE-02, Anejo 1", "regulation": "ncse" }
    },
    "snow": { "ground_load_kn_m2": 0.2, "winter_climate_zone": 6, "source": { "citation": "CTE DB-SE-AE, Anejo E", "regulation": null } },
    "wind": { "zone": "A", "source": { "citation": "CTE DB-SE-AE, Anejo D", "regulation": null } },
    "rainfall_hs1": { "zone": "III", "source": { "citation": "CTE DB-HS 1", "regulation": "cte-db-hs" } },
    "drainage_hs5": { "zone": "B", "isohyet": 40, "intensity_mm_h": 90, "source": { "citation": "CTE DB-HS 5", "regulation": "cte-db-hs" } },
    "thermal_zone_hs3": { "zone": "Z", "source": { "citation": "CTE DB-HS 3", "regulation": "cte-db-hs" } },
    "radon": { "listed": false, "zone": null, "source": { "citation": "CTE DB-HS 6, Apéndice B", "regulation": "cte-db-hs" } },
    "lightning": { "ground_flash_density": 1.5, "source": { "citation": "CTE DB-SUA 8", "regulation": "cte-db-sua" } },
    "solar_irradiation_kwh_m2_day": { "monthly": [2.7, 3.6, 4.7, 5.9, 7.1, 7.8, 8, 7.1, 5.6, 4.1, 2.9, 2.5], "source": null },
    "mains_water_temperature_c": { "monthly": [11, 11, 13, 14, 16, 19, 21, 21, 20, 16, 13, 11], "source": null }
  },
  "regulations": { "national": 93, "regional": 25, "municipal": 10 },
  "links": { "regulations": "/v1/regulations?place=ES-41091", "coverage": "/v1/coverage?place=ES-41091" }
}

Dato	Qué es
`source.citation`	La norma y el anejo de donde sale el dato
`source.regulation`	El slug de esa norma en `/v1/regulations`, si está en el catálogo
`seismic.below_0_04g`	El municipio no figura en el Anejo 1 de la NCSE-02: ab < 0,04g, sin valor de ab ni de K, y la norma no es obligatoria (art. 1.2.3)
`radon.listed`	Si el municipio figura en el Apéndice B de la sección HS 6. `false` quiere decir que la sección no es preceptiva allí, no que falte el dato
`regulations`	Cuántas normas le aplican por ámbito, de la estatal a la municipal. La lista está en `links.regulations`

Las temperaturas de cálculo, la irradiación y la temperatura del agua de red van sin source: Normatia no cita todavía de dónde salen.

En una provincia o una comunidad, location y technical_data son null: los datos técnicos son de cada municipio.

Errores

Estado	`code`	Cuándo
404	`place_not_found`	No hay ningún lugar con ese identificador
422	`invalid_place`	El identificador no tiene ninguna de las formas de la tabla
422	`invalid_query`	`q` está vacío