Referencia rápida de la API de Routes

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

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: Errores comunes

  • Problema: No hay una lista predeterminada de campos devueltos; las solicitudes sin una máscara de campo (encabezado X-Goog-FieldMask o 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 routingPreference es TRAFFIC_AWARE_OPTIMAL. Solución: Mantén el producto de orígenes por destinos en 100 o menos cuando uses TRAFFIC_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.