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 PositionStack já está no ar
O PositionStack costuma aparecer em integrações mais leves, muitas vezes uma única classe de serviço envolvendo uma chamada de API dentro de um aplicativo maior. Esse tipo de integração é pequeno o bastante para passar facilmente despercebido e grande o bastante para ser chato de reescrever. Nosso host compatível existe para eliminar completamente essa reescrita.
O host reproduz exatamente os parâmetros de requisição e o corpo de resposta do PositionStack, exceto os textos de direitos autorais, termos e privacidade, que são nossos e não do provedor original. Uma requisição montada para o endpoint de geocodificação do PositionStack pode ser enviada ao nosso host sem alteração, e a resposta volta no mesmo formato que o código existente já interpreta.
O que muda é um nome de host e uma chave. Essa chave se autentica por qualquer um dos nossos quatro métodos padrão que sua integração já usa: 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.
Uma única classe de serviço envolvendo uma chamada também é o tipo de integração para a qual ninguém mantém documentação, então as dúvidas costumam surgir mais tarde como chamados de suporte de quem herdou o código. A fila de suporte do My Geocode mantém respostas prontas exatamente para essas perguntas recorrentes sobre compatibilidade, o significado dos cabeçalhos, os formatos de chave, o que muda e o que não muda, para que uma pergunta simples sobre migração seja respondida rapidamente, em vez de esperar atrás de casos mais complexos.
Testar o formato de uma resposta antes de mexer em qualquer código também é simples: a demonstração interativa em /demo/ pode enviar uma requisição de exemplo para qualquer endpoint ou host compatível e mostrar exatamente os campos retornados, o que muitas vezes basta para confirmar que uma chamada no formato do PositionStack será interpretada sem problemas mais adiante.
Os preços não variam conforme o host compatível que atendeu uma requisição. Qualquer endereço recebe 2.500 requisições gratuitas por dia sem chave nenhuma, contadas por rede. Uma chave adiciona mais 2.500 requisições gratuitas por dia próprias. 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, exatamente como em todos os outros endpoints e hosts da plataforma.
Toda resposta também inclui nossos 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, oferecendo uma visibilidade do uso que uma integração simples com o PositionStack não exporia.
Para qualquer coisa além dos campos padrão da resposta compatível, mg_extras=1 na requisição, ou um cabeçalho X-MG-Extras, acrescenta extras opcionais por cima, totalmente opcionais e desligados por padrão.
O host está documentado em /compatibility/positionstack/, e uma visão mais ampla de como funcionam todos os dezessete hosts compatíveis está em /docs/compatibility/. Se o PositionStack está escondido em algum serviço da sua stack, apontá-lo para cá é uma mudança pequena e reversível de testar.