Effectuer une migration depuis la version Preview

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 en disponibilité générale

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 lieu et des coordonnées de latitude/longitude, vous pouvez désormais spécifier un lieu dans la version en disponibilité générale à l'aide des éléments suivants:

    • Chaînes d'adresse ("Chicago, Illinois" ou "Darwin, NT, Australie")

      Les chaînes d'adresse permettent souvent à un utilisateur de saisir une adresse. Cependant, {product_name} doit d'abord géocoder la chaîne d'adresse en interne pour la convertir en coordonnées de latitude/longitude avant de pouvoir calculer un itinéraire.

      En outre, le paramètre de requête regionCode a été ajouté, ce qui vous permet de spécifier qu'il faut renvoyer des résultats géocodés pour une région géographique spécifique.

    • Plus Codes

      Les Plus Codes sont comme des adresses postales de personnes ou de lieux qui n'ont pas d'adresse réelle. Au lieu des adresses avec des noms et des numéros de rue, les Plus Codes sont basés sur la latitude et la longitude, et s'affichent sous forme de chiffres et de lettres.

  • La réponse de calcul des routes contient maintenant le tableau geocodingResults. Pour chaque emplacement de la requête (point de départ, destination ou point de cheminement intermédiaire) spécifié en tant que chaîne d'adresse ou Plus code, l'API effectue une recherche d'ID de lieu. Chaque élément de ce tableau contient l'ID de lieu correspondant à un lieu, ainsi que des métadonnées supplémentaires sur le lieu. Les emplacements spécifiés dans la requête en tant qu'ID de lieu ou en tant que coordonnées de latitude/longitude sont ignorés.

Modifications apportées aux fonctionnalités en preview

Vous devez maintenant activer explicitement les fonctionnalités suivantes en disponibilité générale en ajoutant le nouveau champ de tableau extraComputations à la requête:

Dans la version preview, vous avez utilisé un masque de champ pour indiquer qu'il doit renvoyer des informations sur ces fonctionnalités dans la réponse. À présent, vous devez effectuer les deux opérations suivantes:

  • Définissez le nouveau paramètre de requête de tableau extraComputations pour activer ces fonctionnalités.
  • Définissez un masque de champ à spécifier pour renvoyer les informations dans la réponse.

Que dois-je savoir ?

Les champs suivants ne seront plus inclus dans les réponses de computeRouteMatrix, sauf s'ils sont explicitement activés en définissant extraComputations:

  • travelAdvisory.tollInfo (infos 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(infos sur les péages)
  • routes.travelAdvisory.tollInfo(infos 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 pour les informations sur les péages, la consommation de carburant ou le trafic sur une polyligne, vous devez définir le nouveau champ du tableau de requêtes, extraComputations, de manière à inclure une ou plusieurs des valeurs suivantes: