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 Bing Maps REST Services já está no ar
Muitas integrações de mapas foram construídas anos atrás com o Bing Maps REST Services e simplesmente continuaram rodando desde então, intocadas, porque nunca houve um motivo convincente para reescrevê-las. Achamos que agora existe um: um host compatível que aceita as mesmas requisições e retorna o mesmo formato de resposta, com uma estrutura de preço e cota transparente desde a primeira chamada.
Nosso host compatível com o Bing Maps REST Services espelha exatamente os parâmetros de requisição e o corpo de resposta do serviço original, exceto os textos de direitos autorais, termos e privacidade, que refletem o My Geocode e não o provedor original. Código existente que monta requisições no formato do Bing, interpreta respostas no formato do Bing, ou ambos, pode ser apontado para o nosso host sem nenhuma reescrita.
Para chegar lá, basta mudar duas coisas: o nome do host para onde suas requisições vão e a chave com a qual você se autentica. Essa chave pode ser enviada da forma que sua integração já espera enviar uma: 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 um parâmetro de consulta simples. As quatro formas funcionam de maneira idêntica em todos os hosts do My Geocode, inclusive neste.
Os preços por trás da camada de compatibilidade são os mesmos de qualquer outro lugar da plataforma. Todo endereço recebe 2.500 requisições gratuitas por dia sem precisar de chave nenhuma, contadas por rede, para que uma conexão compartilhada não possa ser dividida entre várias chaves para multiplicar o nível gratuito. Cada chave adiciona suas próprias 2.500 requisições gratuitas por dia além disso. Passadas essas cotas, o uso é descontado do crédito pré-pago a € 0,0001 por requisição ou de um pacote Unlimited a € 50 por mês, e esse valor vale independentemente do host ou endpoint para o qual a requisição foi enviada.
A visibilidade da cota não desaparece só porque o formato da resposta corresponde ao de outro provedor. Toda chamada continua retornando X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining e o restante do nosso conjunto padrão de cabeçalhos, para que você sempre saiba exatamente a situação de uma chave ou rede, algo que o serviço original não oferece dessa forma.
Para equipes que querem mais do que a resposta estritamente compatível, mg_extras=1 na requisição, ou um cabeçalho X-MG-Extras, adiciona campos opcionais por cima do formato padrão sem alterá-lo. Deixe essa opção totalmente desligada e a resposta fica indistinguível, em estrutura, do que a API original teria retornado.
Guias de migração que mostram como mover uma integração existente, endpoint por endpoint, estão em /docs/compatibility/, e o próprio host está documentado em /compatibility/bing-maps/. Testá-lo não custa nada além de alguns minutos livres e uma chave.