13 ago 2024

Actualización del servicio REST «Geocoder» del proyecto CartoCiudad


Cada vez es más necesario añadir diferentes funcionalidades en los servicios de geolocalización, para que cumplan con las necesidades de las personas o clientes que lo usan, y que se haga un uso óptimo y preciso de la geolocalización, ajustando mejor las búsquedas y obteniendo resultados más satisfactorios.

Por todo ello, se ha publicado una nueva versión del servicio REST Geocodificador o «Geocoder», servicio que permite geolocalizar tanto direcciones urbanas como interurbanas, códigos postales, entidades de población, unidades administrativas, puntos de interés y referencias catastrales (Servicio SOAP de la Dirección General de Catastro).

Las mejoras realizadas son para el método «candidates» de la geolocalización por identificador geográfico:
  • Nuevos filtros a las búsquedas: Se pueden hacer búsquedas de elementos que estén en uno o varios códigos postales, unidades administrativas y entidades de población en concreto. Los elementos se introducen en el filtro uno seguido de otro con comas y sin espacios
    • cod_postal_filter (opcional): permite realizar una búsqueda en uno o varios códigos postales. 
      • Ejemplo: 'cod_postal_filter=28003,28022'
    • municipio_filter (opcional): permite realizar una búsqueda en uno o verios municipios. 
      • Ejemplo: 'municipio_filter=Madrid,Avilés'
    • provincia_filter (opcional): permite realizar una búsqueda en una/unas provincias.
      • Ejemplo: 'provincia_filter=Lugo,Burgos'
    • comunidad_autonoma_filter (opcional): permite realizar una búsqueda en una/unas comunidades autónomas.
      • Ejemplo: 'comunidad_autonoma_filter=Principado de Asturias,Andalucía'
    • poblacion_filter (opcional): permite realizar una búsqueda en una/unas poblaciones. 
      • Ejemplo: 'poblacion_filter=Madrid'
También se puede hacer la combinación de todas o algunas de ellas.

**Nota: para que estos filtros funcionen correctamente hay que escribir los nombres de las unidades administrativas y poblaciones de la forma oficial; es decir, como se tiene en CartoCiudad. En caso de duda se puede, por ejemplo, hacer primero una consulta al candidates del nombre del municipio y a continuación hacer la petición con el filtro de municipios.

Ejemplo: Colegio Miguel Hernández en el código postal 28100 y 02316.


Se obtienen dos elementos, uno por cada código postal elemento:



Si se hace sin filtro se obtiene un total de 4 elementos:
  • Coordenadas geográficas en elementos puntuales: portales, puntos kilométricos, y puntos de interés. Cuando se emplee el método «candidates», se obtendrán directamente las coordenadas de los elementos por lo que no hará falta aplicar posteriormente el método «find» para obtener sus coordenadas. Ejemplo:


Hay que mencionar que este servicio se puede implementar en visualizadores cartográficos, y que estos se pueden personalizar haciendo uso de los nuevos filtros y del parámetro «no_process», creando, por ejemplo, visualizadores de un solo municipio o de varios códigos postales. Un ejemplo de este uso, son los visualizadores del IGN y CNIG que no están basados en la API-CNIG.

Los otros visualizadores del IGN y CNIG que si están basados en la API-CNIG, a partir de la extensión Locator se incorpora el servicio REST «Geocoder». Esta extensión ya tiene incorporado la parametrización del «no_process», y en un futuro va a tener el resto de los filtros, para poder hacer visualizadores con la API-CNIG por búsquedas de áreas geográficas.

Para más información sobre el servicio y del resto de funcionalidades, acceda aquí.

Publicado por Itziar Doñate Vadillo.

No hay comentarios: