As APIs
Oito endpoints em https://api.mygeocode.com/v1/. Cada um recebe parâmetros de consulta em uma requisição GET e retorna JSON. Eles compartilham uma cota, um conjunto de códigos de erro e um preço.
API de geocodificação direta
GET /v1/forwardEnvie um endereço, um nome de lugar ou uma descrição aproximada e receba coordenadas, um endereço padronizado e cada uma de suas partes.
Detalhes e exemplosAPI de geocodificação reversa
GET /v1/reverseEnvie uma latitude e uma longitude e receba o endereço mais próximo, com cidade, região, código postal e país separados.
Detalhes e exemplosAPI de preenchimento automático de endereços
GET /v1/autocompleteSugira endereços enquanto alguém digita. Cada sugestão vem com coordenadas, então raramente você precisa de uma segunda chamada.
Detalhes e exemplosAPI de consulta de IPv4
GET /v1/ipv4País, região, cidade, coordenadas, fuso horário e proprietário da rede de qualquer endereço IPv4, ou de quem faz a chamada se você omiti-lo.
Detalhes e exemplosAPI de consulta de IPv6
GET /v1/ipv6Os mesmos detalhes para endereços IPv6, além do prefixo anunciado ao qual o endereço pertence.
Detalhes e exemplosAPI de consulta de fuso horário
GET /v1/timezoneNome do fuso horário IANA, deslocamento em relação ao UTC, status do horário de verão e hora local de qualquer coordenada, agora ou em um timestamp que você escolher.
Detalhes e exemplosAPI de consulta de altitude
GET /v1/elevationAltitude acima do nível do mar em metros para um ponto, ou para até 100 pontos em uma única chamada.
Detalhes e exemplosAPI de consulta de código postal
GET /v1/postcodeTransforme um código postal em nome de lugar, região e coordenadas. Funciona com CEPs, ZIP codes, postcodes e seus equivalentes na maioria dos países.
Detalhes e exemplosO que elas têm em comum
Mesmo envelope
Toda resposta tem um status no nível superior com o valor ok ou error. Os erros trazem um code legível por máquina e uma frase que você pode registrar em log. As coordenadas são sempre graus decimais em lat e lon.
As mesmas regras em todo lugar
Qualquer endereço recebe 2.500 requisições gratuitas por dia sem chave. Cada chave tem suas próprias 2.500 requisições gratuitas por dia (compartilhadas com as requisições sem chave da mesma rede) e, depois disso, crédito pré-pago ou um pacote Unlimited. Uma chave de pagamento por uso atende dois endereços IP por janela móvel de 24 horas, uma chave Unlimited, três. Veja autenticação.
Mesmo preço
Uma geocodificação reversa custa o mesmo que uma consulta de IP: nada pelas primeiras 2.500 por dia em cada chave, depois € 0,0001 cada uma do crédito pré-pago, ou € 50 por mês por uma chave Unlimited. Veja preços.
O que conta como uma requisição
Quase tudo é uma chamada, uma requisição. As exceções são as chamadas em lote, em que cada item do lote conta separadamente.
| Endpoint | Conta como |
|---|---|
| Geocodificação direta, geocodificação reversa, consulta de código postal | 1 requisição por chamada, independentemente de quantos resultados voltem |
| Preenchimento automático de endereços | 1 requisição por chamada. Aplique debounce às teclas no seu cliente; os SDKs farão isso por você |
| Consulta de IPv4 e IPv6 | 1 requisição por chamada, ou 1 por endereço em um lote |
| Consulta de fuso horário | 1 requisição por chamada |
| Consulta de altitude | 1 requisição por ponto. Uma chamada com 20 pontos conta como 20 |
| Hosts compatíveis (Google, Bing, HERE e outros) | As mesmas regras do endpoint que os atende |
| Substitutos compatíveis para JavaScript: carregamentos de mapa e tiles | 0. Só as chamadas de geocodificação, preenchimento automático e altitude contam |
Ainda não disponível
Roteamento, matrizes de distância e isócronas não fazem parte do serviço e não estão planejados para este ano. A busca de pontos de interesse por categoria está em avaliação. Se você precisa de um desses recursos para migrar, avise-nos; isso nos ajuda a decidir o que construir a seguir.