Navigation SDK for iOS einrichten

In diesem Dokument werden die Schritte beschrieben, die für die Verwendung des Navigation SDK für iOS erforderlich sind.

Vorbereitung

In diesem Verfahren werden Sie durch die Einrichtung eines Google Cloud-Kontos und eines Google Cloud-Projekts mit aktivierter Abrechnung geführt. Außerdem sollten Sie sich mit den Kosten für die Verwendung des Navigation SDK for iOS vertraut machen.

  1. Informationen zu Abrechnung und Kosten für die Nutzung finden Sie unter Navigation SDK for iOS: Nutzung und Abrechnung.

  2. Prüfen Sie, ob Sie ein Google Cloud-Konto haben.

    Melden Sie sich in der Google Cloud Console an.

  3. Prüfen Sie, ob Sie ein Google Cloud-Projekt mit aktivierter Abrechnung haben.

    Zur Seite „Abrechnung“
    1. Wählen Sie Ihr Projekt aus, um die Seite Abrechnung zu öffnen.

    2. Auf der Seite Abrechnung:

      • Wenn die Abrechnung für das ausgewählte Projekt bereits aktiviert ist und Sie nur ein einziges Rechnungskonto haben, wird die Seite Abrechnung geöffnet.
      • Wenn Sie mehrere Rechnungskonten haben, wählen Sie Zum verknüpften Rechnungskonto aus, um die Details zum Rechnungskonto aufzurufen, das mit dem Projekt verknüpft ist.
      • Wenn ein Rechnungskonto vorhanden, aber nicht mit dem Projekt verknüpft ist, werden Sie aufgefordert, ein Rechnungskonto mit dem Projekt zu verknüpfen.
      • Wenn kein Rechnungskonto vorhanden ist oder Sie ein neues Rechnungskonto erstellen möchten, wählen Sie Rechnungskonten verwalten aus, um ein neues Rechnungskonto zu erstellen. Weitere Informationen finden Sie unter Neues Selfservice-Cloud-Rechnungskonto erstellen.

SDK aktivieren

Bevor Sie das Navigation SDK for iOS verwenden können, müssen Sie es in Ihrem Google Cloud-Projekt über die Google Cloud Console oder den Befehl gcloud aktivieren.

So aktivieren Sie das SDK:

Console

  1. Öffnen Sie die Produktseite in der Google Cloud Console:

    Navigation SDK for iOS aktivieren

  2. Klicken Sie auf Aktivieren.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "navigationsdk.googleapis.com"

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

API-Schlüssel konfigurieren

Google Maps Platform-Produkte sind vor unbefugter Nutzung geschützt, da API-Aufrufe nur mit einem API-Schlüssel möglich sind.

API-Schlüssel für das Navigation SDK for iOS abrufen

Ein API-Schlüssel ist ein eindeutiger alphanumerischer String, über den Ihr Cloud-Rechnungskonto und Ihr Google Cloud-Projekt mit der Anfrage verknüpft werden, die Ihre Anwendung an eine Google Maps Platform API oder ein Google Maps Platform SDK sendet. Folgen Sie dieser Anleitung, um einen neuen Schlüssel zu erstellen oder einem vorhandenen Schlüssel eine API oder ein SDK 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 das Navigation SDK for iOS 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 Navigation SDK for iOS aus.
      3. Klicken Sie auf Speichern.

    Wenn Sie hier eine API auswählen, wird sie nicht aktiviert. Prüfen Sie, ob das Navigation SDK for iOS 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.

gcloud

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=navigationsdk.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=navigationsdk.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.

Einschränkungen für API-Schlüssel anwenden

Google empfiehlt dringend, die API-Schlüssel einzuschränken, indem Sie ihre Nutzung auf die APIs und Apps beschränken, die sie benötigen. Wenn Sie Ihre API-Schlüssel einschränken, wird Ihre App sicherer und es wird dafür gesorgt, dass nur autorisierte Anfragen gesendet werden. API-Schlüssel unterstützen zwei Arten von Einschränkungen:

  • API-Einschränkungen geben an, welche SDKs und APIs mit dem API-Schlüssel aufgerufen werden können. In der Console und der gcloud CLI ist beim Erstellen eines Schlüssels mindestens eine API-Einschränkung erforderlich.
  • Anwendungseinschränkungen geben an, welche Websites, IP-Adressen oder Anwendungen einen API-Schlüssel verwenden dürfen.

Weitere Informationen zum Anwenden von Einschränkungen finden Sie unter API-Schlüssel einschränken.

Nächste Schritte

Nachdem Sie das Navigation SDK for iOS aktiviert und einen API-Schlüssel konfiguriert haben, können Sie sich unter Xcode-Projekt einrichten darüber informieren, wie Sie Xcode konfigurieren und den API-Schlüssel an Ihre App übergeben.