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 Mapbox Geocoding já está no ar
Boa parte do código escrito para o Mapbox Geocoding fica dentro de aplicações front-end, aplicativos móveis e ferramentas internas, onde a chamada de geocodificação em si é um detalhe pequeno e fácil de passar despercebido, enterrado em um sistema maior. Trocar de provedor ali geralmente significa encontrar cada lugar onde esse detalhe está antes que qualquer outra coisa possa acontecer. Nosso host compatível existe para reduzir esse trabalho a quase nada.
Ele reproduz exatamente o formato de requisição e a estrutura de resposta do Mapbox, exceto os textos de direitos autorais, termos e privacidade, que são do próprio My Geocode. Onde quer que seu código envie hoje uma requisição no formato do Mapbox, ele pode enviar essa mesma requisição ao nosso host, e a resposta retornada será interpretada da mesma forma que seu código atual já espera.
A autenticação segue nosso padrão habitual, sem obrigar você a reescrever essa parte também. 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, conforme a forma como seu cliente se autentica hoje. As quatro funcionam em todos os hosts e em todos os endpoints que operamos.
Os preços não mudam conforme o host que atendeu a requisição. Qualquer endereço recebe 2.500 requisições gratuitas por dia sem precisar de chave, contadas por rede, e não por chamador individual. Uma chave adiciona mais 2.500 requisições gratuitas por dia próprias. Além das duas cotas, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre tudo por € 50 por mês. O host compatível custa exatamente o mesmo que nossos endpoints nativos /v1/forward e /v1/reverse.
Os cabeçalhos de cota vêm em todas as respostas, qualquer que seja o formato, oferecendo uma visibilidade que uma integração direta com o Mapbox não traz por conta própria: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit e X-Quota-Reset aparecem neste host da mesma forma que em todos os outros lugares.
Para qualquer coisa além do formato de resposta compatível, mg_extras=1 na requisição, ou um cabeçalho X-MG-Extras, acrescenta campos extras opcionais por cima, sem alterar a estrutura base. Isso fica desligado por padrão, então a resposta corresponde ao formato do Mapbox até que você peça explicitamente mais.
O host fica em /compatibility/mapbox/, e as orientações gerais sobre como migrar uma integração estão em /docs/compatibility/. Se você mantém hoje uma integração no formato do Mapbox, testar isso custa uma chave e uma URL base alterada.