Búsqueda indicando la dirección completa
URL de conexión: https://eines.icgc.cat/geocodificador/cerca (GET)
Descripción
La operación cerca (Geocodificación directa o búsqueda completa) devuelve los datos y la ubicación de una dirección o topónimo, indicados de forma completa.
Es imprescindible indicar el texto a buscar en el parámetro text.
El resultado se obtiene en formato GeoJSON.
Por ejemplo, para buscar las coordenadas correspondientes a la dirección carrer nou 10,girona, podemos hacer la petición https://eines.icgc.cat/geocodificador/cerca?text=carrer nou 10,girona&layers=address&size=1, que tiene la respuesta:
Construcción de la consulta
La petición al API se construye a partir de la URL https://eines.icgc.cat/geocodificador/cerca, seguida del signo ? y de la secuencia de parámetros, separados por el signo &.
Los parámetros son los siguientes:
-
text: contiene el texto a buscar. Es un parámetro obligatorio.
Es importante tener en cuenta que, en el caso de búsqueda de direcciones postales, hay que separar el nombre del municipio o del llogaret con una coma, de la manera siguiente:
-
nombre_de_calle portal, municipio/llogaret
-
nombre_edificación_aislada, municipio/llogaret
-
nombre_topónimo, municipio
Ejemplos:
-
-
layers: se utiliza para filtrar los tipos de elemento a buscar
Se pueden diferenciar los tipos de datos a buscar indicando el parámetro layers, con los valores siguientes:
. address: direcciones postales
. tops: todos los topónimos
. topo_tipo_id: topónimos del tipo id, donde id es una cadena con números entre 1 y 22, con el 0 a la izquierda por los menores de 10. Por ejemplo: topo_tipo_01* para buscar Capitales de municipio. La tabla con los tipos de topónimo y sus identificadores se puede consultar en Tabla topónimos
Se pueden indicar los valores siguientes para segregar los topónimos en dos grupos:
. topo1: topónimos referentes a agrupaciones de población (municipios, capitales de municipio, entidades de población, diseminados y barrios)
. topo2: resto de topónimos.
Ejemplo, para encontrar topónimos con el nombre Riera de Gaià: https://eines.icgc.cat/geocodificador/cerca?text=riera%20de%20gaia&layers=topo1,topo2
-
size: se utiliza para definir el número máximo de resultados
Por defecto, se devuelven hasta 10 resultados de cada uno de los tipos indicados en layers. Se puede indicar un número diferente con el parámetro size. El valor máximo es 40.
Por ejemplo, para encontrar un único topónimo: https://eines.icgc.cat/geocodificador/cerca?text=riera%20de%20gaia&layers=topo1&size=1
-
boundary.rect.min_lon, boundary.rect.min_lat, boundary.rect.max_lon y boundary.rect.max_lat: para buscar en un área rectangular
Se puede limitar espacialmente la búsqueda indicando las coordenadas latitud y longitud de un rectángulo con estos parámetros.
-
boundary.circle.lon, boundary.circle.lat, boundary.circle.radius: para buscar en un área circular
Se puede limitar espacialmente la búsqueda indicando las coordenadas de un círculo con los parámetros boundary.circle.lon y boundary.circle.lat (coordenada central de referencia) y el parámetro boundary.circle.radius (radio en km).
-
focus.point.lat, focus.point.lon: priorización de resultados por proximidad
Para priorizar los resultados más próximos a unas coordenadas podemos indicarlas con estos parámetros.
-
com: para filtrar por comarca
El parámetro com permite especificar el nombre de la comarca o su identificador.
Se puede consultar el listado de comarcas en Tabla de comarcas
Ejemplos:
https://eines.icgc.cat/geocodificador/cerca?text=biblioteca&com=girones (indicando el nombre de comarca)
https://eines.icgc.cat/geocodificador/cerca?text=biblioteca&com=20 (indicando identificador de comarca)
-
mun: para filtrar por municipio
El parámetro mun permite especificar el nombre del municipio o su identificador.
Se puede consultar el listado de municipios en Tabla de municipios
Ejemplos:
https://eines.icgc.cat/geocodificador/cerca?text=biblioteca&mun=girona (indicando el nombre de municipio)
https://eines.icgc.cat/geocodificador/cerca?text=biblioteca&mun=170792 (indicando identificador de municipio)
Parámetros de entrada
Parámetro | Tipo | Obligatorio | Descripción | Valor por defecto | Ejemplo |
---|---|---|---|---|---|
text | cadena de texto | Si | Texto a buscar | Riera de Sallent | |
focus.point.lat | número de punto flotante | No | Latitud del punto por el que se quieren priorizar los resultados | 41.430371882652814 | |
focus.point.lon | número de punto flotante | No | Longitud del punto por el que se quieren priorizar los resultados | 1.8566894531250002 | |
layers | cadena de texto | No | Tipo de elementos a buscar: [address, tops, topo_tipo_id, topo1, topo2] | topo1,topo2,address | address,topo1 |
size | entero | No | Número de resultados. El máximo es 40 | 10 | 5 |
com | cadena de texto | No | Identificador de una comarca, dentro de la que se quiere restringir la búsqueda | 01 | |
mun | cadena de texto | No | Identificador de un municipio, dentro de la que se quiere restringir la búsqueda | 080018 | |
boundary.circle.lat | número de punto flotante | No | Latitud del punto del círculo de búsqueda | 41.430371882652814 | |
boundary.circle.lon | número de punto flotante | No | Longitud del punto del círculo de búsqueda | 2.81233 | |
boundary.circle.radius | número de punto flotante | No | radio del círculo de búsqueda (km) | 10 | |
boundary.rect.min_lat | número de punto flotante | No | Latitud del extremo inferior del rectángulo de búsqueda | 41.909303728668824 | |
boundary.rect.min_lon | número de punto flotante | No | Longitud del extremo inferior del rectángulo de búsqueda | 2.694053649902344 | |
boundary.rect.max_lat | número de punto flotante | No | Latitud del extremo superior del rectángulo de búsqueda | 42.01142264969458 | |
boundary.rect.max_lon | número de punto flotante | No | Longitud del extremo superior del rectángulo de búsqueda | 2.911033630371094 |
Parámetros de salida
Se devuelven los resultados en formato GeoJSON.
El elemento features.properties tiene los campos descritos en la tabla siguiente:
Campo | Descripción | Aplicacble a los elementos |
---|---|---|
layer | Tipo de elemento encontrado.Los valores posibles son los indicados en el parámetro layers de entrada | Todos |
etiqueta | Agregación de campos. Para direcciones: calle portal, municipio (llogaret). Nota: Si el llogaret coincide con el municipio, no se indica. Par topónimos: topónimo, municipio | Todos |
municipo | Municipio. En algunos topónimos, no hay un municipio asignado y toma el valor "-" | Todos |
id_municipi | Identificador del municipio. En algunos topónimos, no hay un municipio assignado y toma el valor "" | Todos |
comarca | Comarca. En algunos topónimos, no hay una comarca asignada y toma el valor "-" | Direcciones |
id_comarca | Identificador de la comarca. En algunos topónimos, no hay una comarca assignada y toma el valor "" | Todos |
llogaret | llogaret | Direcciones |
portal | Portal de la dirección | Direcciones |
nom | Nombre de la calle, de la edificación aislada o del topónimo | Todos |
tipus_via | Tipo de calle | Direcciones |
codi_postal | Código postal | Direcciones |
distancia | Distancia en kilómetros al punto indicado con los campos focus.point.lat, focus.point.lon | Todos |
addendum.origen | Escala origen | Topónimos |
addendum.zoom | Nivel de zoom óptimo | Topónimos |
addendum.tipus | Tipo de topónimo | Topónimos |
addendum.id_tipus | Identificador tipo de topónimo | Topónimos |
addendum.municipis_extra | Resto de municipios asignados | Topónimos |
addendum.bbox | Coordenadas geográficas del rectángulo contenedor de la calle | Direcciones |
addendum.bbox_utm | Coordenadas UTM del rectángulo contenedor de la calle | Direcciones |
Ejemplos de salida según tipo de layer
Dirección postal |
---|
https://eines.icgc.cat/geocodificador/cerca?text=nou%2010%20girona&layers=address&size=1 |
Topónimo |
---|
https://eines.icgc.cat/geocodificador/cerca?text=el%20tibidabo%20,Barcelona&layers=tops&size=1 |