SERVICIO API DE GEOCODIFICACIÓN DE DIRECCIONES
(EN EDICIÓN)
El Servicio API de geocodificación de direcciones del Sistema Cartográfico Nacional de España, tiene como objetivo principal buscar y obtener a partir de sus datos identificativos, la localización geográfica de cualquier dirección que se encuentre ubicada dentro del territorio español .
La URL PROVISIONAL del servicio es: https://geocoder-5-ign.larioja.org/v1
Además de la geolocalización de una dirección específica, este servicio permite también obtener los datos de las direcciones cercanas a un punto determinado así como aquellas que estén ubicadas dentro de una determinada área geográfica rectangular o circular.
El servicio utiliza internamente la API Pelias con objeto de ofrecer un conjunto de funciones de consulta flexibles y sofisticadas.
Los métodos (endpoints) y parámetros que se describen aquí, permiten a cualquier usuario identificar y localizar direcciones con la máxima precisión a partir de los datos completos o parciales que definen una referencia postal, de un identificador (ID) o de un nombre representativo de la misma.
Las búsquedas interrogan al conjunto de direcciones que se encuentran almacenadas en una base de datos ElasticSearch (ELS), siendo el binomio ElasticSearch-API Pelias, junto con distintos procedimientos desarrollados ad-hoc para este servicio, los elementos que conforman la plataforma tecnológica que provee la funcionalidad.
Los datos básicos de las direcciones de referencia son recopilados a partir de la información proporcionada por los diferentes productores competentes en materia de direcciones, dentro del marco de cooperación que ofrece el Sistema Cartográfico Nacional de España.
Además de direcciones, el servicio de geocodificación está también diseñado para la localización geográfica de topónimos y puntos de interés (POIs).
Funcionalidad
El servicio permite interrogar la API con el fin de:
- Obtener los datos y la ubicación precisa de una dirección.
- Localizar la dirección más próxima a un punto determinado (geocodificación inversa).
- Localizar las direcciones que se encuentran dentro de un área geográfica rectangular o circular.
pudiendo limitar el ámbito de búsqueda a los datos ofrecidos por uno o varios suministradores.
La API de direcciones Pelias
La API Pelias utilizada subyacentemente en este servicio, es una API RESTful que devuelve el resultado de las consultas realizadas en formato JSON conforme a los métodos y parámetros definidos en este documento.
Métodos
Los métodos y endpoints que se pueden utilizar son los siguientes:
- Geocodificación directa (/v1/search): Método que obtiene los datos y la ubicación de una dirección o lugar, a partir de sus datos identificativos o de referencia.
- Geocodificación inversa (/v1/reverse): Método que busca las direcciones más próximas a un punto geográfico determinado.
- Autocompletar ((/v1/autocomplete): Método que obtiene resultados en tiempo real sin necesidad de completar todos los datos de identificación.
- Geocodificación estructurada (/v1/search/structured): (beta) Método que encuentra un lugar a partir de datos estructurados en calle, número, ciudad, etc.
- Lugar (/v1/place): Método que obtiene detalles sobre un lugar devuelto por una consulta anterior.
(1) La documentación técnica de esta página web reutiliza información original de la API Pelias, disponible en el repositorio Github: https://github.com/pelias/documentation.