En esta guía, se describe cómo migrar apps que usan la API de Directions o de Distance Matrix a la API de Routes. Para obtener detalles sobre la API de Routes, consulta Descripción general del producto.
Actualiza los extremos de la API de REST
Actualiza tu código para usar los extremos de la API de Routes nuevos.
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 parámetros de URL para usar un cuerpo de solicitud HTTPS
Con la API de Directions y la API 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 encabezados como parte de una solicitud HTTP POST
. Consulta los siguientes ejemplos:
Cómo convertir puntos de referencia representados como polilíneas codificadas en puntos de referencia intermedios
Puedes especificar puntos de referencia como polilíneas codificadas disponibles en la API de Directions para adaptarlo a una gran cantidad de puntos de referencia con un límite de 8,192 caracteres. Esta función no es necesaria en la API de Routes, ya que los puntos de referencia se pueden transmitir en el cuerpo de las solicitudes de REST o gRPC como puntos de referencia intermedios.
Convertir los parámetros existentes en parámetros de la API de Routes
En la siguiente tabla, se enumeran los parámetros de la API de Directions y de Distance Matrix a los que se les cambió el nombre o se modificaron, o los que no se admiten en la versión de DG. Actualiza tu código si usas alguno de estos parámetros.
Parámetro de rutas o matriz de distancia | Parámetro de la API de Routes | Notas |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
No está disponible porque el modo TRANSIT no está disponible. |
|
avoid |
routeModifiers |
|
copyrights |
No se incluye en la respuesta. Debes incluir la siguiente declaración cuando muestres los resultados a los usuarios:
Por ejemplo:
|
|
departure_time |
departureTime |
|
distance |
distanceMeters |
La distancia solo está disponible en metros. |
duration_in_traffic |
|
Se quitó de la API de Routes y usa duration . Para obtener más información, consulta los cambios de funcionalidad de la nueva API de Routes más arriba. |
language |
languageCode |
Solo es compatible con las rutas de Compute. |
mode |
travelMode |
Se agregó compatibilidad para El modo |
region |
regionCode |
|
status |
No disponible. Usa los códigos de respuesta HTTP para los errores informados por la API. Consulta Maneja errores de solicitud para obtener más información. | |
traffic_model |
No disponible. | |
transit_mode |
No está disponible porque el modo TRANSIT no está disponible. |
|
transit_routing_preference |
No está disponible porque el modo TRANSIT no está disponible. |
|
units |
No está disponible para la matriz de ruta. | |
waypoints |
intermediates |
Se quitó la compatibilidad con polilíneas codificadas. |
optimize=true para puntos de referencia |
No disponible. |