Servicio de geocodificación inversa

URL del servicio

Parámetros GET y ejemplos

• tema: (Obligatorio) Lista separada por comas de los temas que se desea obtener información. Por ahora los valores permitidos son:
  • municipios
  • espacios-protegidos
  • catastro
  • callejero
  • forestal
• x y y: (Obligatorios) Coordenadas expresadas en el EPSG seleccionado. Pueden ser coordenadas proyectadas en metros (X, Y) o coordenadas geográficas decimales (Longitud en "x" y Latitud en "y").
• epsg: (Obligatorio) Código numérico EPSG del sistema de referencia de las coordenadas. La herramienta ofrece los siguientes sistemas de referencia:
  • 4326: EPSG:4326 — WGS 84 (grados))
  • 4258: EPSG:4258 — ETRS89 (grados)
  • 25830: EPSG:25830 — ETRS89 / UTM zona 30N
  • 25831: EPSG:25831 — ETRS89 / UTM zona 31N
  • 3857: EPSG:3857 — Web Mercator
• pretty: (Opcional) Con el valor 1 o true, se solicita un JSON legible. Si no hay valor, o el valor es igual a 0 o false el JSON se devuelve en una línea.

Ejemplos:

• Consulta sobre el tema de municipios:
  https://descargas.icv.gva.es/00/geoprocesos/geocodificador-inverso/?tema=municipios&x=700000&y=4300000&epsg=25830&pretty=1
• Consulta sobre varios temas (municipios y espacios protegidos):
  https://descargas.icv.gva.es/00/geoprocesos/geocodificador-inverso/?tema=municipios,espacios-protegidos&x=700000&y=4300000&epsg=25830&pretty=1

Respuesta y ejemplo JSON

La respuesta contiene el estado de la consulta (success), los parámetros recibidos (query), el número de grupos (numResults) y los resultados agrupados por tema (results).
Los errores habituales son: 400 para parámetros o tema no válidos, 422 para un punto fuera de la Comunitat Valenciana y 503 cuando una fuente no está disponible. El uso de un método distinto de GET devuelve 405 METHOD_NOT_ALLOWED y la cabecera Allow: GET.

El siguiente JSON muestra un caso real/ilustrativo de respuesta para el municipio de Bolulla.

{
  "success": true,
  "query": {
    "tema": [
      "municipios"
    ],
    "x": -0.1445199,
    "y": 38.6928792,
    "epsg": 4258
  },
  "numResults": 1,
  "results": [
    {
      "tema": "municipios",
      "success": true,
      "numResults": 1,
      "results": [
        {
          "municipio": {
            "codigoIne": "03045",
            "codigoCatastro": "03045",
            "nombre": "Bolulla"
          },
          "comarca": "la Marina Baixa",
          "provincia": "Alacant/Alicante",
          "lineaLimiteMasCercana": {
            "tipo": "Municipal",
            "nombre": "Bolulla#el Castell de Guadalest",
            "codigoIneEntidadA": "03045",
            "codigoIneEntidadB": "03075",
            "distanciaMetros": 166.848
          }
        }
      ]
    }
  ],
  "links": {
    "documentation": "https://icvficherosweb.icv.gva.es/00/geoprocesos/geocodificador-inverso/index.html",
    "visorGVA": "https://visor.gva.es/visor/?zoomXY=748349.060,4286566.494,25830,18&capasids=0105_Delimitaciones;ICV.Municipios&nodoDesplegado=0105_Delimitaciones;ICV.Municipios"
  }
}