Effectuer une migration depuis la version Preview
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Développeurs de l'Espace économique européen (EEE)
L'API Routes a été publiée en version Preview publique (pré-DG) en septembre 2022. Les offres en pré-DG sont couvertes par les Conditions spécifiques du service Google Maps Platform.
Pour en savoir plus, consultez les descriptions des étapes de lancement.
Cette section explique comment migrer une application de la version Preview vers la version en disponibilité générale.
Nouvelles fonctionnalités ajoutées à la version disponible dans le commerce
La version en disponibilité générale ajoute les nouvelles fonctionnalités suivantes qui n'étaient pas incluses dans la version Preview :
En plus des ID de lieux et des coordonnées de latitude/longitude, vous pouvez désormais spécifier un lieu dans la version GA à l'aide des éléments suivants :
Chaînes d'adresse ("Chicago, IL" ou "Darwin, NT, Australie")
Les chaînes d'adresse sont souvent utilisées par les utilisateurs pour saisir une adresse. Toutefois, {product_name} doit d'abord géocoder la chaîne d'adresse en interne pour la convertir en coordonnées de latitude et de longitude avant de pouvoir calculer un itinéraire.
De plus, la compatibilité avec le paramètre de requête regionCode a été ajoutée. Il vous permet de spécifier de renvoyer les résultats géocodés pour une région géographique spécifique.
Codes Plus
Les Plus Codes fonctionnent comme des adresses postales pour les personnes ou les lieux qui n'en ont pas. Contrairement aux adresses avec des noms et des numéros de rue, ils sont basés sur la latitude et la longitude, et sont affichés sous forme de numéros et de lettres.
La réponse de calcul des itinéraires contient désormais le tableau geocodingResults. Pour chaque lieu de la requête (origine, destination ou point de cheminement intermédiaire) spécifié sous la forme d'une chaîne d'adresse ou d'un plus code, l'API effectue une recherche d'ID de lieu. Chaque élément de ce tableau contient l'ID de lieu correspondant à un établissement, ainsi que des métadonnées supplémentaires le concernant. Les lieux de la requête spécifiés sous forme d'ID de lieu ou de coordonnées de latitude/longitude sont ignorés.
Modifications apportées aux fonctionnalités d'aperçu existantes
Vous devez désormais activer explicitement les fonctionnalités suivantes dans la version GA en ajoutant le nouveau champ de tableau extraComputations à la requête :
Dans la version Preview, vous avez utilisé un masque de champ pour spécifier de renvoyer des informations pour ces fonctionnalités dans la réponse. Vous devez désormais :
- Définissez le nouveau paramètre de requête de tableau
extraComputations pour activer ces fonctionnalités.
- Définissez un masque de champ pour spécifier les informations à renvoyer dans la réponse.
Que dois-je savoir ?
Les champs suivants ne seront plus inclus dans les réponses computeRouteMatrix, sauf s'ils sont explicitement activés en définissant extraComputations :
travelAdvisory.tollInfo (informations sur les péages)
Les champs suivants ne seront plus inclus dans les réponses computeRoutes, sauf s'ils sont explicitement activés en définissant extraComputations :
routes.legs.travelAdvisory.tollInfo(informations sur les péages)routes.travelAdvisory.tollInfo(informations sur les péages)routes.travelAdvisory.fuelConsumptionMicroliters(Consommation de carburant)routes.travelAdvisory.speedReadingIntervals(Trafic sur une polyligne)routes.legs.travelAdvisory.speedReadingIntervals(Trafic sur une polyligne)
Que dois-je faire ?
Pour recevoir les champs de réponse concernant les informations sur les péages, la consommation de carburant ou le trafic sur une polyligne, vous devez définir le nouveau champ de tableau de requête, extraComputations, pour inclure une ou plusieurs des valeurs suivantes :
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/22 (UTC).
[null,null,["Dernière mise à jour le 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\"`."]]
