O que lançamos este mês: geocodificação, IP, fuso horário e mais
Um resumo do trabalho recente em toda a API: novos hosts de compatibilidade, consultas de fuso horário e altitude mais rápidas, recursos no painel e mais visibilidade sobre a cota.
Compatibilidade drop-in com o Google Maps Platform já está no ar
A Google Maps Platform é um dos serviços de geocodificação mais integrados que existem, o que também faz dela um dos mais difíceis de abandonar. Reescrever os montadores de requisição e os interpretadores de resposta em todo um código só para experimentar outro provedor raramente compensa o tempo de engenharia que custa. Por isso construímos um host que não pede que você reescreva nada.
Nosso host compatível com a Google Maps Platform reproduz exatamente os parâmetros de requisição e a estrutura de resposta do serviço original, exceto os textos de direitos autorais, termos e privacidade, que são nossos. O que quer que sua integração envie hoje aos endpoints de geocodificação do Google, ela pode enviar aos nossos. Trocar de provedor passa a ser uma questão de mudar um nome de host e uma chave, e não um projeto de desenvolvimento.
Isso fica ao lado dos nossos próprios endpoints nativos. Se você está começando do zero, /v1/forward, /v1/reverse, /v1/autocomplete e /v1/postcode estão documentados em /docs/ e oferecem diretamente o nosso formato de requisição. Se você já tem código escrito no formato do Google, o host compatível em /compatibility/google-maps/ permite mantê-lo como está.
A autenticação funciona da mesma forma flexível que em todo o My Geocode: envie sua chave como cabeçalho X-API-Key, como cabeçalho Authorization: Bearer, via HTTP Basic auth com a chave como nome de usuário ou como parâmetro de consulta. Seja qual for o padrão que sua biblioteca cliente atual já usa para a API do Google, uma dessas quatro formas vai corresponder a ele, então o código de autenticação da sua integração raramente precisa mudar também.
Os preços no host compatível são os mesmos de qualquer outro lugar do My Geocode. Cada chave recebe 2.500 requisições gratuitas por dia, além das 2.500 por dia disponíveis a partir de qualquer endereço sem chave nenhuma, contadas por rede. Passado isso, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre tudo por € 50 por mês. Não há um valor separado e mais alto por usar um host compatível em vez de um endpoint nativo. Todos os endpoints e todos os hosts compatíveis custam o mesmo.
Toda resposta também traz os mesmos cabeçalhos de cota do restante da API, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Credits-Remaining e os demais, dando a você uma visibilidade do uso que uma simples troca de provedor não ofereceria de graça.
Se sua integração precisa de mais do que a resposta padrão, adicionar mg_extras=1 a uma requisição, ou o cabeçalho X-MG-Extras, acrescenta campos extras opcionais, como a altitude do terreno, por cima do formato compatível. Isso é puramente aditivo: deixe desligado e a resposta corresponde com precisão ao formato do provedor original.
Experimentar leva minutos, não um sprint. Aponte uma chamada de teste para /compatibility/google-maps/ com uma chave nova e compare a resposta com o que você já recebe hoje.