Migração

Saindo de uma integração com o autosuggest do HERE

O endpoint de autosuggest da HERE retorna sugestões de endereços e lugares enquanto o usuário digita, estruturadas como um array items em que cada item traz um title, um resultType que indica se a sugestão é um endereço completo, um lugar ou uma categoria e, muitas vezes, um objeto de destaque que marca quais caracteres corresponderam à entrada. Essa mistura de tipos de resultado, endereços, lugares e categorias juntos em uma única resposta, é uma das partes mais características da abordagem da HERE e algo que vale mapear com cuidado antes de presumir que o autocomplete de outro provedor funciona da mesma forma.

As integrações de autosuggest costumam estar profundamente ligadas a um componente de front-end específico, um campo de endereço com uma lista suspensa, e os detalhes da interação (com que rapidez as sugestões aparecem, como o destaque é renderizado, o que acontece quando o usuário ignora as sugestões e simplesmente continua digitando) tendem a importar mais para os usuários finais do que qualquer detalhe de implementação no backend. Isso faz da migração em parte uma tarefa de backend e em parte uma revisão de UX.

O My Geocode oferece preenchimento automático de endereços conforme documentado em /docs/address-autocomplete/, com o seu próprio formato de requisição e resposta. Como a mistura de resultados e o comportamento de ordenação são realmente específicos da implementação de cada provedor, vale a pena testar este endpoint diretamente com consultas representativas da sua própria base de usuários, em vez de presumir que a estrutura de resultados de tipos mistos da HERE se mantém sem alterações. Provedores diferentes traçam uma linha diferente entre o que conta como sugestão de endereço e o que conta como lugar.

Etapas que costumam funcionar bem para este tipo de migração:

  • Cataloge os valores específicos de resultType nos quais o seu código de front-end ramifica hoje, já que essa lógica de ramificação é a parte com mais chance de precisar de ajuste
  • Revise o comportamento de destaque ou de trecho correspondente que a sua interface renderiza hoje e verifique se o novo endpoint oferece um equivalente ou se esse detalhe específico da interface precisa ser refeito
  • Execute o novo endpoint com uma amostra de consultas históricas reais dos seus logs, e não com endereços de teste sintéticos, já que os padrões reais de digitação dos usuários (erros de digitação, palavras incompletas, abreviações) revelam diferenças de ordenação que dados de teste limpos não mostram

A autenticação usa uma chave enviada como X-API-Key, Authorization: Bearer, autenticação HTTP Basic ou parâmetro de consulta. Os preços são 2.500 requisições gratuitas por dia sem chave, mais 2.500 gratuitas por chave por dia, contadas por rede, e depois crédito pré-pago a € 0,0001 por requisição ou uma chave Unlimited a € 50 por mês, o mesmo valor para todos os endpoints da plataforma.

Considerando a frequência com que o autosuggest é disparado em relação a uma chamada de geocodificação típica, já que quase cada tecla pode gerar uma requisição, vale a pena estimar o volume em relação à sua cota diária gratuita e ao preço por requisição antes de um lançamento completo, em vez de descobrir o padrão de uso real só depois que ele estiver em produção.