Démo de l'ancienne API Directions

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

Cette démonstration vous montre comment utiliser l'API Directions (ancienne) pour obtenir un itinéraire en voiture d'un point à un autre. Vous pouvez exécuter cette démonstration sans frais. L'exécution de cette démonstration seule ne dépasse pas votre quota mensuel.

Avant de commencer

Pour utiliser l'API Directions (ancienne version), suivez les étapes de configuration requises ci-dessous :

Étape 1 : Configurez votre projet

Console

  1. Dans la console Google Cloud, sur la page de sélection du projet, cliquez sur Créer un projet pour commencer à créer un projet Cloud.

    Accéder à la page du sélecteur de projet

  2. Assurez-vous que la facturation est activée pour votre projet Cloud. Vérifier si la facturation est activée sur un projet

    Vous pouvez tester Google Cloud sans frais. La période d'essai expire au bout de 90 jours ou après que le compte a enregistré 300 $ de frais (selon la première échéance atteinte). Vous pouvez résilier à tout moment. Pour en savoir plus, consultez Crédits de compte de facturation et Facturation.

SDK Cloud

gcloud projects create "PROJECT"

En savoir plus sur le SDK Google Cloud, l'installation du SDK Cloud et les commandes suivantes :

Étape 2 : Activez les API ou les SDK

Pour utiliser Google Maps Platform, vous devez activer les API ou les SDK que vous prévoyez d'utiliser avec votre projet.

Console

Activer l'API Directions (ancienne version)

SDK Cloud

gcloud services enable \
    --project "PROJECT" \
    "directions-backend.googleapis.com"

En savoir plus sur le SDK Google Cloud, l'installation du SDK Cloud et les commandes suivantes :

Étape 3 : Obtenez une clé API

Cette étape concerne uniquement le processus de création de la clé API. Si vous utilisez votre clé API en production, nous vous recommandons vivement de la restreindre. Vous trouverez plus d'informations sur la page Utiliser des clés API spécifique au produit.

Une clé API est un identifiant unique qui permet d'authentifier les requêtes associées à votre projet à des fins d'utilisation et de facturation. Vous devez associer au moins une clé API à votre projet. Pour créer une clé ou ajouter une API ou un SDK à une clé existante, suivez ces instructions.

Console

  1. Accédez à la page Google Maps Platform > Clés et identifiants.

    Accéder à la page "Clés et identifiants"

  2. Si vous y êtes invité, sélectionnez votre projet.

  3. Effectuez l'une des opérations suivantes :

    • Créer une clé :

      1. Cliquez sur Créer des identifiants > Clé API.
      2. Dans le panneau Créer une clé API, ouvrez la liste Sélectionner des restrictions d'API.
      3. Effacez toutes les API dont cette clé n'a pas besoin et assurez-vous que l'API Directions reste sélectionnée.
      4. Cliquez sur Créer. Le panneau affiche votre nouvelle clé API.

    • Utiliser une clé existante :

      1. Cliquez sur le nom de la clé.
      2. Dans la liste Sélectionner des restrictions d'API, sélectionnez API Directions.
      3. Cliquez sur Enregistrer.

    La sélection d'une API ici ne l'active pas. Assurez-vous que l'API Directions est activée sur la page Bibliothèque d'API.

  4. Pour afficher la chaîne de clé ultérieurement, accédez à la page Clés et identifiants, puis cliquez sur Afficher la clé pour la clé.

Si la console ne correspond pas à ces étapes, consultez Créer une clé API et Ajouter des restrictions d'API dans la documentation Google Cloud.

SDK Cloud

Remplacez PROJECT_ID par l'ID de votre projet dans les commandes suivantes.

  • Créer une clé : exécutez la commande suivante et remplacez DISPLAY_NAME par le nom de la clé. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=directions-backend.googleapis.com

    En savoir plus sur le SDK Google Cloud, l'installation du SDK Cloud et les commandes suivantes :

  • Utiliser une clé existante : exécutez la commande suivante et remplacez KEY_ID par l'ID de la clé. L'option --append conserve les API que la clé autorise déjà. Sans cela, la commande les remplace.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=directions-backend.googleapis.com

    En savoir plus sur le SDK Google Cloud, l'installation du SDK Cloud et les commandes suivantes :

    L'ID de clé n'est pas la chaîne de clé ni le nom à afficher. Pour le trouver, exécutez gcloud services api-keys list --project="PROJECT_ID". L'ID correspond à la dernière partie du champ name : projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Pour afficher la chaîne de clé, exécutez gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Obtenir un itinéraire

Pour recevoir l'itinéraire en voiture de Disneyland à Universal Studios, Hollywood au format JSON, saisissez l'URL dans votre navigateur Web et remplacez YOUR_API_KEY par votre clé API :

https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood&key=YOUR_API_KEY

Vous devriez recevoir la réponse JSON suivante :

    {
       "geocoded_waypoints" : [
          {
             "geocoder_status" : "OK",
             "place_id" : "ChIJRVY_etDX3IARGYLVpoq7f68",
             "types" : [
                "bus_station",
                "transit_station",
                "point_of_interest",
                "establishment"
             ]
          },
          {
             "geocoder_status" : "OK",
             "partial_match" : true,
             "place_id" : "ChIJp2Mn4E2-woARQS2FILlxUzk",
             "types" : [ "route" ]
          }
       ],
       "routes" : [
          {
             "bounds" : {
                "northeast" : {
                   "lat" : 34.1330949,
                   "lng" : -117.9143879
                },
                "southwest" : {
                   "lat" : 33.8068768,
                   "lng" : -118.3527671
                }
             },
             "copyrights" : "Map data ©2016 Google",
             "legs" : [
                {
                   "distance" : {
                      "text" : "35.9 mi",
                      "value" : 57824
                   },
                   "duration" : {
                      "text" : "51 mins",
                      "value" : 3062
                   },
                   "end_address" : "Universal Studios Blvd, Los Angeles, CA 90068, USA",
                   "end_location" : {
                      "lat" : 34.1330949,
                      "lng" : -118.3524442
                   },
                   "start_address" : "Disneyland (Harbor Blvd.), S Harbor Blvd, Anaheim, CA 92802, USA",
                   "start_location" : {
                      "lat" : 33.8098177,
                      "lng" : -117.9154353
                   },

      ... Additional results shortened in this example[] ...


             "overview_polyline" : {
                "points" : "knjmEnjunUbKCfEA?_@]@kMBeE@qIIoF@wH@eFFk@WOUI_@?u@j@k@`@EXLTZHh@Y`AgApAaCrCUd@cDpDuAtAoApA{YlZiBdBaIhGkFrDeCtBuFxFmIdJmOjPaChDeBlDiAdD}ApGcDxU}@hEmAxD}[tt@yNb\\yBdEqFnJqB~DeFxMgK~VsMr[uKzVoCxEsEtG}BzCkHhKWh@]t@{AxEcClLkCjLi@`CwBfHaEzJuBdEyEhIaBnCiF|K_Oz\\
                {MdZwAbDaKbUiB|CgCnDkDbEiE|FqBlDsLdXqQra@kX|m@aF|KcHtLm@pAaE~JcTxh@w\\`v@gQv`@}F`MqK`PeGzIyGfJiG~GeLhLgIpIcE~FsDrHcFfLqDzH{CxEwAbBgC|B}F|DiQzKsbBdeA{k@~\\oc@bWoKjGaEzCoEzEwDxFsUh^wJfOySx[uBnCgCbCoFlDmDvAiCr@eRzDuNxC_EvAiFpCaC|AqGpEwHzFoQnQoTrTqBlCyDnGmCfEmDpDyGzGsIzHuZzYwBpBsC`CqBlAsBbAqCxAoBrAqDdDcNfMgHbHiPtReBtCkD|GqAhBwBzBsG~FoAhAaCbDeBvD_BlEyM``@uBvKiA~DmAlCkA|B}@lBcChHoJnXcB`GoAnIS~CIjFDd]A|QMlD{@jH[vAk@`CoGxRgPzf@aBbHoB~HeMx^eDtJ}BnG{DhJU`@mBzCoCjDaAx@mAnAgCnBmAp@uAj@{Cr@wBPkB@kBSsEW{GV}BEeCWyAWwHs@qH?
                cIHkDXuDn@mCt@mE`BsH|CyAp@}AdAaAtAy@lBg@pCa@jE]fEcBhRq@pJKlCk@hLFrB@lD_@xCeA`DoBxDaHvM_FzImDzFeCpDeC|CkExDiJrHcBtAkDpDwObVuCpFeCdHoIl\\uBjIuClJsEvMyDbMqAhEoDlJ{C|J}FlZuBfLyDlXwB~QkArG_AnDiAxC{G|OgEdLaE`LkBbEwG~KgHnLoEjGgDxCaC`BuJdFkFtCgCnBuClD_HdMqEzHcBpB_C|BuEzCmPlIuE|B_EtDeBhCgAdCw@rCi@|DSfECrCAdCS~Di@jDYhA_AlC{AxCcL`U{GvM_DjFkBzBsB`BqDhBaEfAsTvEmEr@iCr@qDrAiFnCcEzCaE~D_@JmFdGQDwBvCeErEoD|BcFjC}DbEuD~D`@Zr@h@?d@Wr@}@vAgCbEaHfMqA`Cy@dAg@bAO`@gCi@w@W"
             },
             "summary" : "I-5 N and US-101 N",
             "warnings" : [],
             "waypoint_order" : []
          }
       ],
       "status" : "OK"
    }

Félicitations ! Vous avez configuré et appelé l'API Directions (ancienne) pour recevoir un itinéraire.

Nettoyer

Vous pouvez supprimer votre projet Google Cloud. La facturation de toutes les ressources qu'il utilise sera ainsi interrompue.

  1. Dans la console Google Cloud, accédez à la page Gérer les ressources.

    Accéder à la page Gérer les ressources

  2. Si le projet que vous envisagez de supprimer est associé à une organisation, sélectionnez et développez la liste des organisations en haut de la page.
  3. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
  4. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Étapes suivantes

  • Commencez à développer avec l'API Directions (ancienne version) en configurant votre projet Google Cloud :

    Configurer dans la console Cloud

  • Pour obtenir la liste de tous les paramètres lors de la création de votre requête HTTP API Directions (ancienne version) :

    Obtenir un itinéraire

  • Découvrez comment coder avec nos bibliothèques clientes, qui fournissent des implémentations natives simples de tâches courantes telles que l'authentification, la limitation des requêtes et les nouvelles tentatives automatiques. L'API Directions (ancienne) est disponible dans les clients Java, Python, Go et Node.js pour les services Google Maps.