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 Open-Elevation já está no ar
O Open-Elevation há muito tempo é uma forma simples e sem firulas de associar a altura do terreno a um conjunto de coordenadas. Nosso host compatível pega esse mesmo formato de requisição e resposta e coloca por trás dele um serviço de altitude totalmente funcional, junto com uma estrutura de cotas que diz exatamente quanto você usou.
O host reproduz exatamente os parâmetros de requisição e o corpo de resposta do Open-Elevation, exceto os textos de direitos autorais, termos e privacidade, que são nossos e não do provedor original. Envie um conjunto de coordenadas do jeito que você já envia ao Open-Elevation, e os valores de altitude voltam no mesmo formato JSON que seu código atual já interpreta.
Como nosso endpoint de altitude é totalmente funcional, não se trata apenas de uma correspondência de formato. Consulte as coordenadas de um local e a resposta retorna um valor real de altitude em metros, da mesma forma que /v1/elevation faz diretamente. As requisições em lote também funcionam do mesmo jeito, com cada par de coordenadas contado como uma requisição, e não a chamada como um todo.
A autenticação aceita nossos quatro métodos habituais: 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. Como o Open-Elevation costuma ser usado sem nenhuma autenticação, adicionar uma chave aqui também significa ganhar uma cota dedicada e rastreável, em vez de depender de um recurso compartilhado e sem gestão.
Os preços são os mesmos de todos os outros hosts da plataforma. Qualquer endereço recebe 2.500 requisições gratuitas por dia sem precisar de chave, contadas por rede. Uma chave adiciona suas próprias 2.500 requisições gratuitas por dia. Além das duas, o crédito pré-pago custa € 0,0001 por requisição, ou um pacote Unlimited cobre o uso por € 50 por mês.
Os cabeçalhos de cota acompanham todas as respostas: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used e X-Credits-Remaining estão todos presentes, oferecendo uma visibilidade confiável do volume de consultas de altitude que uma instância pública compartilhada normalmente não oferece.
Para qualquer coisa além da resposta de altitude padrão, mg_extras=1 na requisição, ou um cabeçalho X-MG-Extras, acrescenta extras opcionais por cima do formato compatível, apenas se você escolher.
O host está documentado em /compatibility/open-elevation/, e o endpoint de altitude por trás dele é explicado em detalhes em /docs/elevation-lookup/. Se consultas de altitude fazem parte hoje de um recurso de mapas ou de roteamento, esta é uma forma direta de adicionar uma cota dedicada por trás do mesmo formato de requisição.