Cómo migrar desde la API de Directions o la de Distance Matrix

En esta guía, se describe cómo migrar apps que usan la API de Directions o de Distance Matrix para usar API de Routes. Para obtener detalles sobre la API de Routes, consulta información acerca del descripción general.

Actualiza los extremos de la API de REST

Actualiza tu código para usar los nuevos extremos de la API de Routes.

Desde la API de Directions

API de Directions https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
API de Routes https://routes.googleapis.com/directions/v2:computeRoutes

Desde la API de Distance Matrix

API de Distance Matrix https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
API de Routes https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

Convierte los parámetros de URL para usar un cuerpo de solicitud HTTPS

Con las APIs de Directions y de Distance Matrix, Pasar propiedades de configuración como parámetros de URL a una solicitud HTTP GET Para ejemplo, para la API de Directions:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

Con la API de Routes, pasas parámetros en el cuerpo de una solicitud o en encabezados como parte de una solicitud HTTP POST. Para ver ejemplos, consulta lo siguiente:

Cómo convertir puntos de referencia codificados en polilíneas en puntos de referencia de ubicación

La especificación de puntos de referencia como polilíneas codificadas está disponible en la API de Directions para adaptarse a una la cantidad de puntos de referencia y el límite de la URL es de 16,384 caracteres. Esta función no es necesario en la API de Routes porque los puntos de referencia se pueden transmitir en la Cuerpo de la solicitud de REST o gRPC como coordenadas de latitud y longitud Por ejemplo: consulta la Ejemplo de HTTP en el documento Calcula una matriz de rutas, o Define un punto de referencia intermedio en el documento Especificar puntos de referencia intermedios.

Convertir parámetros

En la siguiente tabla, se enumeran los parámetros del la API de Directions y de Distance Matrix que tienen cambiaron o les cambiaron el nombre, o bien parámetros que no se admiten en la versión de DG lanzamiento. Actualiza el código si usas alguno de estos parámetros.

Solicita conversiones de parámetros

Parámetro de Directions o Distance matrix Parámetro de la API de Routes Notas
alternatives computeAlternativeRoutes
arrival_time arrivalTime Disponible solo en el modo TRANSIT, no en el mismo modo vez como departureTime.
avoid routeModifiers
departure_time departureTime No se puede usar al mismo tiempo que arrivalTime.
language languageCode Solo es compatible con Compute Routes.
mode travelMode

Se agregó compatibilidad con TWO_WHEELER y TRANSIT
region regionCode
traffic_model trafficModel Más información
transit_mode "travelMode": "TRANSIT" En la API de Directions, en una ruta de transporte público, cada tramo de un viaje con el mismo medio de transporte (por ejemplo, A pie o Transporte público) se considera un paso, y las indicaciones individuales para que el medio de transporte están en subpasos. Por el contrario, en la API de Routes, los pasos son siempre una instrucción de navegación en todos los tipos de viajes. Por lo tanto, cada instrucción de navegación es un paso. Para varios pasos en un medio de transporte, la API de Routes proporciona metadatos que contienen un resumen de los pasos para ese medio de transporte, en `stepsOverview`. Para solicitar estos metadatos, usa el Máscara de campo “routes.legs.stepsOverview”. Obtén más información.
transit_routing_preference transitRoutingPreference Más información
units No está disponible para la matriz de rutas.
waypoints intermediates Se quitó la compatibilidad con las polilíneas codificadas.
optimize=true para puntos de referencia "optimizeWaypointOrder": "true" Más información

Conversiones del parámetro de respuesta

Parámetro de Directions o Distance matrix Parámetro de la API de Routes Notas
copyrights

No se incluye en la respuesta. Debes incluir lo siguiente: cuando muestres los resultados a tus usuarios:

Powered by Google, ©YEAR Google

Por ejemplo:

Powered by Google, ©2022 Google
distance distanceMeters La distancia solo está disponible en metros.
duration_in_traffic duration Se quitó de la API de Routes, usa duration.
status No disponible. Usa los códigos de respuesta HTTP para los errores informados por la API. Consulta Cómo solucionar errores de solicitud. para obtener más información.
geocoded_waypoints geocoding_results Solo es compatible con Compute Routes. Contiene información de respuestas de geocodificación solo para puntos de referencia especificados como direcciones.
bounds viewport
legs.end_address No disponible.
legs.start_address No disponible.
overview_polyline polilínea
summary description
waypoint_order optimizedIntermediateWaypointIndex