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 HERE Geocoding and Search já está no ar
O HERE Geocoding and Search está por trás de boa parte dos softwares de logística, automotivos e de localização, muitas vezes como uma peça entre muitas, e não como o sistema inteiro. Quando um provedor está embutido tão a fundo, avaliar uma alternativa geralmente significa pesar o custo de engenharia contra um benefício incerto. Nosso host compatível com o HERE foi construído para tirar completamente o custo de engenharia dessa equação.
O host reproduz exatamente os parâmetros de requisição e o corpo de resposta do HERE, e as únicas diferenças são os textos de direitos autorais, termos e privacidade, que são nossos e não do provedor original. O código cliente que já monta requisições no formato do HERE e lê respostas no formato do HERE não precisa ser alterado. Ele só precisa de outro nome de host e de uma chave do My Geocode.
Essa chave funciona da mesma forma flexível em todos os hosts que operamos, inclusive neste: cabeçalho X-API-Key, cabeçalho Authorization: Bearer, HTTP Basic auth usando a chave como nome de usuário ou parâmetro de consulta. Use a forma que seu cliente atual já envia, já que as quatro são reconhecidas em todos os endpoints e em todos os hosts compatíveis, sem exceção.
Por baixo da superfície compatível, os preços são os nossos, e são os mesmos em toda a plataforma. Qualquer endereço recebe 2.500 requisições gratuitas por dia sem chave nenhuma, contadas por rede, para que o nível gratuito corresponda a algo como um único site ou escritório, e não a cada dispositivo individual que passa por ele. Uma chave adiciona suas próprias 2.500 requisições gratuitas por dia, separadas. Passadas as duas cotas, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre o uso por € 50 por mês, sem acréscimo por usar um host compatível em vez de um endpoint nativo.
Toda resposta, compatível ou não, traz nosso conjunto completo de cabeçalhos de cota: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit e X-Quota-Reset. Isso oferece um nível de transparência de uso que a API original não traz embutido, sem alterar o corpo da própria resposta.
Se um projeto precisa de mais do que o formato compatível retorna, adicionar mg_extras=1 à requisição, ou enviar um cabeçalho X-MG-Extras, acrescenta campos opcionais, como a altitude do terreno, por cima, de forma totalmente opcional. Sem isso, a resposta corresponde com precisão ao formato do HERE.
O host compatível está documentado em /compatibility/here/, e uma visão mais ampla de como a migração funciona em todos os dezessete hosts está em /docs/compatibility/. Uma única chamada de teste geralmente basta para ver se ele serve.