Casos de uso

Verificar um endereço de entrega antes do envio

Uma entrega de móveis que falha é cara de um jeito que uma entrega de encomenda que falha não é. Um caminhão, uma equipe de duas pessoas e uma janela agendada são desperdiçados quando o endereço do pedido não leva a lugar útil, e uma loja de móveis que enviava itens grandes em janelas de entrega agendadas estava arcando com esse custo várias vezes por semana.

A maioria das falhas tinha a mesma causa raiz: um endereço digitado corretamente segundo o cliente, mas que na verdade não correspondia a um local onde fosse possível entregar, seja por um erro de digitação no nome da rua, por um código postal que não batia com a cidade informada ou por um número de apartamento que simplesmente faltava. Nada disso é óbvio olhando o texto do endereço. Só fica óbvio quando algo tenta comparar esse endereço com dados geográficos reais.

A loja adicionou uma verificação na confirmação do pedido, antes que o pedido fosse entregue ao sistema de agendamento de entregas. O endereço informado pelo cliente era enviado para /v1/forward, que tenta encontrar a correspondência e retorna um resultado de localização junto com uma indicação da qualidade da correspondência, mostrando com que confiança o endereço foi resolvido em vez de fingir que toda entrada é igualmente confiável. Separadamente, o código postal informado pelo cliente era verificado em /v1/postcode, que consulta a que local esse código corresponde, detectando o caso específico em que um código postal e o nome de uma cidade não concordavam entre si, uma divergência fácil de o cliente cometer por erro do preenchimento automático e muito difícil de perceber lendo o formulário do pedido.

Os pedidos em que as duas verificações voltavam limpas seguiam direto para o agendamento. Os pedidos em que o endereço correspondia apenas parcialmente, ou em que o código postal e a cidade divergiam, eram sinalizados para uma ligação ou e-mail rápido de confirmação antes que qualquer janela de entrega fosse reservada. Essa única etapa extra, executada automaticamente e com efeito antes de qualquer custo de caminhão, antecipou a correção no processo, de "descoberto por uma equipe parada no endereço errado" para "resolvido por um e-mail no mesmo dia em que o pedido foi feito".

A loja tomava cuidado com o que afirmava aos clientes. Uma verificação como esta confirma que um endereço está bem formado e é geograficamente plausível. Ela não confirma que um número de unidade específico existe dentro de um grande condomínio, nem que a pessoa que fez o pedido realmente mora lá, por isso a lógica de sinalização foi ajustada para detectar endereços claramente quebrados em vez de rejeitar qualquer coisa minimamente incomum, o que teria gerado mais alarmes falsos do que resolvido problemas.

Como a verificação era executada uma vez por pedido e não por visualização de página, o volume era fácil de prever e ficava bem dentro da cota diária gratuita para uma loja desse porte, com crédito pré-pago cobrindo qualquer excedente durante uma promoção. O retorno da mudança apareceu diretamente em menos janelas de entrega desperdiçadas, um custo fácil de medir e fácil de justificar diante de um preço por requisição muito baixo.

A documentação dos dois endpoints, incluindo como a qualidade da correspondência é representada, está em /docs/forward-geocoding/ e /docs/postal-code-lookup/.