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

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:

Powered by Google, ©YEAR Google

Por ejemplo:

Powered by Google, ©2022 Google

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 TWO_WHEELER.

El modo TRANSIT no está disponible.

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.