Cómo migrar desde la versión de vista previa

La API de Routes se lanzó como versión preliminar pública (fase previa a la DG) en septiembre de 2022. Las ofertas que se encuentran en la fase previa a la DG se rigen por las Condiciones Específicas del Servicio de Google Maps Platform. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta sección, se describe cómo migrar una app de la versión preliminar a la versión de DG.

Nuevas funciones agregadas a la versión de DG

La versión de DG agrega las siguientes funciones nuevas que no se incluyeron en la Versión preliminar:

  • Junto con los IDs de lugar y las coordenadas de latitud y longitud, ahora puedes especificar una ubicación en la versión de DG mediante lo siguiente:

    • Cadenas de dirección ("Chicago, IL" o "Darwin, NT, Australia")

      Las cadenas de dirección suelen ser la forma en que un usuario ingresa una dirección. Sin embargo, {product_name} primero debe geocodificar la cadena de dirección internamente para convertirla en coordenadas de latitud y longitud antes de poder calcular una ruta.

      Además, se agregó compatibilidad con el parámetro de solicitud regionCode, que te permite especificar que se muestren resultados geocodificados para una región geográfica específica.

    • Plus Codes

      Los Plus Codes son como direcciones de personas o lugares que no tienen una dirección real. En lugar de direcciones con nombres de calles y números, los Plus Codes se basan en la latitud y longitud, y se muestran como números y letras.

  • La respuesta de rutas de procesamiento ahora contiene el array geocodingResults. Para cada ubicación en la solicitud (origen, destino o punto de referencia intermedio) que se especificó como una string de dirección o como un Plus Code, la API realiza una búsqueda de ID de lugar. Cada elemento de este array contiene el ID de lugar correspondiente a una ubicación junto con metadatos adicionales sobre la ubicación. Se ignoran las ubicaciones de la solicitud especificadas como ID de lugar o como coordenadas de latitud y longitud.

Cambios en las funciones existentes de la versión preliminar

Ahora debes habilitar explícitamente las siguientes funciones en la versión de DG. Para ello, agrega el nuevo campo extraComputations de array a la solicitud:

En la versión preliminar, se usó una máscara de campo para especificar que se mostrara información de estas funciones en la respuesta. Ahora, debes cumplir con ambos requisitos:

  • Establece el nuevo parámetro de solicitud de array extraComputations para habilitar estas funciones.
  • Establece una máscara de campo para especificar que se mostrará la información en la respuesta.

¿Qué debo saber?

Los siguientes campos ya no se incluirán en las respuestas de computeRouteMatrix, a menos que se habiliten explícitamente mediante la configuración de extraComputations:

  • travelAdvisory.tollInfo (información de peajes)

Los siguientes campos ya no se incluirán en las respuestas de computeRoutes, a menos que se habiliten explícitamente mediante la configuración de extraComputations:

  • routes.legs.travelAdvisory.tollInfo(Información de peaje)
  • routes.travelAdvisory.tollInfo(Información de peaje)
  • routes.travelAdvisory.fuelConsumptionMicroliters(Consumo de combustible)
  • routes.travelAdvisory.speedReadingIntervals(Tráfico en una polilínea)
  • routes.legs.travelAdvisory.speedReadingIntervals(Tráfico en una polilínea)

¿Qué tengo que hacer?

Si quieres recibir los campos de respuesta sobre la información de peajes, consumo de combustible o tráfico en una polilínea, debes configurar el nuevo campo de array de solicitudes, extraComputations, para incluir uno o más de los siguientes valores: