Casos de uso

Criando um planejador de territórios de franquia

Vender um novo território de franquia que se sobrepõe demais a um existente é o tipo de erro que gera processos judiciais, não apenas conversas constrangedoras, e um franqueador que se expandia para uma nova região precisava ter certeza, com dados reais e não com uma noção aproximada tirada de um mapa em papel, de onde exatamente as suas unidades existentes ficavam em relação a qualquer novo território que estivesse prestes a oferecer.

Os registros das unidades do franqueador existiam como endereços em texto no seu sistema de gestão de franquias, úteis para enviar faturas e inúteis para medir distâncias ou traçar uma fronteira. Transformar essa lista em algo que um processo de planejamento de territórios pudesse realmente usar começou com a geocodificação de toda a rede existente em um único lote pelo /v1/forward, já que uma requisição em lote conta cada endereço como um item cobrado, dando a cada unidade uma coordenada fixa em vez de um nome e uma rua que não podiam ser comparados diretamente com uma nova fronteira proposta.

Com coordenadas para toda a rede existente, traçar um novo território se tornou um exercício mensurável: uma fronteira proposta para um novo franqueado podia ser verificada diretamente com as coordenadas de cada unidade existente próxima, confirmando que uma distância mínima era respeitada ou que a fronteira proposta não incluía por engano um território existente concorrente, uma verificação que a equipe jurídica e de expansão do franqueador podia fazer antes mesmo de apresentar um mapa de território a um potencial franqueado, detectando um conflito no papel e não depois da assinatura de um contrato.

O franqueador também usou a rede geocodificada para uma análise de expansão direta, observando quais regiões não tinham nenhuma unidade existente a uma distância razoável de qualquer centro populacional que valesse a pena atender, uma análise de lacunas que antes dependia da familiaridade geral da equipe de expansão com o mapa, e não de uma distância realmente medida a partir de coordenadas reais. Essa análise revelou algumas regiões genuinamente mal atendidas que a equipe de expansão não havia priorizado antes, simplesmente porque ninguém tinha olhado as lacunas de cobertura da rede existente com dados reais de distância, em vez de uma impressão do mapa.

Foi em grande parte um projeto pontual, e não uma integração contínua, com um formato semelhante ao de um mapeamento de territórios de vendas: a rede existente foi geocodificada uma vez, em um lote que coube confortavelmente na cota diária gratuita para uma rede de franquias de porte moderado, e as novas unidades foram geocodificadas individualmente à medida que entravam em operação, um volume contínuo pequeno e previsível que nunca chegou perto de exigir crédito pré-pago para um franqueador que acrescenta um número modesto de novas unidades por ano.

O valor do projeto apareceu especificamente na segurança que ele deu à equipe jurídica e de expansão antes de finalizar um novo território, já que uma fronteira proposta verificada com distâncias reais até unidades reais existentes era uma posição muito mais sólida para defender do que uma traçada à mão e revisada a olho, principalmente se algum dia uma disputa de território com um franqueado existente precisasse ser resolvida e a empresa quisesse apontar para um processo documentado e medido, e não para uma avaliação subjetiva.

A documentação do endpoint, incluindo a formatação de requisições em lote, está em /docs/forward-geocoding/.