Einrichtung und Demo

Plattform auswählen: Android iOS

Auf dieser Seite wird beschrieben, wie Sie die Dienstprogrammbibliothek für das Maps SDK for iOS einrichten.

Sie haben folgende Möglichkeiten, diese Dienstprogramme zu testen:

Maps SDK for iOS-Dienstprogrammbibliothek einem Xcode-Projekt hinzufügen

Gehen Sie wie folgt vor, um die Dienstprogrammbibliothek Ihrem Xcode-Arbeitsbereich hinzuzufügen:

Swift Package Manager verwenden

  1. Falls Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf dem lokalen Rechner. (Wenn Sie noch keine Erfahrung in der iOS-Entwicklung haben, erstellen Sie ein neues Projekt und wählen Sie die iOS App Vorlage aus. In Xcode 11.7 oder einer älteren Version müssen Sie eine Single View Application (App mit Einzelansicht) einrichten.)
  2. Fügen Sie das Maps SDK for iOS als Abhängigkeit hinzu. Informationen zu den Optionen finden Sie unter SDK installieren.
  3. Gehen Sie in Ihrem Xcode-Projekt zu File -> Swift Packages -> Add Package Dependency (Datei > Swift-Pakete > Paketabhängigkeit hinzufügen).
  4. Geben Sie im angezeigten Fenster die Repository-URL der Maps SDK for iOS-Dienstprogrammbibliothek https://github.com/googlemaps/google-maps-ios-utils ein und wählen Sie Next (Weiter) aus.
    • Möglicherweise werden Sie an dieser Stelle aufgefordert, sich mit Ihrem GitHub-Konto zu authentifizieren. Folgen Sie der Anleitung, um ein GitHub persönliches Zugriffstoken zu erstellen, damit Sie fortfahren können.
  5. Wählen Sie im nächsten Fenster die Option Version aus, wählen Sie in der Drop-down-Liste Up to Next Major Version (Bis zur nächsten Hauptversion) aus und geben Sie die aktuelle Version der Maps SDK for iOS-Dienstprogrammbibliothek ein (z. B. „6.0.0“).
  6. Klicken Sie auf das Drop-down-Menü neben Add to Project (Zum Projekt hinzufügen), wählen Sie Ihr Projekt aus und klicken Sie auf Add Package (Paket hinzufügen).

API-Schlüssel in die App einfügen

Eine Anleitung zum Generieren eines API-Schlüssels und zum Hinzufügen zu Ihrem Xcode-Projekt finden Sie unter Xcode-Projekt einrichten.

Projekt erstellen und ausführen

Nachdem Sie den API-Schlüssel hinzugefügt haben, erstellen Sie das Projekt und führen Sie es aus.

Dienstprogramm in Ihrer App verwenden

Weitere Informationen zur Verwendung der einzelnen Dienstprogramme in Ihrer App finden Sie in der Dokumentation:

Demo-App installieren und ausführen

Die Dienstprogrammbibliothek enthält eine Demo-App, die Sie installieren und dann jedes Dienstprogramm testen können.

So installieren Sie die Demo-App:

Dateien von GitHub verwenden

  1. Laden Sie das Codebeispielarchiv von GitHub herunter und entpacken Sie es. Alternativ können Sie das Repository in ein lokales Verzeichnis klonen: 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. Öffnen Sie ein Terminalfenster, wechseln Sie zu dem Verzeichnis, in dem Sie die Beispieldateien entpackt haben, und rufen Sie das entsprechende Beispielverzeichnis für die gewünschte Sprache auf:

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

API-Schlüssel in die Demo-App einfügen

Unter API-Schlüssel erstellen generieren Sie einen API-Schlüssel für Ihre App. Fügen Sie diesen Schlüssel jetzt dem Xcode-Projekt für die Demo-App hinzu.

Swift

Füge deinen API-Schlüssel folgendermaßen in AppDelegate.swift ein:

  1. Fügen Sie die folgende Importanweisung hinzu: 
    import GoogleMaps
  2. Bearbeiten Sie die folgende Zeile, um Ihren API-Schlüssel zwischen den doppelten Anführungszeichen hinzuzufügen: 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

Füge deinen API-Schlüssel folgendermaßen in AppDelegate.m ein:

  1. Fügen Sie die folgende Importanweisung hinzu: 
    @import GoogleMaps;
  2. Bearbeiten Sie die folgende Zeile, um Ihren API-Schlüssel zwischen den doppelten Anführungszeichen hinzuzufügen: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

Demo-App erstellen und ausführen

Nachdem Sie den API-Schlüssel hinzugefügt haben, erstellen Sie das Projekt und führen Sie es aus:

  • Wenn Sie die Swift-Version der Demo ausführen, können Sie auswählen, welches Dienstprogramm in der App angezeigt werden soll.
  • Wenn Sie die Objective-C-Version der Demo ausführen, sehen Sie die Demo des Markierungs-Clustering-Dienstprogramms. Sie können dann die Objective-C-Version der Demo bearbeiten, um jedes Dienstprogramm zu testen. Weitere Informationen finden Sie unten im Abschnitt Dienstprogramm Ihrer App hinzufügen.