Einrichtung und Demo

Plattform auswählen: Android iOS

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

Sie haben zwei Möglichkeiten, diese Dienstprogramme auszuprobieren:

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

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

Swift Package Manager verwenden

  1. Falls du noch kein Xcode-Projekt hast, erstelle eines und speichere es auf dem lokalen Rechner. (Falls du noch keine Erfahrung in der iOS-Entwicklung hast, erstelle ein neues Projekt und wähle die Vorlage für iOS-Apps aus. In Xcode 11.7 oder einer früheren Version musst du 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 Datei -> Swift-Pakete -> Paketabhängigkeit hinzufügen.
  4. Geben Sie im angezeigten Fenster die Repository-URL der Maps SDK for iOS-Dienstprogrammbibliothekhttps://github.com/googlemaps/google-maps-ios-utils ein und wählen Sie Weiter aus.
    • Möglicherweise werden Sie aufgefordert, sich mit Ihrem GitHub-Konto zu authentifizieren. Folgen Sie der Anleitung, um ein persönliches GitHub-Zugriffstoken zu erstellen, um fortzufahren.
  5. Wählen Sie im nächsten Fenster die Option Version aus, wählen Sie in der Drop-down-Liste Bis zur nächsten Hauptversion aus und geben Sie die neueste Version der Dienstprogrammbibliothek des Google Maps SDK for iOS ein (z. B. „6.0.0“).
  6. Klicken Sie auf das Drop-down-Menü neben Zum Projekt hinzufügen, wählen Sie Ihr Projekt und dann Paket hinzufügen aus.

Mit CocoaPods

  1. Falls du noch kein Xcode-Projekt hast, erstelle eines und speichere es auf dem lokalen Rechner. (Falls du noch keine Erfahrung in der iOS-Entwicklung hast, erstelle eine Single View Application.)
  2. Wenn Sie noch keine Pod-Datei für Ihr Projekt haben, erstellen Sie in Ihrem Projektverzeichnis eine Datei mit dem Namen Podfile. In dieser Datei sind die Abhängigkeiten des Projekts definiert.
  3. Bearbeiten Sie die Pod-Datei Ihres Projekts und fügen Sie eine Abhängigkeit vom Google-Maps-iOS-Utils-Pod hinzu. Im Folgenden findest du ein Beispiel, das die Abhängigkeiten enthält, die du für das Maps SDK for iOS und die Dienstprogrammbibliothek benötigst:
    source 'https://github.com/CocoaPods/Specs.git'
    platform :ios, '15.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      use_frameworks!
      pod 'GoogleMaps', '9.0.0'
      pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
    end
  4. Führen Sie pod install aus.
  5. Schließe Xcode und öffne dann mit einem Doppelklick die Datei .xcworkspace deines Projekts, um Xcode wieder zu starten. Ab jetzt musst du das Projekt über die Datei .xcworkspace aufrufen.

Hinweis:Das Tool zum Markierungsclustern ist vom Quadtree abhängig, Sie können das Quadtree aber auch ohne Markierungscluster verwenden. Wenn Sie nur das Quadtree-Dienstprogramm benötigen, können Sie in Ihrer Pod-Datei pod 'Google-Maps-iOS-Utils' in 'Google-Maps-iOS-Utils/QuadTree' ändern.

API-Schlüssel in die App einfügen

Eine Anleitung zum Generieren eines API-Schlüssels und zum Hinzufügen desselben 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 und führen Sie das Projekt aus.

Dienstprogramm in Ihrer App verwenden

Weitere Informationen zur Verwendung in Ihrer App finden Sie in der Dokumentation zu den einzelnen Dienstprogrammen:

Demo-App installieren und ausführen

Die Dienstprogrammbibliothek enthält eine Demo-App, die Sie installieren und dann die einzelnen Dienstprogramme ausprobieren können.

So installieren Sie die Demo-App:

Dateien von GitHub verwenden

  1. Laden Sie das Codebeispielarchiv von GitHub herunter und entpacken Sie es.
  2. Öffnen Sie ein Terminalfenster, wechseln Sie zum Verzeichnis, in dem Sie die Beispieldateien entpackt haben, und rufen Sie das entsprechende Beispielverzeichnis für die gewünschte Sprache auf:
    • Für Swift: Führen Sie cd google-maps-ios-utils-master/samples/SwiftDemoApp aus.
    • Für Objective-C: Führen Sie cd google-maps-ios-utils-master/samples/ObjCDemoApp aus.
  3. Führen Sie dazu diesen Befehl aus:
    pod install
  4. Schließe Xcode und öffne dann mit einem Doppelklick die Datei .xcworkspace deines Projekts, um Xcode wieder zu starten. Ab jetzt musst du das Projekt über die Datei .xcworkspace aufrufen.

API-Schlüssel zur Demo-App hinzufügen

Unter API-Schlüssel anfordern haben Sie einen API-Schlüssel für Ihre App generiert. 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, indem Sie Ihren API-Schlüssel zwischen die Anführungszeichen setzen:
    // 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, indem Sie Ihren API-Schlüssel zwischen die Anführungszeichen setzen:
    // 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 und führen Sie das Projekt 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, wird die Demo des Markierungs-Clustering-Dienstprogramms angezeigt. Sie können dann die Objective-C-Version der Demo bearbeiten, um die einzelnen Dienstprogramme auszuprobieren. Weitere Informationen finden Sie unten im Abschnitt Dienstprogramm zur App hinzufügen.