Obter a lista de cidades por estado
No momento essa função está disponível apenas para o Brasil. Com a Geocode API é possível obter a lista das cidades do estado desejado. Para isso será necessário realizar uma requisição do tipo POST para o seguinte endpoint:
Onde o termo {{state}}
deverá ser substituído pela sigla (UF) do estado desejado. Exemplo: https://api.maplink.global/geocode/v1/geocode/states/SP/cities
A resposta será retornada da seguinte forma:
{ "found": 645, "results": [ { "address": { "city": "AGUAÍ", "state": { "code": "SP", "name": "SÃO PAULO" }, "country": "BRASIL", "capital": false, "area": 474.695, "ibge": { "city": "3500303", "state": "35" }, "mainLocation": { "lat": -22.0589929, "lon": -46.9822351 }, "leftZipCode": "13860001", "rightZipCode": "13869999" }, "type": "CITY", "score": 52.155304, "label": "AGUAÍ, SP, BRASIL" } ] }
As seguintes informações serão retornadas:
found
– Quantidade de cidades retornados;results
– Array de objetos com resultados encontrados:address
– Objeto com informações da cidade:city
– Nome da cidade;state
– Objeto com dados referentes ao estado:code
– Sigla (UF) do estado;name
– Nome do estado;
country
– País;capital
– Valor booleano que indica se a cidade é a capital do estado;area
– Área total da cidade, em metros quadrados;ibge
– Objeto com os códigos IBGE da cidade e do estado:city
– Código IBGE da cidade;state
– Código IBGE do estado;
mainLocation
– Objeto com as coordenadas geográficas em latitude/longitude:lat
– Latitude em graus decimais;lon
– Longitude em graus decimais;
leftZipCode
– Primeiro código postal da faixa de códigos postais da cidade;rightZipCode
– Último código postal da faixa de códigos postais da cidade;
type
– Indica qual o melhor elemento encontrado na base cartográfica para o retorno da coordenada geográfica. Nesse caso será retornado sempre como “CITY”;score
– Pontuação de referência do resultado do processo de geocodificação;label
– Endereço completo encontrado utilizado no processo de geocodificação. Nesse caso, será retornado sempre como “Cidade, Estado, País”.