Casos de uso

Verificando o endereço de um imóvel para aluguel em um site de anúncios

Um hóspede que chega a um aluguel por temporada e descobre que o marcador no mapa aponta para um terreno vazio, para um prédio totalmente diferente ou para um local a algumas ruas do imóvel real tem uma experiência ruim que pesa tanto sobre a plataforma quanto sobre o anfitrião, e uma plataforma de aluguel por temporada que permitia a criação de anúncios por conta própria viu isso acontecer com frequência suficiente para justificar uma correção de verdade, em vez de depender das reclamações dos hóspedes para detectar endereços errados depois do fato.

A maioria dos casos não era fraude deliberada. Anfitriões que digitavam um endereço à mão cometiam erros de digitação comuns, colocavam o marcador um pouco fora do imóvel real ao configurar um novo anúncio ou informavam um código postal que não batia com a cidade e a rua digitadas em outro ponto do mesmo formulário. Um número menor de casos parecia mais deliberado: endereços que eram resolvidos em um lugar totalmente diferente do declarado, às vezes ligados a outros sinais indicando que o anúncio não era de forma alguma o que dizia ser.

A plataforma adicionou uma etapa de verificação ao fluxo de criação de anúncios. O endereço informado pelo anfitrião ia para /v1/forward, que retornava uma correspondência junto com uma indicação de com que confiança ela foi resolvida, e a plataforma comparava esse local resolvido com o marcador que o anfitrião tinha colocado separadamente em um mapa durante a configuração, sinalizando anúncios em que os dois divergiam além de uma pequena tolerância, um forte sinal de que o endereço digitado ou o marcador estava errado, já que em um anúncio realmente preciso os dois devem concordar de perto. O código postal informado era verificado separadamente em /v1/postcode para detectar casos em que ele não correspondia à cidade também informada no formulário.

Os anúncios que passavam nas duas verificações eram publicados normalmente. Os anúncios com divergência entre o endereço digitado e o marcador, ou com um código postal incoerente com o restante do endereço informado, ficavam retidos para uma revisão manual rápida ou, em alguns casos, voltavam para o anfitrião com um aviso específico para conferir e corrigir o campo sinalizado antes que o anúncio pudesse ser publicado, detectando o erro no momento em que era mais fácil e barato corrigi-lo, antes que um hóspede tivesse reservado e viajado com base nele.

Internamente, a plataforma deixava claro que essa verificação confirmava que um endereço estava bem formado e coerente com a localização do marcador, e não que o próprio imóvel correspondia às fotos ou à descrição em qualquer outro aspecto, uma parte separada do seu processo de confiança e segurança que a verificação de endereço não tentava resolver. Tratar a verificação de endereço como uma peça estreita e bem definida de um sistema de confiança mais amplo, em vez de pedir que ela fizesse mais do que razoavelmente podia, manteve as expectativas realistas tanto internamente quanto na forma como o recurso era descrito aos anfitriões.

O volume acompanhava a criação de novos anúncios e as edições de endereços de anúncios existentes, uma carga de trabalho modesta e previsível em relação ao volume total de reservas da plataforma, confortavelmente dentro da cota diária gratuita para uma plataforma de porte moderado.

A documentação dos dois endpoints está em /docs/forward-geocoding/ e /docs/postal-code-lookup/.