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

La API de Routes se lanzó como versión preliminar pública (antes de la versión GA) 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 actualización.

Nuevas funciones agregadas a la versión de GA

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

  • Además de los IDs de lugar y las coordenadas de latitud y longitud, ahora puedes especificar una ubicación en la versión GA con lo siguiente:

    • Cadena de direcciones ("Chicago, IL" o "Darwin, NT, Australia")

      A menudo, las cadenas de direcciones son la forma en que un usuario ingresa una dirección. Sin embargo, {product_name} primero debe geocodificar la cadena de dirección de forma interna 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.

    • Códigos Plus

      Los Plus Codes son como direcciones para las personas o los 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 en forma de números y letras.

  • La respuesta de Compute Routes ahora contiene el array geocodingResults. Para cada ubicación de la solicitud (origen, destino o punto de referencia intermedio) que se especificó como una cadena de dirección o como un código plus, 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 un ID de lugar o como coordenadas de latitud y longitud.

Cambios en las funciones de la versión preliminar existentes

Ahora debes habilitar explícitamente las siguientes funciones en GA. Para ello, debes agregar el nuevo campo extraComputations del array a la solicitud:

En la versión preliminar, usaste una máscara de campo para especificar que se devolviera información para estas funciones en la respuesta. Ahora, debes hacer lo siguiente:

  • Establece el nuevo parámetro de solicitud de array extraComputations para habilitar estas funciones.
  • Establece una máscara de campo para especificar que se devuelva 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 de forma explícita configurando extraComputations:

  • travelAdvisory.tollInfo (información sobre peajes)

Los siguientes campos ya no se incluirán en las respuestas de computeRoutes, a menos que se habiliten de forma explícita configurando extraComputations:

  • routes.legs.travelAdvisory.tollInfo(Información sobre peajes)
  • routes.travelAdvisory.tollInfo(Información sobre peajes)
  • 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é debo hacer?

Para recibir los campos de respuesta de la información de peajes, el consumo de combustible o el tráfico en un polilinea, debes configurar el nuevo campo de array de solicitudes, extraComputations, para que incluya uno o más de los siguientes valores: