Cerca inversa
URL: https://eines.icgc.cat/geocodificador/invers (GET)
Descripció
L'operació invers (geocodificació inversa) cerca les adreces i topònims més propers a un punt geogràfic determinat, especificat per la seva latitud i longitud.
El resultat s'obté en format GeoJSON.
Exemple
| Exemple petició | Exemple resposta |
|---|---|
| https://eines.icgc.cat/geocodificador/invers?lat=41.385965&lon=2.16687&size=1&layers=address | Imatge
|
Construcció de la consulta i paràmetres d'entrada
La petició a l'API es construeix a partir de la URL https://eines.icgc.cat/geocodificador/invers, seguit del signe ? i de la seqüència de paràmetres, separats pel signe &.
Els paràmetres són els següents:
lon, lat: Els paràmetres lon i lat són obligatoris i contenen les coordenades del punt geogràfic al voltant del qual es vol fer la cerca.
Exemple: http://eines.icgc.cat/geocodificador/invers?lon=0.20949814&lat=41.12599206.
layers: s'utilitza per filtrar els tipus d'element a cercar
Es poden diferenciar els tipus de dades a cercar indicant el paràmetre layers, amb els valors següents:
- address: adreces postals.
- tops: tots els topònims.
topo_tipus_id: topònims del tipus id, on id és una cadena amb nombres entre 1 i 22, amb el 0 a l'esquerra pels menors de 10. Per exemple: topo_tipus_01 per cercar 'Caps de municipi'. La taula amb els tipus de topònim i els seus identificadors es pot consultar a Taula topònims.
Es poden indicar els valors següents per segregar els topònims en dos grups:
- topo1: topònims referents a agrupacions de població (municipis, caps de municipi, entitats de població, disseminats i barris).
topo2: resta de topònims.
Exemple, per trobar topònims: http://eines.icgc.cat/geocodificador/invers?lon=0.20949814&lat=41.12599206&layers=tops.
size: s'utilitza per a definir el nombre màxim de resultats
Per defecte, es retornen fins a 10 resultats de cada un dels tipus indicats a layers. Es pot indicar un nombre diferent amb el paràmetre size. El valor màxim és 40.
Per exemple, per a trobar un únic topònim: http://eines.icgc.cat/geocodificador/invers?lon=0.20949814&lat=41.12599206&layers=tops&size=1.
boundary.circle.radius: per cercar en una àrea circular
Es pot indicar el radi del cercle de cerca amb el paràmetre boundary.circle.radius (radi en km).
com: per filtrar per comarca
El paràmetre com permet especificar el nom de la comarca o el seu identificador. Es pot consultar el llistat de comarques a https://www.idescat.cat/codis/?id=50&n=10.
Exemples:
https://eines.icgc.cat/geocodificador/invers?lon=2.094256&lat=41.432308&layers=tops&size=10&com=barcelones (indicant el nom de comarca).
https://eines.icgc.cat/geocodificador/invers?lon=2.094256&lat=41.432308&layers=tops&size=10&com=13 (indicant identificador de comarca).
mun: per filtrar per municipi
El paràmetre mun permet especificar el nom del municipi o el seu identificador. Es pot consultar el llistat de municipis a https://www.idescat.cat/codis/?id=50&n=9.
Exemples:
https://eines.icgc.cat/geocodificador/invers?lon=2.094256&lat=41.432308&layers=tops&size=10&mun=barcelona (indicant el nom de municipi).
https://eines.icgc.cat/geocodificador/invers?lon=2.094256&lat=41.432308&layers=tops&size=10&mun=080193 (indicant identificador de municipi).
Taula dels paràmetres d'entrada
| Paràmetre | Tipus | Obligatori | Descripció | Valor per defecte | Exemple |
|---|---|---|---|---|---|
| lat | número de punt flotant | Si | latitud | Cap | 41.385965 |
| lon | número de punt flotant | Si | longitud | Cap | 2.16687 |
| layers | cadena de text | No | El paràmetre layers permet definir els tipus d’elements a cercar i pot prendre els valors següents separats per comes:
Els resultats es mostren ordenats segons l'ordre dels elements indicats al paràmetre layers. | ||
| boundary.circle.radius | número de punt flotant | No | Radi del cercle de cerca (en km) | 1 | 0.5 |
| size | enter | No | Nombre de resultats (per defecte: 10) | 10 | 5 |
| com | cadena de text | No | Identificador d'una comarca, dins la que vol restringir la cerca Pot ser el nom total o parcial de la comarca (sempre que l'identifiqui unívocament) o el seu identificador Es pot consultar el llistat de comarques a https://www.idescat.cat/codis/?id=50&n=10 | Cap | 01 |
| mun | cadena de text | No | Identificador d'un municipi, dins el que vol restringir la cerca Pot ser el nom total o parcial del municipi (sempre que l'identifiqui unívocament) o el seu identificador Es pot consultar el llistat de municipis a https://www.idescat.cat/codis/?id=50&n=9 | Cap | 080018 |
Taula dels paràmetres de sortida
Es retornen els resultats en format GeoJSON.
L'element features.properties té els camps descrits a la taula següent:
| Capa | Descripció | Aplicable als elements |
|---|---|---|
| layer | Tipus d'element trobat. Els valors possibles són els indicats al paràmetre layers d'entrada | Tots |
| distancia | Distància en quilòmetres de l'element trobat al punt indicat | Tots |
| etiqueta | Agregació de camps:
| Tots |
| portal | Portal de l'adreça | Adreces |
| nom | Nom de carrer o edificació aIllada Nom del topònim | Tots |
| codi_postal | Codi postal | Adreces |
| toponim | Nom del topònim | Topònims |
| municipi | Municipi assignat a l'adreça o al topònim 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 |
| llogaret | Nom del llogaret associat a l'adreça | Adreces |
| addendum.origen | Escala origen | Topònims |
| addendum.zoom | Nivell de zoom òptim | Topònims |
| addendum.tipus | Tipus de topònim (veure Tipus de topònims) | Topònims |
| addendum.id_tipus | Identificador tipus de topònim | Topònims |
| addendum.municipis_extra | Altres municipis assignats al topònim | 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:
