Salta el contingut

Cerca indicant l'adreça completa

URL de connexió: https://eines.icgc.cat/geocodificador/cerca (GET)

Descripció

L'operació cerca (Geocodificació directa o cerca completa) retorna les dades i la ubicació d’una adreça o topònim, indicats de forma completa.

És imprescindible indicar el text a cercar en el paràmetre text.

El resultat s'obté en format GeoJSON.

Per exemple, per a cercar les coordenades corresponents a l'adreça carrer nou 10,girona, cal fer la petició https://eines.icgc.cat/geocodificador/cerca?text=carrer nou 10,girona&layers=address&size=1, que té la resposta:

Construcció de la consulta

La petició a l'API es construeix a partir de la URL https://eines.icgc.cat/geocodificador/cerca, seguida del signe ? i de la seqüència de paràmetres, separats pel signe &.

Els paràmetres són els següents:

Paràmetres d'entrada

Paràmetre Tipus Obligatori Descripció Valor per defecte Exemple
text cadena de text Si Text a cercar Riera de Sallent
focus.point.lat número de punt flotant No Latitud del punt pel que es volen prioritzar els resultats 41.430371882652814
focus.point.lon número de punt flotant No Longitud del punt pel que es volen prioritzar els resultats 1.8566894531250002
layers cadena de text No Tipus d’elements a cercar: [address, tops, topo_tipus_id, topo1, topo2] topo1,topo2,address address,topo1
size enter No Nombre de resultats. El màxim és 40 10 5
com cadena de text No Identificador d'una comarca, dins la que es vol restringir la cerca 01
mun cadena de text No Identificador d'un municipi, dins la que es vol restringir la cerca 080018
boundary.circle.lat número de punt flotant No Latitud del punt del cercle de cerca 41.430371882652814
boundary.circle.lon número de punt flotant No Longitud del punt del cercle de cerca 2.81233
boundary.circle.radius número de punt flotant No radi del cercle de cerca (km) 10
boundary.rect.min_lat número de punt flotant No Latitud de l'extrem inferior del rectangle de cerca 41.909303728668824
boundary.rect.min_lon número de punt flotant No Longitud de l'extrem inferior del rectangle de cerca 2.694053649902344
boundary.rect.max_lat número de punt flotant No Latitud de l'extrem superior del rectangle de cerca 42.01142264969458
boundary.rect.max_lon número de punt flotant No Longitud de l'extrem superior del rectangle de cerca 2.911033630371094

Paràmetres de sortida

Es retornen els resultats en format GeoJSON.

L'element features.properties té els camps descrits a la taula següent:

Camp Descripció Aplicacble als elements
layer Tipus d'element trobat.Els valors possibles són els indicats al paràmetre layers d'entrada Tots
etiqueta Agregació de camps. Per adreces: carrer portal, municipi (llogaret). Nota: Si el llogaret coincideix amb el municipi, no s'indica. Per topònims: topònim, municipi Tots
municipi Municipi. En alguns topònims, no hi ha un municipi assignat i pren el valor "-" Tots
id_municipi Identificador del municipi. En alguns topònims, no hi ha un municipi assignat i pren el valor "" Tots
comarca Comarca. En alguns topònims, no hi ha una comarca assignada i pren el valor "-" Tots
id_comarca Identificador de la comarca. En alguns topònims, no hi ha una comarca assignada i pren el valor "" Tots
llogaret Llogaret Adreces
portal Portal de l'adreça Adreces
nom Nom del carrer, de l'edificació aïllada o de topònim Tots
tipus_via Tipus del carrer Adreces
codi_postal Codi postal Adreces
distancia Distància en quilòmetres al punt indicat amb els camps focus.point.lat, focus.point.lon Tots
addendum.origen Escala origen Topònims
addendum.zoom Nivell de zoom òptim Topònims
addendum.tipus Tipus de topònim Topònims
addendum.id_tipus Identificador tipus de topònim Topònims
addendum.municipis_extra Resta de municipis assignats Topònims
addendum.bbox Coordenades geogràfiques del rectangle contenidor del carrer Adreces
addendum.bbox_utm Coordenades UTM del rectangle contenidor del carrer Adreces

Exemples de sortida segons tipus de layer

Adreça postal
https://eines.icgc.cat/geocodificador/cerca?text=nou%2010%20girona&layers=address&size=1
Topònim
https://eines.icgc.cat/geocodificador/cerca?text=el%20tibidabo%20,Barcelona&layers=tops&size=1