La API de Routes es un servicio web con dos métodos: Compute Routes, que devuelve una ruta entre dos ubicaciones con puntos de referencia intermedios opcionales, y Compute Route Matrix, que devuelve la distancia y el tiempo de viaje para combinaciones de orígenes y destinos (hasta 625 elementos de ruta).
API de Routes: Datos clave
- Producto: API de Routes
- También conocida como: API de Routes v2, Compute Routes, Compute Route Matrix
- Categoría: Rutas
- Plataforma: Servicio web (REST)
- Se ejecuta en: Servidor (código de backend)
- Etapa de lanzamiento: GA
- Ciclo de vida: Activo
- Descripción general: Descripción general de la API de Routes
- Disponibilidad regional: Global. Las rutas para vehículos de dos ruedas, las rutas ecológicas y el cálculo de peajes se limitan a los países y las ciudades admitidos, y los territorios dependientes con su propio código CLDR no se admiten, a menos que se indiquen. En el caso de las direcciones de facturación del Espacio Económico Europeo (EEE), las condiciones para el EEE que se encuentran en https://developers.google.com/maps/comms/eea/routes prohíben el uso de descripciones o pasos de rutas con cualquier mapa. (detalles de la cobertura)
API de Routes: Cuándo usarla
Usa la API de Routes en los siguientes casos:
- Necesitas una ruta entre un origen y un destino, con puntos de referencia intermedios opcionales, para conducir, caminar, andar en bicicleta, andar en un vehículo de dos ruedas o usar el transporte público.
- Necesitas distancias y tiempos de viaje para muchos pares de origen y destino en una sola solicitud (hasta 625 elementos).
- Necesitas estimaciones de tarifas de peaje (ciudades seleccionadas), rutas ecológicas (regiones seleccionadas), polilíneas que tengan en cuenta el tráfico o rutas para vehículos grandes (disponibilidad limitada).
- Estás migrando una app de servidor desde la API de Directions o la API de Distance Matrix heredadas.
No uses la API de Routes en los siguientes casos:
- Necesitas optimizar las asignaciones de carga y el orden de las paradas para toda una flota de vehículos. En su lugar, usa la API de Route Optimization.
- Necesitas navegación paso a paso en la app para Android que siga una ruta calculada. En su lugar, usa el SDK de Navigation para Android.
- Necesitas navegación paso a paso en la app para iOS que siga una ruta calculada. En su lugar, usa el SDK de Navigation para iOS.
API de Routes: Configuración
- Servicio que se habilitará:
routes.googleapis.com - Autenticación: Clave de API, OAuth 2.0, cuenta de servicio
- Comienza a usar la API de Routes: Configura la API de Routes
- Referencia: Referencia de la API de Routes
- Precios: Uso y facturación de la API de Routes
- Políticas: Políticas de la API de Routes
- Notas de la versión: Notas de la versión de la API de Routes
Paquetes oficiales de la API de Routes:
- npm:
@googlemaps/routing - pypi:
google-maps-routing - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routing
API de Routes: Productos relacionados
- Reemplaza a: API de Directions y API de Distance Matrix
- Se suele usar con: SDK de Navigation para Android, SDK de Navigation para iOS, API de Route Optimization, API de Geocoding y API de Places (nueva)
API de Routes: Errores comunes
- Problema: No hay una lista predeterminada de campos devueltos; las solicitudes sin una máscara de campo (encabezado
X-Goog-FieldMasko parámetro$fields) devuelven un error. Solución: Envía siempre una máscara de campo que enumere los campos de respuesta que necesitas. Consulta /maps/documentation/routes/choose_fields. - Problema: El uso de la máscara de campo comodín (
*) en producción aumenta el costo y la latencia, y el costo puede aumentar de forma inesperada a medida que se agregan nuevas funciones avanzadas a la respuesta. Solución: Usa*solo durante el desarrollo; en producción, solicita únicamente los campos que necesites. Consulta /maps/documentation/routes/choose_fields. - Problema: La información de peajes y el consumo de combustible no se devuelven solo con agregarlos a la máscara de campo; desde la DG, deben habilitarse de forma explícita. Solución: Agrega el array
extraComputations(por ejemplo,TOLLS,FUEL_CONSUMPTION) a la solicitud, además de la máscara de campo. Consulta /maps/documentation/routes/migrate-routes-preview. - Problema: Compute Route Matrix permite 625 elementos, pero solo 100 cuando
routingPreferenceesTRAFFIC_AWARE_OPTIMAL. Solución: Mantén el producto de orígenes por destinos en 100 o menos cuando usesTRAFFIC_AWARE_OPTIMAL, o bien divide la solicitud. Consulta /maps/documentation/routes/compute_route_matrix.
Qué puedes hacer con la API de Routes
Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.
- Muestra las instrucciones sobre cómo llegar entre dos o más coordenadas de latitud y longitud como una serie de coordenadas para cada paso de una ruta.
- Muestra instrucciones sobre cómo llegar entre dos o más conjuntos de coordenadas de latitud y longitud como una serie de descripciones de maniobras para los pasos de una ruta.
- Muestra la distancia entre cada paso de una ruta entre dos o más conjuntos de coordenadas de latitud y longitud.
- Devuelve la duración del viaje entre cada paso de una ruta entre dos o más conjuntos de coordenadas de latitud y longitud.
- Devuelve una polilínea codificada entre cada paso de una ruta entre dos o más conjuntos de coordenadas de latitud y longitud.
- Devuelve la distancia de una ruta entre dos o más conjuntos de coordenadas de latitud y longitud.
- Devuelve la duración del viaje para una ruta entre dos o más conjuntos de coordenadas de latitud y longitud.
- Devuelve una polilínea codificada para una ruta entre dos o más conjuntos de coordenadas de latitud y longitud.
- Devuelve información sobre los peajes de una ruta entre dos o más conjuntos de coordenadas de latitud y longitud.
- Especifica el medio de transporte (en automóvil, en transporte público, a pie o en vehículo de dos ruedas) para una solicitud de ruta. Nota: En el servicio web de la API de Routes (computeRoutes), pasa travelMode en el cuerpo JSON de HTTP POST con RouteTravelMode (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT o TRUCK con routeModifiers.vehicleInfo) y, en lugar de un parámetro de consulta de modo GET heredado, incluye el encabezado X-Goog-FieldMask requerido. En la biblioteca de Routes de la API de Maps JavaScript, pasa travelMode y fields en ComputeRoutesRequest.
- Especifica una parada o un punto de paso para una solicitud de ruta.
- Especifica cómo se usan los datos de tráfico en una solicitud de ruta.
- Especifica las características que se deben evitar, como autopistas o peajes, para una solicitud de ruta.
- Establece puntos de referencia a lo largo de una ruta.
- Establecer puntos de referencia intermedios en una ruta
- Establece un punto por el que debe pasar una ruta.
- Especifica la dirección del vehículo y el lado de la ruta para una ruta.
- Optimiza el orden de las paradas de tu ruta.
- Especifica rutas ecológicas para una solicitud de rutas. Versión preliminar
- Especifica una distancia más corta o una ruta alternativa para una solicitud de rutas. Nota: En la API de Routes, solicitar una ruta de referencia de distancia más corta (SHORTER_DISTANCE) es una función experimental, mientras que solicitar rutas alternativas (computeAlternativeRoutes) es una función de DG.
- Muestra las distancias de una matriz de rutas entre varios orígenes y destinos.
- Devuelve la duración del viaje para una matriz de rutas entre varios orígenes y destinos.
- Devuelve información de peajes para una matriz de rutas entre varios orígenes y destinos.
- Especificar el medio de transporte (en automóvil, en transporte público, a pie o en vehículo de dos ruedas) para una solicitud de matriz de rutas Nota: En el servicio web de la API de Routes (computeRouteMatrix), pasa travelMode en el cuerpo JSON de HTTP POST con RouteTravelMode (DRIVE, TWO_WHEELER, WALK, TRANSIT o TRUCK con origins[].routeModifiers.vehicleInfo; no se admite BICYCLE para las matrices de rutas) y, además, incluye el encabezado X-Goog-FieldMask requerido. En la biblioteca de Routes de la API de Maps JavaScript, pasa travelMode y los campos en ComputeRouteMatrixRequest.