En esta guía, se describe cómo migrar apps que usan la API de Directions o la de Distance Matrix a la API de Routes. Para obtener detalles sobre la API de Routes, consulta la descripción general del producto.
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, puedes pasar propiedades de configuración como parámetros de URL a una solicitud HTTP GET
. Por 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 los encabezados como parte de una solicitud HTTP POST
. Para ver ejemplos, consulta los siguientes vínculos:
Cómo convertir puntos de referencia codificados con 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 ajustarse a una gran cantidad de puntos de referencia en el límite de 16,384 caracteres de la URL. Esta función no es necesaria en la API de Routes, ya que los puntos de referencia se pueden transmitir en el cuerpo de la solicitud de REST o gRPC como coordenadas de latitud y longitud. Para ver ejemplos, consulta el ejemplo de HTTP en el documento Calcula una matriz de ruta o Define un punto de referencia intermedio en el documento Especifica puntos de referencia intermedios.
Cómo convertir parámetros
En las siguientes tablas, se enumeran los parámetros de las APIs de Directions y de Distance Matrix a los que se les cambió el nombre o los que se modificaron, o bien aquellos que no son compatibles con la versión de Google Analytics. Actualiza tu código si usas alguno de estos parámetros.
Conversiones de parámetros de solicitud
Parámetro de Directions o Distance Matrix | Parámetro de la API de Routes | Notas |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Disponible únicamente en el modo TRANSIT y no al mismo tiempo que departureTime . |
avoid |
routeModifiers |
|
departure_time |
departureTime |
No se puede usar al mismo tiempo que arrivalTime . |
language |
languageCode |
Solo es compatible con rutas de procesamiento. |
mode |
travelMode |
Se agregó compatibilidad con |
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 segmento de un viaje con el mismo medio de transporte (por ejemplo, a pie o en transporte público) se considera un paso, y las instrucciones individuales para ese medio de transporte están en pasos secundarios. Por el contrario, en la API de Routes, los pasos son siempre una instrucción de navegación para todos los tipos de viaje. De modo que cada instrucción de navegación es un paso. Para varios pasos en un modo de viaje, la API de Routes proporciona metadatos que contienen un resumen de los pasos para ese medio de viaje en `stepsOverview`. Para solicitar estos metadatos, usa la máscara de campo `routes.legs.stepsOverview`. 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 de parámetros de respuesta
Parámetro de Directions o Distance Matrix | Parámetro de la API de Routes | Notas |
---|---|---|
copyrights |
No se incluye en la respuesta. Cuando muestres los resultados a los usuarios, debes incluir la siguiente declaración:
Por ejemplo:
|
|
distance |
distanceMeters |
La distancia solo está disponible en metros. |
duration_in_traffic |
duration |
Si se quita de la API de Routes, usa duration . |
status |
No disponible. Usa los códigos de respuesta HTTP para los errores que informa la API. Consulta Cómo solucionar errores de solicitud para obtener más información. | |
geocoded_waypoints |
geocoding_results |
Solo es compatible con rutas de procesamiento. Contiene información de respuestas de geocodificación únicamente 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 |