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

Desarrolladores del Espacio Económico Europeo (EEE)

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 Términos. 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 GA.

Nuevas funciones agregadas a la versión de GA

La versión de GA 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 GA con 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 de forma interna 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, 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 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 geocodingResults array. Para cada ubicación de la solicitud (origen, destino o punto de ruta 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 existentes de la versión preliminar

Ahora debes habilitar explícitamente las siguientes funciones en la versión de GA agregando el nuevo campo de array extraComputations a la solicitud:

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

  • Establecer el nuevo parámetro de solicitud de array extraComputations para habilitar estas funciones
  • Establecer una máscara de campo para especificar que se muestre 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 estableciendo 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 explícitamente estableciendo 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 información sobre peajes, consumo de combustible o tráfico en una polilínea, debes establecer el nuevo campo de array de solicitud, extraComputations, para incluir uno o más de los siguientes valores: