Demo der Directions API (Legacy)

Entwickler im Europäischen Wirtschaftsraum (EWR)

In dieser Demo wird gezeigt, wie Sie mit der Directions API (Legacy) eine Wegbeschreibung von einem Ort zu einem anderen abrufen. Sie können diese Demo kostenlos ausführen. Wenn Sie nur diese Demo ausführen, wird Ihr monatliches Kontingent nicht überschritten.

Hinweis

Führen Sie die folgenden erforderlichen Einrichtungsschritte aus, um die Directions API (Legacy) zu verwenden:

Schritt 1: Projekt einrichten

Console

  1. Klicken Sie in der Google Cloud Console auf der Seite für die Projektauswahl auf Projekt erstellen, um ein neues Cloud-Projekt einzurichten.

    Zur Projektauswahl

  2. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. Das können Sie hier überprüfen.

    Google Cloud bietet einen kostenlosen Testzeitraum. Dieser endet entweder nach 90 Tagen oder wenn im Konto Kosten in Höhe von 300 $ angefallen sind – je nachdem, welcher Fall zuerst eintritt. Eine Kündigung ist jederzeit möglich. Weitere Informationen finden Sie unter Guthaben auf dem Rechnungskonto und Abrechnung.

Cloud SDK

gcloud projects create "PROJECT"

Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

Schritt 2: APIs oder SDKs aktivieren

Damit Sie die Google Maps Platform verwenden können, müssen Sie die APIs und SDKs aktivieren, die Sie in Ihrem Projekt nutzen möchten.

Console

Directions API (Legacy) aktivieren

Cloud SDK

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

Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

Schritt 3: API-Schlüssel anfordern

Dieser Schritt behandelt nur die Erstellung des API-Schlüssels. Wenn Sie Ihren API-Schlüssel in der Produktionsumgebung verwenden, sollten Sie ihn außerdem unbedingt einschränken. Weitere Informationen zur Vorgehensweise finden Sie auf der Seite API-Schlüssel verwenden.

Der API-Schlüssel ist eine eindeutige Kennung. Damit werden die mit Ihrem Projekt verknüpften Anfragen zu Nutzungs- und Abrechnungszwecken authentifiziert. Mit Ihrem Projekt muss mindestens ein API-Schlüssel verknüpft sein. Folgen Sie dieser Anleitung, um einen neuen Schlüssel zu erstellen oder eine API oder ein SDK zu einem vorhandenen Schlüssel hinzuzufügen.

Console

  1. Rufen Sie die Seite Google Maps Platform > Schlüssel und Anmeldedaten auf.

    Zur Seite „Schlüssel und Anmeldedaten“

  2. Wählen Sie bei Aufforderung Ihr Projekt aus.

  3. Führen Sie einen der folgenden Schritte aus:

    • Neuen Schlüssel erstellen:

      1. Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
      2. Öffnen Sie im Bereich API-Schlüssel erstellen die Liste API-Einschränkungen auswählen.
      3. Entfernen Sie alle APIs, die für diesen Schlüssel nicht erforderlich sind, und achten Sie darauf, dass die Directions API ausgewählt bleibt.
      4. Klicken Sie auf Erstellen. Im Bereich wird der neue API-Schlüssel angezeigt.

    • Vorhandenen Schlüssel verwenden:

      1. Klicken Sie auf den Namen des Schlüssels.
      2. Wählen Sie in der Liste API-Einschränkungen auswählen die Option Directions API aus.
      3. Klicken Sie auf Speichern.

    Wenn Sie hier eine API auswählen, wird sie nicht aktiviert. Prüfen Sie, ob die Directions API auf der Seite „API-Bibliothek“ aktiviert ist.

  4. Wenn Sie den Schlüsselstring später sehen möchten, rufen Sie die Seite Schlüssel und Anmeldedaten auf und klicken Sie für den Schlüssel auf Schlüssel anzeigen.

Wenn die Console anders aussieht als in diesen Schritten, finden Sie weitere Informationen in der Google Cloud-Dokumentation unter API-Schlüssel erstellen und API-Einschränkungen hinzufügen.

Cloud SDK

Ersetzen Sie in den folgenden Befehlen PROJECT_ID durch Ihre Projekt-ID.

  • Neuen Schlüssel erstellen: Führen Sie den folgenden Befehl aus und ersetzen Sie DISPLAY_NAME durch einen Namen für den Schlüssel. 

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

    Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

  • Vorhandenen Schlüssel verwenden: Führen Sie den folgenden Befehl aus und ersetzen Sie KEY_ID durch die ID des Schlüssels. Mit dem Flag --append werden die APIs beibehalten, die der Schlüssel bereits zulässt. Ohne diesen Parameter werden sie durch den Befehl ersetzt.

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

    Weitere Informationen zum Google Cloud SDK, zur Cloud SDK-Installation und zu folgenden Befehlen:

    Die Schlüssel-ID ist nicht der Schlüsselstring oder der Anzeigename. Führen Sie gcloud services api-keys list --project="PROJECT_ID" aus, um sie zu finden. Die ID ist der letzte Teil des Felds name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Führen Sie gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" aus, um den Schlüsselstring aufzurufen.

Wegbeschreibung abrufen

Wenn Sie eine Wegbeschreibung von Disneyland zu den Universal Studios Hollywood im JSON-Format erhalten möchten, geben Sie die URL in Ihren Webbrowser ein und ersetzen Sie YOUR_API_KEY durch Ihren API-Schlüssel:

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

Sie sollten die folgende JSON-Antwort erhalten:

    {
       "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"
    }

Das wars! Sie haben die Directions API (Legacy) erfolgreich eingerichtet und aufgerufen, um Wegbeschreibungen zu erhalten.

Bereinigen

Sie können Ihr Google Cloud-Projekt löschen, um die Abrechnung für alle in diesem Projekt verwendeten Ressourcen zu beenden.

  1. Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.

    Zur Seite "Ressourcen verwalten"

  2. Wenn das Projekt, das Sie löschen möchten, an eine Organisation geknüpft ist, wählen Sie oben auf der Seite die Liste der Organisationen aus und maximieren Sie sie.
  3. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie auf Löschen.
  4. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Beenden, um das Projekt zu löschen.

Nächste Schritte

  • So richten Sie Ihr Google Cloud-Projekt ein, um mit der Directions API (Legacy) zu entwickeln:

    In der Cloud Console einrichten

  • Eine Liste aller Parameter zum Erstellen einer HTTP-Anfrage für die Directions API (Legacy) finden Sie hier:

    Route berechnen

  • Hier erfahren Sie, wie Sie mit unseren Clientbibliotheken programmieren, die einfache, native Implementierungen gängiger Aufgaben wie Authentifizierung, Anfrage-Drosselung und automatische Wiederholung bieten. Die Directions API (Legacy) ist im Java-, Python-, Go- und Node.js-Client für Google Maps-Dienste verfügbar.