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 OpenCage já está no ar
O OpenCage conquistou seguidores entre desenvolvedores que gostam de uma API de geocodificação direta e bem documentada, sem muita coisa a mais. Construímos nosso host compatível com o mesmo espírito: reproduzir exatamente o formato de requisição e resposta, para que nada na migração pareça começar do zero.
O host reproduz com precisão os parâmetros de requisição e o corpo de resposta do OpenCage, e as únicas diferenças são os textos de direitos autorais, termos e privacidade, que são do próprio My Geocode. Código que hoje monta uma requisição no formato do OpenCage e interpreta uma resposta no formato do OpenCage pode ser apontado para o nosso host sem que essas duas partes sejam tocadas.
O que muda é o nome do host na sua configuração e a chave com a qual você se autentica. Essa chave pode ser enviada 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 abordagem que sua biblioteca cliente atual já adota. As quatro funcionam da mesma forma em todos os hosts que operamos.
Os preços seguem nossa estrutura padrão, qualquer que seja o host que atende uma requisição. 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 além disso. 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, e nada disso muda se a chamada passou por este host compatível ou diretamente por /v1/forward.
Os cabeçalhos de cota acompanham todas as respostas, oferecendo uma camada de visibilidade do uso que uma integração simples com o OpenCage não teria: 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 estão todos incluídos, sempre.
Para equipes que querem mais do que a resposta compatível retorna por padrão, adicionar mg_extras=1 à requisição, ou um cabeçalho X-MG-Extras, acrescenta campos opcionais por cima, como a altitude do terreno, sem alterar o formato base a menos que você peça.
A documentação do host fica em /compatibility/opencage/, e uma visão mais ampla de como os hosts compatíveis funcionam em toda a plataforma está em /docs/compatibility/. Se o OpenCage já está conectado à sua stack, testar a migração é questão de alterar uma URL base e usar uma chave nova.