Serviços de geocoding e reverse geocoding

Geocoding é o processo de converter um endereço em coordenadas geográficas. O processo inverso, ou seja, a conversão de coordenadas geográficas num endereço, designa-se por reverse geocoding.

O CIGeoE disponibiliza ambos os serviços com a particularidade de, em vez de utilizar endereços postais, utiliza os topónimos da Carta Militar série M888 à escala 1 : 25000.

Assim, é possível pesquisar por, ou obter como resultado, uma diversificada panóplia de topónimos, que vão desde o nome de cidades ou vilas, até ao nome de deltas, rios ou vales.

É a riqueza da Carta Militar que torna estes serviços ímpares.

Estes serviços estão livres para avaliação até ao final de agosto de 2025, momento em que serão reavaliados.

A sua utilização é por recurso a uma API, onde é necessário fornecer, em cada pedido, pelo menos, o parâmetro "token". Devem-se utilizar as seguintes tokens:

• Token do serviço de geocoding: jFh1setoTh9qURZYkjJXfd8rR2sxuEsG
• Token do serviço de reverse geocoding: 4BuTBPCucb56dDbcNszfjuW1PA8SYBNx

Exemplo de um pedido do serviço de geocoding:

https://webservices.igeoe.pt/grg/geocoding?q=lamego&token=jFh1setoTh9qURZYkjJXfd8rR2sxuEsG

Resposta do pedido anterior:

{"nome":"LAMEGO","lon":-25.55487,"lat":37.756664},{"nome":"Lamego","lon":-8.299433,"lat":41.121407},{"nome":"LAMEGO","lon":-7.810937,"lat":41.097527},{"nome":"Herdade do Lamego","lon":-7.5453916,"lat":38.68637},{"nome":"Fraga do Lamego","lon":-7.6529226,"lat":41.813156}

Teste da API:

Descrição da API (elaborada com recurso ao Swagger):