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 permet obtenir les coordenades d’un lloc ubicat a Catalunya a partir de la seva adreça postal, del seu nom (topònim) o del punt quilomètric. També permet l'operació contrària, la geocodificació inversa, que consisteix a obtenir l'adreça postal, el nom del topònim o el punt quilomètric més proper a una posició expressada en coordenades.
URL de connexió: https://eines.icgc.cat/geocodificador
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.
Funcionalitats
- 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).
- Localització de punts quilomètrics (nom de la via + km).
- Geocodificació inversa per a trobar l'adreça, topònim i punt quilomètric més propers 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 plugin Nextzen (anteriorment Mapzen), com s'ha fet al Visor exemple, implementat amb Leaflet i explicat a Visor de mapes amb consultes al servei Geocodificació ICGC.
Operacions
Disposa de les operacions següents:
-
autocompletar (geocodificació directa sense necessitat de completar totes les dades d’identificació)
Documentació
https://eines.icgc.cat/geocodificador/api-docs/
Exemples
- 1.1 Cercar una adreça postal
- 1.2 Cercar un topònim
- 1.3 Geocodificació inversa
- 1.4 Obtenir el llogaret al que pertany una adreça
- 1.5 Cercar una adreça postal segons el llogaret
- 1.6 Integració en un visor Leaflet
- 1.7 Prioritzar els resultats més propers a un punt
- 1.8 Restringir la cerca dins una àrea geogràfica circular o rectangular
- 1.9 Filtrar segons tipus de topònim
- 1.10 Filtrar per comarca o per municipi
- 1.11 Altres exemples d'integració
- 1.12 Cercar un punt quilomètric