Einrichtung und Demo

Plattform auswählen: Android iOS

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

Um diese Dienstprogramme auszuprobieren, haben Sie folgende Möglichkeiten:

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. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es auf Ihrem lokalen Computer. Wenn Sie mit der iOS-Entwicklung noch nicht vertraut sind, erstellen Sie ein neues Projekt und wählen Sie die Option iOS-App Vorlage. Unter Xcode 11.7 oder älter müssen Sie eine Single View Application (Anwendung mit Einzelansicht) erstellen.
  2. Fügen Sie das Maps SDK for iOS als Abhängigkeit hinzu. Weitere Informationen finden Sie unter SDK installieren, um Optionen zu sehen
  3. Gehen Sie in Ihrem Xcode-Projekt zu File (Datei) -> Swift-Pakete -> Paketabhängigkeit hinzufügen.
  4. Gib im angezeigten Fenster die Repository-URL der Maps SDK for iOS-Dienstprogrammbibliothek ein https://github.com/googlemaps/google-maps-ios-utils und wählen Sie Weiter aus.
    • Sie werden dann möglicherweise aufgefordert, sich mit Ihrem GitHub-Konto zu authentifizieren. Folgen Sie Anleitung zum Erstellen einer GitHub persönliches Zugriffstoken, um den Vorgang fortzusetzen.
  5. Wählen Sie im nächsten Fenster das Optionsfeld Version und dann Bis zur nächsten Hauptversion aus. aus der Drop-down-Liste und geben Sie die neueste 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 und dann Add Package (Paket hinzufügen) aus.

Mit CocoaPods

  1. Wenn Sie noch kein Xcode-Projekt haben, erstellen Sie eines und speichern Sie es unter auf Ihrem lokalen Computer. Wenn Sie noch keine Erfahrung mit der iOS-Entwicklung haben, erstellen Sie eine Single Anwendung ansehen.
  2. Wenn Sie für Ihr Projekt noch keine Pod-Datei haben, erstellen Sie eine Datei in Ihrem Projektverzeichnis: Podfile. Diese Datei definiert Ihre Abhängigkeiten des Projekts.
  3. Bearbeiten Sie die Pod-Datei Ihres Projekts und fügen Sie eine Abhängigkeit vom Pod Google-Maps-iOS-Utils. Hier ist eine Beispiel mit den Abhängigkeiten, Maps SDK for iOS und die Dienstprogrammbibliothek: 
    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.0.0' # x-release-please-version
end
  4. Führen Sie pod install aus.
  5. Schließen Sie Xcode und öffnen Sie dann per Doppelklick das .xcworkspace-Datei, um Xcode zu starten. Ab diesem Zeitpunkt Sie müssen die Datei .xcworkspace zum Öffnen des Projekts verwenden.

Hinweis: Das Markierungs-Clustering-Dienstprogramm hängt vom Quadtree, aber Sie können den Quadtree ohne Marker-Clustering verwenden. Bei Bedarf nur das Dienstprogramm Quadtree verwenden, können Sie pod 'Google-Maps-iOS-Utils' bis 'Google-Maps-iOS-Utils/QuadTree' in der Pod-Datei.

API-Schlüssel in die App einfügen

Anweisungen zum Generieren finden Sie unter Xcode-Projekt einrichten. einen API-Schlüssel und fügen ihn Ihrem Xcode-Projekt hinzu.

Projekt erstellen und ausführen

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

Dienstprogramm in Ihrer App verwenden

Weitere Informationen zur Verwendung in Ihrer Anwendung 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 jedes Dienstprogramm ausprobieren können.

Installieren Sie die Demo-App mit einer der folgenden Methoden:

Dateien von GitHub verwenden

  1. Herunterladen das Codebeispiel-Archiv von GitHub und entpacke das Archiv.
  2. Öffnen Sie ein Terminalfenster, gehen Sie zu dem Verzeichnis, in dem Sie die Beispieldateien maximiert haben, und Rufen Sie das entsprechende Beispielverzeichnis für die zu verwendende Sprache auf: <ph type="x-smartling-placeholder">
      </ph>
    • Führen Sie für Swift cd google-maps-ios-utils-master/samples/SwiftDemoApp aus.
    • Führen Sie für Objective-C cd google-maps-ios-utils-master/samples/ObjCDemoApp aus.
  3. Führen Sie den folgenden Befehl aus:
    pod install
  4. Schließen Sie Xcode und öffnen Sie dann per Doppelklick das .xcworkspace-Datei, um Xcode zu starten. Ab diesem Zeitpunkt Sie müssen die Datei .xcworkspace zum Öffnen des Projekts verwenden.

CocoaPods v1.6.1 verwenden

  1. Öffnen Sie ein Terminalfenster und installieren Sie Version 1.6.1: 
    sudo gem install cocoapods -v1.6.1
  2. Rufen Sie die Google Maps-Dateien mithilfe von CocoaPods ab: 
    pod try Google-Maps-iOS-Utils

    Wählen Sie bei entsprechender Aufforderung entweder „Swift“ oder „Objective-C“ aus. CocoaPods aktualisiert Ihre Spezifikations-Repositories, Anschließend wird die Demo in einem temporären Xcode-Projekt mit dem Namen SwiftDemoApp.xcodeproj geöffnet. oder ObjCDemoApp.xcodeproj.

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

Unter API-Schlüssel abrufen generieren Sie einen API-Schlüssel für Ihre App. Fügen Sie diesen Schlüssel nun 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 doppelten Anführungszeichen einzufü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 doppelten Anführungszeichen einzufü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 es aus:

  • Wenn Sie die Swift-Version der Demo verwenden, 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. Anschließend können Sie die Objective-C-Version der Demo bearbeiten, um jedes Dienstprogramm auszuprobieren. Weitere Informationen finden Sie unten im Abschnitt Dienstprogramm zur App hinzufügen.