Geocodificador ICGC
La geocodificación es el proceso de convertir direcciones postales, nombres de lugar o puntos de interés a coordenadas
El Geocodificador ICGC o servicio de geocodificación del ICGC permite obtener las coordenadas de un lugar ubicado en Catalunya a partir de su dirección postal o de su nombre (topónimo). También permite la operación contraria, la geocodificació inversa, que consiste en obtener la dirección postal o el nombre del topónimo más próximo a una posición expresada en coordenadas.
URL de conexión
https://eines.icgc.cat/geocodificador
Visor (búsqueda directa, autocompletar e inversa)
El Geocodificador ICGC es una interfaz de programación de aplicaciones web API REST,integrable en otras aplicaciones, de forma que es sencillo añadir un búsquedador de direcciones y/o topónimos a un visor de mapas.
Ofrece las funcionalidades siguientes:
- Localización de direcciones postales de los tipos siguientes:
- portal (nombre de calle + portal + municipio o llogaret).
- edificaciones aisladas (nombre de la edificación aislada + municipio o llogaret).
- Localización de calles (nombre de calle + municipio o llogaret).
- Consulta del cuadro envolvente de cada calle obtenida.
- Localización de topónimos (nombre + municipio).
- Geocodificación inversa para encontrar la dirección o topónimo más próximo a un punto indicado por sus coordenadas.
- Restringir la búsqueda en un área geográfica circular o rectangular.
- Restringir la búsqueda en una comarca o un municipio.
- Restringir la búsqueda a determinados tipos de topónimos.
- Priorización de las soluciones más próximas geográficamente a un punto dado.
- Disponibilidad de dos operaciones de geocodificación directa, que es aconsejable combinar en la integración en otras aplicaciones:
- autocompletar: a medida que el usuario va tecleando el texto a buscar, enviar peticiones a autocompletar, con el fin de encontrar respuestas de forma rápida.
- cerca (cerca completa): devuelve los datos y la ubicación de una dirección o topónimo indicados de forma completa. Una vez se ha completado el texto, si las respuestas proporcionadas por autocompletar no son suficientes, se puede hacer una petición a la operación cerca al oprimir la tecla [Intro].
Se recomienda utilizar librerías cliente que incorporen estas pautas de uso, como Leaflet y el conector Nextzen (anteriormente Mapzen), como se ha hecho en el Visor ejemplo, implementado con Leaflet y explicado en Visor de mapas con consultas al Geocodificador ICGC.
Operaciones
Dispone de las operaciones siguientes:
búsqueda indicando la direccion completa: devuelve los datos y la ubicación de una dirección o topónimo, indicados de forma completa.
URL: https://eines.icgc.cat/geocodificador/cerca?, método: GET.
Ejemplo de búsqueda: https://eines.icgc.cat/geocodificador/cerca?text=cambrils&layers=topo1,topo2&size=2.
Información de los parámetros de entrada y sortida: Parámetros de la operación de búsqueda indicando la dirección completa.
autocompletar: obtiene los datos y la ubicación de una dirección o topónimo sin necesidad de completar todos los datos de identificación: a medida que se va introduciendo el texto en la caja de búsqueda, se envían peticiones a autocompletar, con el fin de encontrar respuestas de forma rápida.
URL: https://eines.icgc.cat/geocodificador/autocompletar?, método: GET.
Ejemplo de búsqueda: https://eines.icgc.cat/geocodificador/autocompletar?text=cam&layers=topo1,topo2&size=2.
Información de los parámetros de entrada y salida: Parámetros de la operación de búsqueda con autocompletar.
inversa: busca las direcciones y topónimos más próximos a un punto geográfico determinado, especificado por su latitud y longitud.
URL: https://eines.icgc.cat/geocodificador/invers?, método: GET.
Ejemplo de búsqueda: https://eines.icgc.cat/geocodificador/invers?lat=41.39836479&lon=1.8566894531250002&layers=address,topo1,topo2&size=5.
Información de los parámetros de entrada y salida: Parámetros de la operación de búsqueda inversa.
Los parámetros de entrada y salida tambien se pueden consultar en la documentación https://eines.icgc.cat/geocodificador/api-docs/.
Ejemplos
A continuación se muestran alguons ejemplos de uso del servicio de geocodificación del ICGC:
Geocodificación por búsqeda de una dirección postal:
Indicando "nou 3, Girona" en la petición, obtenemos las coordenadas geográficas de la dirección postal "Carrer Nou 3, Girona": 2.82253786,41.98266812:
| Petición |
| https://eines.icgc.cat/geocodificador/autocompletar?text=nou%203,girona&size=1&layers=address |
| Respuesta |
Imatge
 |
Geocodificación inversa:
Indicando las coordenadas 2.82253786,41.98266812, obtenemos la dirección postal "Carrer Nou 3, Girona":
| Petición |
| https://eines.icgc.cat/geocodificador/invers?lon=2.82253786,&lat=41.98266812&size=1&layers=address |
| Respuesta |
Imatge
 |
Información sobre llogarets o núcleos de población de un municipio
La información del llogaret al que pertenece una dirección se muestra entre paréntesis al final del nombre del municipio.
Por ejempo, al buscar la dirección carrer de l'esglesia 1,la vall de boi, obtenemos los 3 portales que hay en los núcleos de población de Durro, Barruera i Taüll, pertenecientes al municipio la Vall de Boí:
Tambien es posible indicar el nombre del llogaret en la petición.
Por ejemplo, indicando carrer de l'esglesia 1,durro:
Integración en un visor Leaflet:
En la imagen siguiente se muestra un visor implementado con Leaflet que contiene un buscador de direcciones y topónimos, donde a meedida que el usuario va tecleando el texto a buscar, se envían peticiones al servicio de geocodificación, hasta encontrar la dirección postal deseada y su ubicación en el mapa.
Las peticiones enviadas utilizan la operación autocompletar con el parámetro text conteniendo el texto introducido por el usuario, como se muestra a https://eines.icgc.cat/geocodificador/autocompletar?text=nou%203&layers=topo1%2Ctopo2%2Caddress&size=5
En Visor con consultas al Geocodificador ICGC se explica en detalle como acceder al visor y como se ha implementado.
Priorizar los resultados más próximos a un punto determinado.
En el visor anterior se puede activar la casilla de priorización de los resultados más próximos al centro del mapa, de manera que, si el mapa está centrado en el municipio de Girona, al teclear "Biblioteca" nos aparecen bibliotecas de Girona.
Una de las peticiones es: https://eines.icgc.cat/geocodificador/autocompletar?text=bibli&focus.point.lat=41.430371882652814&focus.point.lon=1.8539428710937502&layers=topo1%2Ctopo2%2Caddress&size=5, donde se indica el texto a buscar y el punto por el que se quieren priorizar las respuestas.
Restringir la búsqueda dentro de una área geográfica circular o rectangular.
En la imagen se muestra la aplicación Vissir, donde se ha hecho una petición al Geocodificador para obtener los topónimos que contienen el texto 'biblioteca' y con coordenadas dentro del rectángulo indicado.
En la petición se indicas las coordenadas del rectángulo y el texto a buscar: https://eines.icgc.cat/geocodificador/autocompletar?text=biblioteca&layers=topo1,topo2&size=300&boundary.rect.min_lon=2.790885602127&boundary.rect.min_lat=41.951744582496&boundary.rect.max_lon=2.847448636407&boundary.rect.max_lat=42.012358869945.
Filtrar según tipos de topónimo.
Es posible indicar los tipos de topónimo a buscar.
Por ejemplo, la petición siguiente busca 3 topónimos de tipo "Cim" con el texto 'aliga': http://eines.icgc.cat/geocodificador/autocompletar?text=aliga&layers=topo_tipus_08&size=3.
Como se ve en el ejemplo, el tipo de topónimo 'Cim' tiene el identificador topo_tipus_08.
La tabla con los tipos de topónimo y sus identificadores se puede consultar en Tabla topónimos.
Filtrar por comarca o por municipio.
Es posible restringir la búsqueda a una comarca o un municipio, indicando los parámetros com o mun.
Por ejemplo, la petición https://eines.icgc.cat/geocodificador/autocompletar?text=biblioteca&mun=girona busca bibliotecas del municipio de Girona y la petición https://eines.icgc.cat/geocodificador/autocompletar?text=biblioteca&com=girones busca bibliotecas de la comarca del Gironès.
.