API de geocodificação direta
Envie um endereço, o nome de um lugar, um código postal ou uma descrição aproximada como "cafeteria perto de Kings Cross" e receba coordenadas, um endereço padronizado, suas partes, uma caixa delimitadora e um nível de precisão que indica o quanto você pode confiar no ponto.
Exemplo
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/forward?q=221B+Baker+Street,+London&limit=1"Texto livre funciona. Uma consulta estruturada também, se você já tiver as partes: street=221B Baker Street&city=London&country=gb. Restrinja os resultados a um ou mais países com country=gb,ie, dê preferência a resultados perto de um ponto com proximity=lat,lon ou dentro de uma caixa com bounds.
{
"status": "ok",
"query": "221B Baker Street, London",
"results": [
{
"formatted": "221B Baker Street, London NW1 6XE, United Kingdom",
"lat": 51.523767,
"lon": -0.158555,
"type": "address",
"precision": "house",
"confidence": 0.97,
"components": {
"house_number": "221B",
"road": "Baker Street",
"neighbourhood": "Marylebone",
"city": "London",
"state": "England",
"postcode": "NW1 6XE",
"country": "United Kingdom",
"country_code": "gb"
},
"bounds": { "north": 51.523917, "south": 51.523617, "east": -0.158305, "west": -0.158805 }
}
]
}O que você recebe
| Campo | Significado |
|---|---|
formatted | O endereço completo, escrito da forma como aquele país escreve endereços. |
lat, lon | Graus decimais, WGS 84. Até seis casas decimais. |
type | O que foi encontrado: address, street, postcode, city, region, country ou poi. |
precision | house, street, postcode ou admin. Veja a cobertura. |
confidence | De 0 a 1. O quanto temos certeza de que este é o lugar que você quis dizer, considerando a consulta. Independe da precisão: uma consulta por cidade pode ser encontrada com confiança 1 na precisão admin. |
components | O endereço dividido em partes, com os mesmos nomes de chave em todos os países. Só aparecem as partes que existem. |
bounds | Uma caixa delimitadora do elemento encontrado: o edifício, a rua, a área do código postal ou a cidade. |
Onde é usada
Limpeza de endereços de clientes
Geocodifique no cadastro e guarde formatted e components junto com o que o cliente digitou. Rejeite qualquer resultado abaixo de precision: street e peça que ele confira.
Colocar registros em um mapa
Processe em lote um CSV de endereços de lojas ou imóveis a 50 por segundo e plote-os no mapa. O campo bounds fornece um zoom adequado para cada um.
Busca por lugar
Transforme "apartamentos em Hackney" em uma caixa delimitadora e consulte seu próprio banco de dados com ela. type informa se o usuário digitou uma cidade, uma rua ou um edifício.
Precisão
Resultados em nível de número de casa dependem da existência de dados de endereço para o país, e esses dados não existem em todo lugar. A página de cobertura lista o melhor nível que alcançamos em cada um dos 249 países e territórios. Quando não conseguimos encontrar um número de casa, recorremos à rua, depois ao código postal, depois à localidade, e o campo precision informa qual foi usado. Nunca retornamos o centroide de um país rotulado como endereço.
Preço e limites
Uma chamada é uma requisição, não importa quantos resultados ela retorne (até 10 com limit). Toda chave tem 2.500 requisições gratuitas por dia; acima disso, € 0,0001 cada uma a partir do crédito pré-pago, ou nada em uma chave Unlimited (€ 50 por mês). Detalhes de preços.
Vai migrar de outro provedor? Os hosts compatíveis (drop-in) do Google, Bing, HERE, Mapbox e outros respondem a requisições de geocodificação direta nos formatos desses provedores.