Migración

Dejar una integración de autocompletado de Google Places

El autocompletado es un tipo de integración distinto de una simple llamada de geocodificación. Se activa casi con cada pulsación de tecla que hace un usuario en un campo de dirección, depende en algunos proveedores de precios o agrupaciones basados en sesiones, y la respuesta tiene que llegar lo bastante rápido como para que un retraso no resulte visible a quien está escribiendo. Migrar esta parte conlleva más riesgo para la experiencia de usuario que un trabajo de geocodificación por lotes precisamente porque los usuarios interactúan con ella directamente y en tiempo real.

Google Places Autocomplete devuelve una lista de predicciones, cada una con una cadena description y un place_id que se usa en una llamada de detalles posterior para obtener la dirección completa y la información de coordenadas. Ese patrón en dos pasos, primero las predicciones y después los detalles, es un modelo de interacción concreto que condiciona mucho código de front end construido a su alrededor, incluidos los tiempos de debounce y la forma de mostrar los resultados seleccionados antes de que se resuelva la llamada de detalles.

Este es un caso en el que importa describir las capacidades con honestidad. My Geocode ofrece autocompletado de direcciones como parte de sus endpoints de consulta, con la solicitud y la respuesta estructuradas tal como se documenta en /docs/address-autocomplete/, pero el comportamiento concreto de cualquier endpoint de autocompletado, incluida la agrupación por sesiones y la clasificación de resultados, merece probarse directamente con tus propios datos de direcciones y patrones de usuario en lugar de suponer una correspondencia exacta con el modelo en dos pasos de Google. Cada proveedor estructura de forma distinta el flujo de la sugerencia al detalle, y esa diferencia estructural suele ser la mayor tarea real de migración en este caso, más que cualquier nombre de campo concreto.

Pasos prácticos para esta migración:

  • Analiza si tu implementación actual necesita el patrón en dos pasos de predicciones y después detalles, o si un endpoint de sugerencias de una sola llamada simplificaría en realidad tu código de front end
  • Prueba los ajustes de debounce y de número mínimo de caracteres con los tiempos de respuesta reales del nuevo endpoint en tus propias condiciones de red, en lugar de reutilizar valores ajustados para la infraestructura de Google
  • Comprueba cómo gestiona tu interfaz una lista de predicciones que llega vacía o con un solo resultado, ya que el comportamiento de clasificación varía considerablemente entre proveedores y tu experiencia de respaldo no debería depender de recibir varias sugerencias

La autenticación del nuevo endpoint funciona con una clave como cabecera X-API-Key, Authorization: Bearer, autenticación HTTP Basic o un parámetro de consulta. Hay 2.500 solicitudes gratuitas al día sin ninguna clave y 2.500 gratuitas más por clave y por día, contadas por red, y a partir de ahí el precio es crédito prepago a 0,0001 € por solicitud o una clave Unlimited a 50 € al mes, la misma tarifa que cualquier otro endpoint.

Como las llamadas de autocompletado pueden alcanzar un volumen alto en comparación con las llamadas de geocodificación reales, dado que la mayoría de las pulsaciones de tecla generan una solicitud, conviene estimar el volumen diario esperado frente a la cuota gratuita y la tarifa por solicitud antes de fijar una fecha de lanzamiento, para que no haya sorpresas en la primera semana de tráfico real.