Migrar da versão de pré-lançamento
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Desenvolvedores do Espaço Econômico Europeu (EEE)
A API Routes foi lançada como uma prévia pública (pré-GA) em setembro de 2022. As Soluções pré-GA são cobertas pelos Termos de Serviço específicos da Plataforma Google Maps.
Para mais informações, consulte as
descrições da fase de lançamento.
Esta seção descreve como migrar um app da versão de prévia para a versão GA.
Novos recursos adicionados à versão GA
A versão GA adiciona os seguintes recursos que não estavam incluídos na
prévia:
Além dos IDs de lugar e das coordenadas de latitude/longitude, agora é possível especificar um local na versão GA usando:
Strings de endereço ("Chicago, IL" ou "Darwin, NT, Austrália")
Geralmente, é assim que um usuário insere um endereço. No entanto, o {product_name} precisa primeiro geocodificar a string de endereço internamente para convertê-la em coordenadas de latitude/longitude antes de calcular um trajeto.
Além disso, foi adicionado suporte ao parâmetro de solicitação regionCode, que permite especificar o retorno de resultados geocodificados para uma região geográfica específica.
Plus Codes
O Plus Code é como um endereço para pessoas ou lugares que não têm um endereço físico. Em vez de nomes de rua e números, os Plus Codes têm como base a latitude e a longitude e são exibidos como números e letras.
A resposta de rotas de computação agora contém a matriz
geocodingResults. Para cada local na solicitação (origem, destino ou ponto de parada intermediário) especificado como uma string de endereço ou um plus code, a API realiza uma pesquisa de ID de lugar. Cada
elemento dessa matriz contém o ID do lugar correspondente a um local
junto com metadados adicionais sobre o local. Os locais na solicitação especificados como um ID de lugar ou como coordenadas de latitude/longitude são ignorados.
Mudanças nos recursos de prévia atuais
Agora você precisa ativar explicitamente os seguintes recursos no GA adicionando o novo campo de matriz extraComputations à solicitação:
Na versão prévia, você usou uma máscara de campo para especificar que
as informações desses recursos fossem retornadas na resposta. Agora, você precisa fazer o seguinte:
- Defina o novo parâmetro de solicitação de matriz
extraComputations para ativar esses
recursos.
- Defina uma máscara de campo para especificar as informações a serem retornadas na resposta.
O que preciso saber?
Os campos a seguir não serão mais incluídos nas respostas de computeRouteMatrix, a menos que sejam explicitamente ativados definindo extraComputations:
travelAdvisory.tollInfo (informações de pedágio)
Os campos a seguir não serão mais incluídos nas
respostas de computeRoutes
a menos que sejam ativados explicitamente definindo extraComputations:
routes.legs.travelAdvisory.tollInfo(Informações de pedágio)routes.travelAdvisory.tollInfo(Informações de pedágio)routes.travelAdvisory.fuelConsumptionMicroliters(Consumo de combustível)routes.travelAdvisory.speedReadingIntervals(tráfego em uma polilinha)routes.legs.travelAdvisory.speedReadingIntervals(tráfego em uma polilinha)
O que eu preciso fazer?
Para receber os campos de resposta com informações de pedágio, consumo de combustível ou trânsito em uma polilinha, defina o novo campo de matriz de solicitação, extraComputations, para incluir um ou mais dos seguintes valores:
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-22 UTC.
[null,null,["Última atualização 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\"`."]]
