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 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 correspondent souvent à la façon dont un utilisateur saisit une adresse. Toutefois, {product_name} doit d'abord géocoder la chaîne d'adresse en interne afin de la convertir en coordonnées de latitude/longitude avant de pouvoir calculer un itinéraire.

      En outre, le paramètre de requête regionCode est désormais compatible, ce qui vous permet de spécifier le renvoi des résultats géocodés pour une région géographique spécifique.

    • Plus Codes

      Les Plus Codes sont comme les adresses postales de personnes ou de lieux qui n'ont pas d'adresse réelle. Au lieu d'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 désormais 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 celui-ci. Les lieux 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 Preview existantes

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

Dans la version preview, vous avez utilisé un masque de champ pour spécifier dans la réponse des informations sur ces fonctionnalités. Vous devez à la fois effectuer les 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 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 du tableau de requêtes, extraComputations, pour inclure une ou plusieurs des valeurs suivantes: