Geocodificador ICGC
La geocodificació és el procés de convertir adreces postals, noms de lloc o punts d'interès a coordenades
El Geocodificador ICGC o servei de geocodificació de l’ICGC permet obtenir les coordenades d’un lloc ubicat a Catalunya a partir de la seva adreça postal o del seu nom (topònim). També permet l'operació contrària, la geocodificació inversa, que consisteix a obtenir l'adreça postal o el nom del topònim més proper a una posició expressada en coordenades.
URL de connexió
https://eines.icgc.cat/geocodificador
Visor (cerca directa, autocompletar i inversa)
El Geocodificador ICGC és una interfície de programació d'aplicacions web API REST, integrable en altres aplicacions, de manera que és senzill afegir un cercador d'adreces i/o topònims a un visor de mapes.
Ofereix les funcionalitats següents:
- Localització d'adreces postals dels tipus següents:
- portal (nom de carrer + portal + municipi o llogaret).
- edificacions aïllades (nom de l'edificació aïllada + municipi o llogaret).
- Localització de carrers (nom de carrer + municipi o llogaret).
- Consulta del quadre envolvent de cada carrer obtingut.
- Localització de topònims (nom + municipi).
- Geocodificació inversa per a trobar l'adreça o topònim més proper a un punt indicat per les seves coordenades.
- Restringir la cerca dins una àrea geogràfica circular o rectangular.
- Restringir la cerca a una comarca o un municipi.
- Restringir la cerca a determinats tipus de topònims.
- Priorització de les solucions més properes geogràficament a un punt donat.
- Disponibilitat de dues operacions de geocodificació directa, que és aconsellable combinar en la integració en altres aplicacions:
- autocompletar: a mesura que l'usuari va teclejant el text a cercar, enviar peticions a autocompletar, amb la finalitat de trobar respostes de forma ràpida.
- cerca (cerca completa): retorna les dades i la ubicació d’una adreça o topònim indicats de forma completa. Un cop s'ha completat el text, si les respostes proporcionades per autocompletar no són suficients, es pot fer una petició a l'operació cerca al prèmer la tecla [Intro].
Es recomana utilitzar llibreries client que incorporin aquestes pautes d'ús, com Leaflet i el connector Nextzen (anteriorment Mapzen), com s'ha fet al Visor exemple, implementat amb Leaflet i explicat a Visor de mapes amb consultes al Geocodificador ICGC.
Operacions
Disposa de les operacions següents:
cerca: retorna les dades i la ubicació d’una adreça o topònim indicats de forma completa (geocodificació directa).
URL: https://eines.icgc.cat/geocodificador/cerca?, mètode: GET.
Exemple de cerca: https://eines.icgc.cat/geocodificador/cerca?text=cambrils&layers=topo1,topo2&size=2.
Informació dels paràmetres d’entrada i sortida: Paràmetres de l'operació de cerca indicant l'adreça completa.
autocompletar: retorna les dades i la ubicació d’una adreça o topònim sense necessitat de completar totes les dades d’identificació, és a dir, a mesura que es va introduint el text a la caixa de cerca, s’envien peticions al mètode Autocompletar, amb la finalitat de trobar respostes de forma ràpida.
URL: https://eines.icgc.cat/geocodificador/autocompletar?, mètode: GET.
Exemple de cerca: https://eines.icgc.cat/geocodificador/autocompletar?text=cam&layers=topo1,topo2&size=2.
Informació dels paràmetres d’entrada i sortida: Paràmetres de l'operació de cerca amb autocompletar.
invers: retorna les adreces i topònims més propers a un punt geogràfic determinat (geocodificació inversa: ).
URL: https://eines.icgc.cat/geocodificador/invers?, mètode: GET.
Exemple de cerca: https://eines.icgc.cat/geocodificador/invers?lat=41.39836479&lon=1.8566894531250002&layers=address,topo1,topo2&size=5.
Informació dels paràmetres d’entrada i sortida: Paràmetres de l'operació de cerca inversa.
Els paràmetres d’entrada i sortida també es poden consultar a la documentació https://eines.icgc.cat/geocodificador/api-docs/.
Exemples
A continuació es mostren alguns exemples d'ús del servei de geocodificació de l'ICGC:
Geocodificació per cercar una adreça postal:
Indicant "nou 3, Girona" en la petició, obtenim les coordenades geogràfiques de l'adreça postal "Carrer Nou 3, Girona": 2.82253786,41.98266812:
| Petició |
| https://eines.icgc.cat/geocodificador/autocompletar?text=nou%203,girona&size=1&layers=address |
| Resposta |
Imatge
 |
Geocodificació inversa:
Indicant les coordenades 2.82253786,41.98266812, obtenim l'adreça postal "Carrer Nou 3, Girona":
| Petició |
| https://eines.icgc.cat/geocodificador/invers?lon=2.82253786,&lat=41.98266812&size=1&layers=address |
| Resposta |
Imatge
 |
Informació sobre llogarets o nuclis de població d'un municipi
La informació del llogaret al que pertany una adreça es mostra entre parèntesi al final del nom del municipi.
Per exemple, al cercar l'adreça carrer de l'esglesia 1,la vall de boi, obtenim els 3 portals que hi ha als nuclis de població de Durro, Barruera i Taüll, pertanyents al municipi la Vall de Boí:
També és possible indicar el nom del llogaret en la petició.
Per exembple, indicant carrer de l'esglesia 1,durro:
Integració en un visor Leaflet:
A la imatge següent es mostra un visor implementat amb Leaflet que conté un cercador d'adreces i topònims, on a mesura que l'usuari va teclejant el text a cercar, s'envien peticions al servei de geocodificació, fins a trobar l'adreça postal desitjada i la seva ubicació al mapa.
Les peticions enviades utilitzen l'operació autocompletar amb el paràmetre text contenint el text introduït per l'usuari, com es mostra a https://eines.icgc.cat/geocodificador/autocompletar?text=nou%203&layers=topo1%2Ctopo2%2Caddress&size=5
A Visor amb consultes al Geocodificador ICGC s'explica en detall com accedir al visor i com s'ha implementat.
Prioritzar els resultats més propers a un punt determinat.
Al visor anterior es pot activar la casella de priorització dels resultats més propers al centre del mapa, de manera que, si el mapa està centrat al municipi de Girona, en teclejar "Biblioteca" ens apareixen biblioteques de Girona.
Una de les peticions és: https://eines.icgc.cat/geocodificador/autocompletar?text=bibli&focus.point.lat=41.430371882652814&focus.point.lon=1.8539428710937502&layers=topo1%2Ctopo2%2Caddress&size=5, on s'indica el text a cercar i el punt pel que es volen prioritzar les respostes.
Restringir la cerca dins una àrea geogràfica circular o rectangular.
A la imatge es mostra l'aplicació Vissir, on s'ha fet una petició al Geocodificador per a obtenir el topònims que contenen el text 'biblioteca' i amb coordenades dins el rectangle indicat.
A la petició s'indiquen les coordenades del rectangle i el text a cercar: 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 segons tipus de topònim.
És possible indicar els tipus de topònim a cercar.
Per exemple, la petició següent cerca 3 topònims de tipus "Cim" amb el text 'aliga': http://eines.icgc.cat/geocodificador/autocompletar?text=aliga&layers=topo_tipus_08&size=3.
Com es veu a l'exemple, el tipus de topònim 'Cim' té l'identificador topo_tipus_08.
La taula amb els tipus de topònim i els seus identificadors es pot consultar a Taula topònims.
Filtrar per comarca o per municipi.
És possible restringir la cerca a una comarca o un municipi, indicant els paràmetre com o mun.
Per exemple, la petició https://eines.icgc.cat/geocodificador/autocompletar?text=biblioteca&mun=girona cerca biblioteques del municipi de Girona i la petició https://eines.icgc.cat/geocodificador/autocompletar?text=biblioteca&com=girones cerca biblioteques de la comarca del Gironès.
.