Conectar Google Maps: distancia, duración y ETA de rutas para carriles TMS
Cree un proyecto en Google Cloud Console, active la Routes API, cree una API key, complete esa única api_key en Integration, pruébela con una llamada real a Routes, elija la plantilla de planificación de rutas y active: TMS obtendrá distancia, duración y ruta para costo de carril y ETA.
El conector de Google Maps es una fuente de datos de rutas para TMS. Usa la Google Maps Routes API para calcular una ruta por vez (distancia, duración y la propia ruta), para que los envíos y las licitaciones en TMS usen ese resultado como base del costo de carril y del ETA. Ese es su único trabajo: no trae ni envía pedidos, no sincroniza clientes ni inventario y no rastrea vehículos. Una conexión guarda una sola Google Maps API Key.
Requisitos previos#
- Acceso a Google Cloud Console con permiso para crear un proyecto, activar una API y crear una API key en ese proyecto.
- La Routes API estará activada en ese proyecto. Sin ella, una clave correcta igual no puede devolver una ruta.
- Entiende que probar esta conexión genera uso: no hay un endpoint de prueba gratuito para la Routes API, así que cada prueba es una llamada real de ruta y usa una cuota. No haga clic en probar una y otra vez sin motivo.
- Permiso en este sistema para abrir Integration y crear una conexión nueva.
Obtener credenciales#
- Inicie sesión en Google Cloud Console y cree un proyecto para esta conexión.
- En ese proyecto, active la Routes API.
- Cree una API key en el mismo proyecto y copie la clave completa. Las claves de este conector empiezan con AIza…: copie el valor entero, sin cortar nada en ningún extremo.
- Restrinja la clave como sugiere la guía de la consola: limítela a la Routes API y a su IP. Anote exactamente qué API y qué IP permitió, porque un fallo posterior suele ser solo una falta de coincidencia con esa restricción.
Completar en Integration#
- Abra Integration → Marketplace → Google Maps → Nueva conexión.
- api_key, obligatorio, Google Maps API Key: pegue la API key completa que creó en Google Cloud Console después de activar la Routes API. Es un campo de tipo contraseña y se guarda como secreto. Este conector no tiene un segundo campo: aquí no se completa nombre de cuenta, campo de proyecto ni usuario.
- Guarde la conexión antes de probarla, para que la prueba use exactamente la clave que acaba de introducir.
Probar la conexión#
Haga clic en Probar la conexión. Con una clave completada, la prueba hace una llamada real y mínima a Routes: envía una solicitud computeRoutes a https://routes.googleapis.com/directions/v2:computeRoutes con su clave en el encabezado X-Goog-Api-Key, desde el origen 34.0633,-117.6509 hasta el destino 34.0733,-117.6409 en modo driving. Aprobar significa que la clave es válida y que la Routes API responde, y el mensaje de éxito lo dice con palabras: API key válida, Routes API alcanzable (la sonda consume una cuota). Lea esa última parte al pie de la letra: esta sonda es una llamada real y usa una cuota cada vez que la ejecuta, así que pruebe una vez, corrija la causa si falla y solo entonces vuelva a probar.
Mapping / elegir plantilla#
Elija la plantilla de planificación de rutas, la única que usa este conector. No hay campos de pedidos ni de clientes para mapear. Lo que define la plantilla es cómo se envía a Google un modo de viaje pedido en TMS: driving y driving-traffic se envían como DRIVE, cycling como BICYCLE y walking como WALK. Tras aprobar la prueba, pida en TMS una ruta que ya conoce y compare la distancia y la duración devueltas con lo que espera para ese carril, antes de activar. Si las cifras se ven mal en todos los carriles, revise primero el modo: los mismos dos puntos dan resultados muy distintos en auto, en bicicleta y a pie.
Activar#
Tras activar, TMS puede pedir una ruta a esta conexión cuando un envío o una licitación necesita una estimación de carril: la conexión devuelve distancia, duración y la ruta, y TMS los usa como base del costo de carril y del ETA. Vigile las primeras solicitudes reales en Runs / Logs y compare algunas distancias y duraciones devueltas con carriles que conoce, antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: solo ofrece planificación de rutas. No trae pedidos, no devuelve nada a otro sistema, no sincroniza clientes ni inventario y no sigue a un vehículo mientras se mueve. Si una pantalla de TMS no muestra pedidos nuevos tras activar, es lo esperado: los pedidos vienen de sus canales de pedidos, y esta conexión solo responde cuando TMS pregunta cuánto, cuánto tiempo y por qué ruta.
Preguntas frecuentes#
La prueba falla justo después de crear la clave, con la Routes API no alcanzable
La causa más común es que la Routes API nunca se activó en el proyecto que guarda la clave. La clave puede ser perfectamente válida como clave, pero Google no tiene el servicio Routes encendido para ese proyecto, así que la llamada computeRoutes no tiene adónde ir.
Abra Google Cloud Console, seleccione el mismo proyecto donde creó la clave, active allí la Routes API, espere un momento a que el cambio surta efecto y pruebe la conexión una vez más.
La prueba falla después de restringir la clave a una API y una IP
La restricción que puso en la clave no coincide con cómo este sistema llama a Google. Si la lista de API permitidas no incluye la Routes API, o la IP permitida no es la dirección desde la que llama este sistema, Google rechaza la llamada aunque el texto de la clave pegado sea exactamente correcto.
En Google Cloud Console, abra esa clave y revise las dos partes de la restricción: la Routes API debe estar en la lista de API permitidas, y la IP permitida debe ser la dirección desde la que este sistema llama a Google. Corrija la restricción, guarde y pruebe una vez más: no cree una segunda clave para esquivar una restricción que no coincide.
El uso sube aunque la conexión aún no está activada
Cada prueba es una llamada real. La Routes API no tiene un endpoint de sonda gratuito, así que la prueba solo puede demostrar que la clave funciona pidiendo una ruta real, y esa solicitud usa una cuota, exactamente como dice el mensaje de éxito: la sonda consume una cuota. Probar una y otra vez antes de activar es uso real.
Pruebe una vez. Si falla, lea el fallo, corrija esa única causa en la clave, el proyecto o la restricción, y solo entonces vuelva a probar. Cuando la prueba apruebe, siga con la plantilla y la activación en lugar de probar otra vez para reconfirmar.
La clave se ve completa, pero Google igual la rechaza
El valor pegado no es la clave que Google emitió para este proyecto: se perdió un carácter al copiar, vino un espacio de más, o la clave pertenece a otro proyecto donde la Routes API y la restricción están configuradas distinto. El campo acepta cualquier texto, así que solo la llamada real de la prueba puede distinguirlo.
Vuelva a Google Cloud Console, abra la clave en el proyecto donde la Routes API está activada, copie de nuevo el valor completo de una sola vez, péguelo en api_key sin teclear ninguna parte a mano, guarde y pruebe una vez.
Las distancias y duraciones se ven mal en un carril que conoce bien
La ruta se calculó para un modo de viaje distinto del que esperaba. La plantilla envía driving y driving-traffic como DRIVE, cycling como BICYCLE y walking como WALK, y los mismos dos puntos dan distancia, duración y ruta muy distintas en cada modo: un resultado a pie leído como resultado en auto se ve mal aunque la llamada haya funcionado.
Revise qué modo usó la solicitud de TMS para ese carril, compárelo con el modo que tenía en mente y recalcule con el modo previsto. Juzgue el resultado solo contra el mismo modo: no compare una duración BICYCLE con su experiencia en auto.
Activada, pero no aparecen pedidos ni rastreo en ningún lado
Nada está roto. Esta conexión nunca transportó pedidos ni rastreo: su única capacidad es la planificación de rutas, así que activar no añade una fuente de pedidos ni posiciones de vehículos, solo permite que TMS pida distancia, duración y ruta cuando un envío o una licitación necesita una estimación de carril.
Use sus canales de pedidos para los pedidos y las herramientas del transportista para el rastreo. Use esta conexión solo donde se necesita un costo de carril o un ETA, y revise su trabajo en el resultado de ruta de un envío o una licitación en TMS.