Effectuer une migration depuis la version Preview

Développeurs de l'Espace économique européen (EEE)

L'API Routes a été lancé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 Terms. 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 DG.

Nouvelles fonctionnalités ajoutées à la version DG

La version DG 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 DG à l'aide des éléments suivants :

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

      Les chaînes d'adresse sont 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 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 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 compute routes contient désormais le tableau geocodingResults. Pour chaque emplacement de la requête (point de cheminement de départ, de destination ou intermédiaire) que vous avez 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 emplacement, ainsi que des métadonnées supplémentaires sur l'emplacement. Les emplacements 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 Preview existantes

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

Dans la version Preview, vous utilisiez un masque de champ pour spécifier de renvoyer des informations sur ces fonctionnalités dans la réponse. Vous devez désormais 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 pour spécifier de 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 de tableau de requête, extraComputations, pour inclure une ou plusieurs des valeurs suivantes :