Codebeispiele für das Places SDK for iOS

Plattform auswählen: Android iOS JavaScript

Die Demo-App für das Places SDK for iOS auf GitHub, die mit dem Places SDK for iOS bereitgestellt wird, demonstriert eine Reihe von Funktionen, darunter Place Autocomplete und Place Photos. Außerdem sind auf jeder Seite im Entwicklerhandbuch Code-Snippets zu finden. Sie können die App importieren und erstellen, Ihren API-Schlüssel hinzufügen, sich die Demo ansehen und den Beispielcode als Ausgangspunkt für Ihre App verwenden.

Wenn Sie die Beispiel-App starten, wird eine Liste der verfügbaren Beispiele angezeigt, die Sie auf Ihrem eigenen Gerät ausführen können. Wählen Sie eine der Optionen aus.

Vollständige Beispielanwendung lokal ausführen

Die Beispiel-App für das Places SDK for iOS ist als Downloadarchiv auf GitHub verfügbar. Folgen Sie dieser Anleitung, um die Beispiel-App für das Places SDK for iOS zu installieren und auszuprobieren.

  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-samples/ios-places-sdk-samples.git

  2. Öffnen Sie ein Terminalfenster, wechseln Sie in das Verzeichnis, in dem Sie die Beispieldateien entpackt haben, und rufen Sie das Verzeichnis für die gewünschte Version auf:

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj
  3. Gehen Sie im Xcode-Projekt zu File > Add Package Dependencies (Datei > Paketabhängigkeiten hinzufügen). Geben Sie https://github.com/googlemaps/ios-places-sdk als URL ein, drücken Sie die Eingabetaste, um das Paket abzurufen, und klicken Sie auf Paket hinzufügen.
  4. Aktivieren Sie das Places SDK for iOS und das Maps SDK for iOS für Ihr Google Cloud Console-Projekt.
  5. Rufen Sie einen API-Schlüssel für Ihr Projekt ab, für das die Places API und/oder die Places API (New) aktiviert ist.
  6. Fügen Sie den API-Schlüssel gemäß der entsprechenden Anleitung unten in die App ein.

    SwiftUI

    Erstellen Sie eine lokale Konfigurationsdatei mit dem Namen GooglePlacesDemos.xcconfig für Ihren API-Schlüssel im selben Verzeichnis wie die Info.plist-Datei der Demoanwendung (GooglePlacesDemos/GooglePlacesDemos).

    Fügen Sie Ihrer Konfigurationsdatei zwei Zeilen hinzu, um Ihre API-Schlüssel zu definieren:

    PLACES_API_KEY = YOUR_PLACES_API_KEY und MAPS_API_KEY = YOUR_MAPS_API_KEY.

    Ersetzen Sie YOUR_PLACES_API_KEY und YOUR_MAPS_API_KEY durch die API-Schlüssel aus den vorherigen Schritten.

    Informationen zum Erstellen einer lokalen Konfigurationsdatei finden Sie unter Format der Konfigurationseinstellungsdatei (xcconfig).

    Swift

    Bearbeiten Sie die Datei SDKDemoAPIKey und fügen Sie Ihren API-Schlüssel in die entsprechende Konstante ein. Beispiel:

    let placesAPIKey = "YOUR_API_KEY"

    Entfernen Sie die folgende Zeile, falls sie vorhanden ist:

    #error (Register for API Key and insert here. Then delete this line.)

    Wenn Sie in Xcode aufgefordert werden, die Datei SDKDemoAPIKey zum Bearbeiten zu entsperren, wählen Sie Entsperren aus.

    Objective-C

    Bearbeiten Sie die Datei SDKDemoAPIKey und fügen Sie Ihren API-Schlüssel in die entsprechende Konstante ein. Beispiel:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    Entfernen Sie die folgende Zeile, falls sie vorhanden ist:

    #error (Register for API Key and insert here. Then delete this line.)

    Wenn Sie in Xcode aufgefordert werden, die Datei SDKDemoAPIKey zum Bearbeiten zu entsperren, wählen Sie Entsperren aus.

  7. App erstellen
  8. Wenn der Build fehlschlägt oder die App beim ersten Ausführen mit einem Fehler zu Ihrem API-Schlüssel abstürzt, prüfen Sie, ob Sie die oben in der Anleitung beschriebenen erforderlichen Schlüssel angegeben haben.
  9. Wenn Sie die Beispiel-App ausführen, wird im iOS-Simulationsfenster eine Liste mit Places-Demos angezeigt.
  10. Wenn Sie aufgefordert werden, der Demo-App den Zugriff auf Ihren Standort zu erlauben, wählen Sie Zulassen aus.
  11. Das von Ihnen gewählte Beispiel kann jetzt ausgeführt werden.