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 de los Servicios 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

En la versión de DG, se agregan 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 de DG con lo siguiente:

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

      A menudo, las cadenas de dirección son la forma en que un usuario escribe 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 que pueda calcular una ruta.

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

    • Plus Codes

      Los Plus Codes son como las direcciones de 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 la 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 en la solicitud especificadas como un ID de lugar o como coordenadas de latitud y longitud.

Cambios en las funciones de vista previa existentes

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

En la versión preliminar, usaste una máscara de campo para especificar que se mostrara información de 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 que se especifique para 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 de forma explícita mediante la configuración de extraComputations:

  • travelAdvisory.tollInfo (información de peaje)

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

  • routes.legs.travelAdvisory.tollInfo(Información de peajes)
  • routes.travelAdvisory.tollInfo(Información de 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 una polilínea, debes configurar el nuevo campo de array de solicitud, extraComputations, para incluir uno o más de los siguientes valores: