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.
Um endpoint dedicado para consulta de código postal
Nem toda pergunta sobre localização é, de fato, uma pergunta de geocodificação. Às vezes, a única coisa de que uma aplicação realmente precisa é o código postal de uma determinada área, ou a área coberta por um determinado código postal, sem a resolução de endereço mais ampla que a geocodificação direta ou reversa oferece. O /v1/postcode existe especificamente para essa pergunta mais restrita, como um endpoint dedicado, e não como efeito colateral de uma consulta mais geral.
Mantê-lo separado de /v1/forward e /v1/reverse importa por alguns motivos práticos. Significa que o formato da requisição pode ser construído especificamente em torno de parâmetros de código postal, em vez de adaptado de uma estrutura de endereço mais ampla. Significa que a resposta pode se concentrar exatamente no que uma integração só de código postal precisa, sem campos de endereço extras para filtrar. E significa que a documentação, disponível na íntegra em /docs/postal-code-lookup/, pode explicar o comportamento do código postal por si só, e não como uma subseção de um guia de geocodificação mais longo.
A autenticação segue as mesmas regras de todos os outros endpoints: um cabeçalho X-API-Key, um cabeçalho Authorization: Bearer, HTTP Basic auth com a chave como nome de usuário ou um parâmetro de query, todos aceitos da mesma forma. O preço também é o mesmo, usando a mesma cota diária gratuita, seja da rede que faz a chamada ou da chave, e os mesmos € 0,0001 por requisição em crédito pré-pago ou a cobertura de um pacote Unlimited além disso.
Requisições em lote funcionam aqui exatamente como em qualquer outro ponto da plataforma: cada código postal ou endereço enviado em uma única chamada conta como uma requisição, e não a chamada como um todo. Uma equipe que valida códigos postais em uma grande lista de clientes pode enviar essa lista como um lote e esperar a mesma contagem por item que se aplica a qualquer outra operação em massa no My Geocode.
Ter um endpoint dedicado também torna mais preciso o trabalho de compatibilidade de código postal em nossos dezessete hosts de compatibilidade, já que provedores que oferecem sua própria consulta postal dedicada podem ser reproduzidos exatamente, em vez de aproximados por meio de um formato de geocodificação mais amplo.
Se a sua aplicação só precisa de informações de código postal e até agora enviava requisições de geocodificação mais amplas apenas para extrair esse campo, vale a pena passar a usar o /v1/postcode diretamente. Ele está documentado por completo em /docs/postal-code-lookup/, junto com o restante da nossa referência de endpoints em /docs/.