Cómo migrar desde la versión de vista previa
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Desarrolladores del Espacio Económico Europeo (EEE)
La API de Routes se lanzó como versión preliminar pública (pre-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 GA.
Nuevas funciones agregadas a la versión de GA
La versión de GA agrega las siguientes funciones nuevas que no se incluían 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 son la forma en que un usuario suele ingresar 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.
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 la longitud, y se muestran en forma de números y letras.
La respuesta de rutas de cálculo ahora contiene el array geocodingResults. Para cada ubicación de la solicitud (origen, destino o parada intermedia) que se especificó como una cadena de dirección o como un código plus, la API realiza una búsqueda del 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 GA agregando el nuevo campo de array extraComputations a la solicitud:
En la versión preliminar, usaste una máscara de campo para especificar que se devolviera información sobre estas funciones en la respuesta. Ahora, debes hacer lo siguiente:
- Establece el nuevo parámetro de solicitud del 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 de peaje)
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 sobre peajes, el consumo de combustible o el tráfico en una polilínea, debes configurar el nuevo campo de array de la solicitud, extraComputations, para que incluya uno o más de los siguientes valores:
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-22 (UTC)
[null,null,["Última actualización: 2025-07-22 (UTC)"],[[["\u003cp\u003eThe Routes API has transitioned from Preview to General Availability (GA), introducing new features and changes to existing ones.\u003c/p\u003e\n"],["\u003cp\u003eYou can now specify locations using address strings and Plus Codes in addition to place IDs and coordinates.\u003c/p\u003e\n"],["\u003cp\u003eToll info, fuel consumption, and traffic on a polyline now require explicit enablement using the \u003ccode\u003eextraComputations\u003c/code\u003e field in requests.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egeocodingResults\u003c/code\u003e array has been added to the response, providing place IDs and metadata for locations specified as address strings or Plus Codes.\u003c/p\u003e\n"],["\u003cp\u003eExisting implementations relying on implicit inclusion of toll info, fuel consumption, or traffic on a polyline data need to be updated to utilize the \u003ccode\u003eextraComputations\u003c/code\u003e field.\u003c/p\u003e\n"]]],["The Routes API's GA release introduces new location specification options, including address strings and Plus Codes, and includes a `geocodingResults` array in the response. To enable toll info, fuel consumption, and traffic on a polyline, users must now set the `extraComputations` array in their requests. `extraComputations` values are \"TOLLS\", \"FUEL_CONSUMPTION\", and \"TRAFFIC_ON_POLYLINE\". The field mask must still be used. Certain fields will be omitted in the response unless enabled by `extraComputations`.\n"],null,["# Migrate from the Preview release\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Routes API was released as a public Preview (pre-GA) in September of\n2022. Pre-GA Offerings are covered by the [Google Maps Platform Service Specific\nTerms](https://cloud.google.com/maps-platform/terms/maps-service-terms).\nFor more information, see the [launch stage descriptions](/maps/launch-stages).\n\nThis section describes how to migrate an app from the Preview release to the GA\nrelease.\n\nNew features added to the GA release\n------------------------------------\n\nThe GA release adds the following new features that were not included in the\nPreview:\n\n- Along with place IDs and latitude/longitude coordinates, you can now\n [specify a location](/maps/documentation/routes/specify_location) in the GA release by using:\n\n - [Address strings](/maps/documentation/routes/specify_location#text_string) (\"Chicago, IL\" or\n \"Darwin, NT, Australia\")\n\n Address strings are often how a user inputs an address. However,\n {product_name} must first geocode the address string internally to convert\n it to latitude/longitude coordinates before it can calculate a route.\n\n In addition, support for the `regionCode` request parameter has been\n added, which lets you specify to return geocoded results for a specific\n geographic region.\n - [Plus Codes](/maps/documentation/routes/specify_location#plus_code)\n\n Plus Codes are like street addresses for people or places that don't\n have an actual address. Instead of addresses with street names and\n numbers, Plus Codes are based on latitude and longitude, and are\n displayed as numbers and letters.\n- The [compute routes response](/maps/documentation/routes/understand-route-response) now contains the\n `geocodingResults` array. For every location in the request (origin,\n destination, or intermediate waypoint) that was specified as an **address\n string** or as a **Plus code**, the API performs a place ID lookup. Each\n element of this array contains the place ID corresponding to a location\n along with additional metadata about the location. Locations in the request\n specified as a place ID or as latitude/longiiture coordinates are ignored.\n\nChanges to existing Preview features\n------------------------------------\n\nYou must now explicitly enable the following features in the GA by\nadding the new array `extraComputations` field to the request:\n\n- [Toll info](/maps/documentation/routes/calculate_toll_fees)\n\n- [Fuel consumption](/maps/documentation/routes/eco-routes)\n\n- [Traffic on a polyline](/maps/documentation/routes/traffic_on_polylines)\n\nIn the Preview release, you used a [field mask](/maps/documentation/routes/choose_fields) to specify to\nreturn information for these features in the response. Now, you must both:\n\n- Set the new `extraComputations` array request parameter to enable these features.\n- Set a field mask to specify to return the information in the response.\n\n### What do I need to know?\n\nThe following fields will no longer be included in\n[computeRouteMatrix responses](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRouteMatrix#response-body)\nunless explicitly enabled by setting `extraComputations`:\n\n- `travelAdvisory.tollInfo` (Toll info)\n\nThe following fields will no longer be included in\n[computeRoutes responses](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#response-body)\nunless explicitly enabled by setting `extraComputations`:\n\n- `routes.legs.travelAdvisory.tollInfo`(Toll info)\n- `routes.travelAdvisory.tollInfo`(Toll info)\n- `routes.travelAdvisory.fuelConsumptionMicroliters`(Fuel consumption)\n- `routes.travelAdvisory.speedReadingIntervals`(Traffic on a polyline)\n- `routes.legs.travelAdvisory.speedReadingIntervals`(Traffic on a polyline)\n\n### What do I need to do?\n\nTo receive the response fields for toll info, fuel consumption, or traffic on a\npolyline, you must set the new request array field, `extraComputations`, to\ninclude one or more of the following values:\n\n- To receive [toll info](/maps/documentation/routes/calculate_toll_fees), set the new\n `extraComputations` array field to `\"TOLLS\"`.\n\n- To receive [fuel consumption](/maps/documentation/routes/eco-routes), set the new `extraComputations`\n array field to `\"FUEL_CONSUMPTION\"`.\n\n- To receive [traffic information on polylines](/maps/documentation/routes/traffic_on_polylines), set the\n new `extraComputations` array field to `\"TRAFFIC_ON_POLYLINE\"`."]]
