Einrichtung

Auf dieser Seite wird beschrieben, was Sie tun müssen, um mit dem Maps 3D SDK for iOS zu entwickeln. Dazu müssen Sie ein Google Cloud-Projekt und eine API für die Verwendung mit dem SDK konfigurieren und dann ein Xcode-Projekt einrichten. Führen Sie diese Schritte aus, bevor Sie Ihrer App die erste 3D-Karte hinzufügen.

Vorbereitung

Wenn Sie das Maps 3D SDK für iOS verwenden möchten, müssen Ihr Projekt und Ihre Zielgeräte die folgenden Anforderungen erfüllen:

  • Mindestversion von iOS: iOS 16.0 oder höher.
  • Xcode: Xcode-Version 16.0 oder höher.

Google Cloud-Projekt und API-Schlüssel einrichten

Bevor Sie mit dem Maps 3D SDK for iOS arbeiten können, müssen Sie ein Google Cloud-Projekt und einen API-Schlüssel für die Verwendung mit dem Maps 3D SDK for iOS einrichten. Gehen Sie dazu so vor:

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.

Bei einigen Integrationen musst du mehrere APIs und SDKs aktivieren. Wenn Sie sich nicht sicher sind, welche APIs oder SDKs Sie aktivieren sollen, können Sie den Capabilities Explorer oder die Dokumentation für die API bzw. das SDK zurate ziehen.

So aktivieren Sie eine oder mehrere APIs oder SDKs:

Console

  1. Welche APIs und SDKs der Google Maps Platform zur Verfügung stehen, sehen Sie auf der Seite der Google Maps-API-Bibliothek in der Cloud Console:

    Zur Maps API-Bibliothek

  2. Klicken Sie auf die API oder das SDK, das Sie aktivieren möchten.
    • Wenn der Button AKTIVIEREN angezeigt wird, kannst du die API oder das SDK mit einem Klick darauf aktivieren.
    • Ist hingegen der Button VERWALTEN zu sehen, bedeutet das, dass die API oder das SDK bereits aktiviert ist und Sie nichts weiter tun müssen.
    • Wenn Sie auf einen dieser beiden Buttons klicken, wird das Dashboard für die API oder das SDK angezeigt. Falls Sie die API oder das SDK aus dem Projekt entfernen möchten, klicken Sie auf DEAKTIVIEREN.

Cloud SDK

Mit dem folgenden Befehl werden alle Maps, Routes und Places APIs aktiviert:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

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

Verwenden Sie diesen Befehl, um die Environment APIs zu aktivieren:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

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 APIs, die Sie verwenden möchten, ausgewählt bleiben.
      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 APIs aus, die Sie verwenden möchten.
      3. Klicken Sie auf Speichern.

    Wenn Sie hier eine API auswählen, wird sie nicht aktiviert. Achten Sie darauf, dass jede ausgewählte API in der 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. Ersetzen Sie SERVICE_NAME durch den Dienstnamen einer API, die Sie verwenden möchten, z. B. places.googleapis.com. Wenn Sie weitere APIs zulassen möchten, wiederholen Sie das Flag --api-target.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

    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. Ersetzen Sie SERVICE_NAME durch den Dienstnamen der API, die Sie hinzufügen möchten. 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=SERVICE_NAME

    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.

Informationen zum Aktivieren des SDK finden Sie in der Google Cloud Console auf der Seite Maps 3D SDK for iOS. Weitere Informationen zu diesen Schritten finden Sie unter Erste Schritte mit der Google Maps Platform.

Xcode-Projekt einrichten

In diesem Abschnitt wird beschrieben, wie Sie ein Xcode-Projekt für die Verwendung mit dem Maps 3D SDK for iOS erstellen und konfigurieren.

Nachdem Sie die Abrechnung aktiviert und einen API-Schlüssel erstellt haben, können Sie das Xcode-Projekt für die Entwicklung Ihrer Anwendung einrichten.

Schritt 1: Erforderliche Software installieren

Wenn Sie ein Projekt mit dem Maps 3D SDK for iOS erstellen möchten, müssen Sie Folgendes herunterladen und installieren:

  • Xcode-Version 16.0 oder höher

Schritt 2: Xcode-Projekt erstellen und Maps 3D SDK for iOS installieren

Swift Package Manager

Das Maps 3D SDK für iOS kann mit dem Swift Package Manager installiert werden.

So fügen Sie das SDK einem neuen oder vorhandenen Projekt hinzu:

  • Öffnen Sie Ihre Xcode-project oder -workspace und gehen Sie dann zu File (Datei) > Add Package Dependencies (Paketabhängigkeiten hinzufügen).
  • Geben Sie https://github.com/googlemaps/ios-maps-3d-sdk als URL ein, drücken Sie die Eingabetaste, um das Paket abzurufen, und klicken Sie auf „Add Package“ (Paket hinzufügen).
  • Prüfen Sie im Fenster Paketprodukte auswählen, ob GoogleMaps3D dem angegebenen Hauptziel hinzugefügt wird. Klicken Sie anschließend auf Paket hinzufügen.
  • Rufen Sie den Bereich Allgemein des Ziels auf, um die Installation zu prüfen. Unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte) sollten die installierten Pakete angezeigt werden. Sie können auch im Project Navigator den Bereich Package Dependencies aufrufen, um das Paket und seine Version zu prüfen.

Schritt 3: API-Schlüssel in die App einfügen

Swift Package Manager

Fügen Sie den API-Schlüssel wie folgt dem Haupteinstiegspunkt Ihrer App hinzu (oder zu einem beliebigen Zeitpunkt, bevor die Karte geladen wird).

  1. Gib die folgende Importanweisung an: 
    import GoogleMaps3D
  2. Fügen Sie die folgende Methode hinzu. Ersetzen Sie dabei YOUR_API_KEY durch Ihren eigenen API-Schlüssel. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

Schritt 4 (optional): Datenschutzmanifestdatei von Apple prüfen

Apple verlangt Datenschutzdetails für Apps im App Store.

Die Datenschutzmanifestdatei von Apple ist im Ressourcen-Bundle für das SDK enthalten. Wenn Sie prüfen möchten, ob die Datenschutzmanifestdatei enthalten ist, und ihren Inhalt einsehen möchten, erstellen Sie ein Archiv Ihrer App und generieren Sie einen Datenschutzbericht aus dem Archiv.

Nächste Schritte

Nachdem Sie ein Google Cloud-Projekt, einen API-Schlüssel und ein Xcode-Projekt für die Verwendung mit dem Maps 3D SDK for iOS eingerichtet haben, können Sie Ihrer App eine 3D-Karte hinzufügen.