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 GA.

Nouvelles fonctionnalités ajoutées à la version GA

La version GA 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 emplacement dans la version GA à l'aide des éléments suivants:

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

      Les chaînes d'adresses 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/longitude avant de pouvoir calculer un itinéraire.

      De plus, la prise en charge du paramètre de requête regionCode a été ajoutée. Elle vous permet de spécifier de renvoyer des résultats géocodés pour une région géographique spécifique.

    • Plus Codes

      Les Plus Codes fonctionnent comme des adresses postales pour les personnes ou les lieux qui n'en ont pas. Contrairement aux adresses postales qui contiennent des noms et des numéros de rue, les Plus Codes sont basés sur la latitude et la longitude, et présentés 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 (origine, destination ou point de cheminement intermédiaire) spécifié en tant que chaîne d'adresse ou en tant que 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 sur l'établissement. Les emplacements de la requête spécifiés 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 désormais activer explicitement les fonctionnalités suivantes dans la 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 maintenant:

  • 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 si vous les activez explicitement 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 pour 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: