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 MapQuest Geocoding já está no ar
O MapQuest Geocoding faz parte de muitos aplicativos de longa data, alguns dos quais não mexem no código de consulta de localização há anos porque ele simplesmente continua funcionando. Nosso host compatível foi construído exatamente para essa situação: código que funciona bem, que ninguém quer reescrever, mas que uma equipe ainda gostaria de tirar de uma integração envelhecida sem reconstruir nada.
O host reproduz exatamente os parâmetros de requisição e o corpo de resposta do MapQuest, exceto os textos de direitos autorais, termos e privacidade, que são nossos e não do provedor original. Uma requisição montada hoje para os endpoints de geocodificação do MapQuest pode ser enviada ao nosso host como está, e a resposta retornada é interpretada da mesma forma que o código existente já espera.
As únicas mudanças necessárias são um nome de host e uma chave. Essa chave se autentica usando qualquer um dos nossos quatro métodos padrão que corresponda à sua integração atual: cabeçalho X-API-Key, cabeçalho Authorization: Bearer, HTTP Basic auth com a chave como nome de usuário ou parâmetro de consulta.
Obter essa chave não exige concluir a verificação da conta primeiro. As chaves de uma conta recém-cadastrada funcionam durante um período de carência antes que o My Geocode exija a confirmação do e-mail de cadastro; depois disso, as chaves não verificadas ficam pausadas em vez de simplesmente falhar. Isso importa exatamente para esse tipo de teste de migração, em que alguém quer apontar uma integração legada para um novo host numa sexta-feira à tarde sem esperar a ida e volta de um e-mail.
Os preços seguem a mesma estrutura de todo o My Geocode. Qualquer endereço recebe 2.500 requisições gratuitas por dia sem chave nenhuma, contadas por rede. Uma chave adiciona suas próprias 2.500 requisições gratuitas por dia, separadas. Passadas essas 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 diferença de valor entre este host e qualquer outro.
Toda resposta traz os mesmos cabeçalhos de cota do restante da plataforma: 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. Dois deles, X-Key-IPs-Used e X-Key-IPs-Limit, acompanham algo específico das chaves, e não das redes: cada chave pode ser chamada a partir de um número pequeno e rotativo de endereços IP, o que impede que uma chave seja compartilhada por uma frota de servidores sem relação entre si, mas ainda tolera um deploy normal que muda o endereço de saída de um aplicativo.
Para projetos que querem mais do que a resposta compatível retorna, mg_extras=1 na requisição, ou um cabeçalho X-MG-Extras, acrescenta campos opcionais por cima do formato padrão, de forma totalmente opcional.
A documentação do host está em /compatibility/mapquest/, e uma visão mais ampla da compatibilidade em toda a plataforma está em /docs/compatibility/. Se o MapQuest Geocoding ainda está quietinho na sua stack, esta é uma forma barata de ver como é uma estrutura de cotas moderna por trás do mesmo formato conhecido.