La API de Routes se lanzó como una 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 están cubiertas 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:
Strings de dirección ("Chicago, IL" o "Darwin, NT, Australia")
A menudo, las cadenas de dirección son la forma en que un usuario ingresa una dirección. Sin embargo, {product_name} primero debe geocodificar internamente la string de dirección 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 si deseas que se muestren resultados geocodificados para una región geográfica específica.-
Los Plus Codes son como direcciones para 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 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 de la solicitud especificadas como ID de lugar o como coordenadas de latitud y longitud.
Cambios en las funciones de vista previa existentes
Ahora debes agregar el nuevo campo de array extraComputations a la solicitud para habilitar de forma explícita las siguientes funciones en la fase de disponibilidad general:
En la versión preliminar, usaste una máscara de campo para especificar que se muestre información de estas funciones en la respuesta. Ahora, debes cumplir con ambos requisitos:
- Establece el nuevo parámetro de solicitud de array
extraComputationspara habilitar estas funciones. - Establece una máscara de campo para especificar que 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 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 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é debo hacer?
Para 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:
Para recibir información de peajes, establece el nuevo campo de array
extraComputationsen"TOLLS".Para recibir el consumo de combustible, establece el nuevo campo de array
extraComputationsen"FUEL_CONSUMPTION".Para recibir información sobre el tráfico de las polilíneas, establece el nuevo campo de array
extraComputationsen"TRAFFIC_ON_POLYLINE".