Geocoder

El servicio REST Geocoder proporciona funcionalidades de búsqueda y geolocalización sobre el conjunto de datos de entidades poblacionales, viales, portales, puntos kilométricos, puntos de interés (POI), códigos postales y referencias catastrales (Servicio SOAP de la D. G. del Catastro).

Ejemplo de petición de geocodificación por identificador geográfico (Elemento geográfico -> Coordenadas)

• Para los elementos que no son puntuales (portales, puntos kilométricos, topónimos y puntos de interés) hay que realizar dos peticiones para poder obtener las coordenadas de los elementos. Para los elementos puntuales, con solicitar solo al método candidates es suficiente.

  1. Búsqueda por nombre (parámetro «q») y limitando a 3 resultados (parámetro «limit»). Se obtienen 3 valores lo más parecidos fonéticamente a la palabra buscada, la cual en este caso es «Humanes de Madrid». Para ello se emplea el método «candidates»:
     https://www.cartociudad.es/geocoder/api/geocoder/candidates?q=humanes%20de%20madrid&limit=3
  2. Una vez se selecciona el elemento del cual se quieren obtener las coordenadas, se emplea el método «find», indicando en el parámetro «q» el nombre obtenido en la petición anterior («Humanes de Madrid, Madrid»), que en este caso es el municipio:
     https://www.cartociudad.es/geocoder/api/geocoder/find?q=Humanes%20de%20Madrid,%20Madrid

• Ejemplo de búsqueda de un elemento puntual

  Búsqueda por nombre (parámetro «q») limitando el resultado a un único valor (parámetro «limit»). Se obtiene el resultado más parecido fonéticamente al término buscado, en este caso «Catedral de la Almudena». Al tratarse de una geometría puntual, la respuesta incluye directamente las coordenadas geográficas. Para ello se utiliza el método «candidates»: https://www.cartociudad.es/geocoder/api/geocoder/candidates?q=catedral%20almudena&limit=1

Ejemplo de petición de geocodificación por coordenadas geográficas (Coordenadas -> Dirección)

En este caso se incluyen las coordenadas geográficas en el sistema WGS84 (World Geodetic System 1984), que corresponde con el código EPSG:4326, y se obtiene el portal o punto kilométrico más próximo a dicho punto en un radio de 350 metros:

https://www.cartociudad.es/geocoder/api/geocoder/reverseGeocode?lon=-1.371939&lat=41.487733

Otras operaciones

• Cálculo de distancias Manhattan entre dos pares de coordenadas conocidas.

  https://www.cartociudad.es/services/api/route?orig=39.487681,-0.373106&dest=39.484336,-0.358171&locale=es&vehicle=CAR

• Cálculo de áreas de influencia a partir de un punto y un radio.

  https://www.cartociudad.es/services/api/serviceArea?lon=-0.3756809234619&lat=39.4897345861&dist=50

Permite ejecutar más de 9 geoprocesamientos entre ellos la geocodificación por coordenadas geográficas, obteniendo la dirección postal (calle y nº) a partir de una tupla de coordenadas (X, Y), la geocodificación por identificador geográfico, que permite obtenerlas coordenadas de una dirección a partir de una dirección postal (calle y nº), punto más cercano, etcétera.