Pakiet SDK Miejsc do przykładowego kodu na iOS

Wybierz platformę: Android iOS JavaScript

Aplikacja demonstracyjna pakietu SDK Miejsc na iOS na GitHub dostarczana z pakietem SDK Miejsc na iOS prezentuje szereg funkcji, w tym autouzupełnianie miejsc i zdjęcia miejsc. Dodatkowo na każdej stronie tego przewodnika dla programistów znajdziesz fragmenty kodu. Zaimportuj i skompiluj aplikację, dodaj klucz interfejsu API, wyświetl wersję demonstracyjną i użyj dostarczonego przykładowego kodu jako punktu wyjścia dla swojej aplikacji.

Gdy uruchomisz przykładową aplikację, wyświetli się lista dostępnych próbek, które możesz uruchomić na swoim urządzeniu. Wybierz 1 z tych opcji:

Lokalne uruchamianie pełnej przykładowej aplikacji

Przykładowa aplikacja pakietu SDK Miejsc na iOS jest dostępna jako archiwum do pobrania z GitHub Aby zainstalować i wypróbować przykładową aplikację pakietu SDK Miejsc na iOS, wykonaj te czynności.

  1. Pobierz archiwum z przykładowym kodem z GitHub i rozpakuj je. Możesz też sklonować repozytorium do katalogu lokalnego: 
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git

  2. Otwórz okno terminala, przejdź do katalogu, w którym rozpakowano pliki przykładowe, i przejdź do katalogu z wersją, której chcesz użyć:

    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. W projekcie Xcode kliknij kolejno File (Plik) > Add Package Dependencies (Dodaj zależności pakietu). Jako adres URL wpisz https://github.com/googlemaps/ios-places-sdk, naciśnij Enter, aby pobrać pakiet, a następnie kliknij Add Package (Dodaj pakiet).
  4. Włącz pakiet SDK Miejsc na iOS w projekcie konsoli Google Cloud.
  5. Pobierz klucz interfejsu API z projektu, w którym włączony jest interfejs Places API lub Places API (nowość).
  6. Dodaj klucz interfejsu API do aplikacji, korzystając z odpowiednich instrukcji poniżej.

    SwiftUI

    Utwórz lokalny plik konfiguracyjny o nazwie GooglePlacesDemos.xcconfig dla klucza interfejsu API, w tym samym katalogu co plik Info.plist aplikacji demonstracyjnej (GooglePlacesDemos/GooglePlacesDemos).

    Dodaj do pliku konfiguracyjnego wiersz, aby zdefiniować klucz interfejsu API:

    PLACES_API_KEY = YOUR_PLACES_API_KEY

    Zastąp YOUR_PLACES_API_KEY kluczem interfejsu API z poprzednich kroków.

    Więcej informacji o tworzeniu lokalnego pliku konfiguracyjnego znajdziesz w sekcji Format pliku ustawień konfiguracyjnych (xcconfig).

    Swift

    Edytuj plik SDKDemoAPIKey i wklej klucz interfejsu API do odpowiedniej stałej. Na przykład:

    let placesAPIKey = "YOUR_API_KEY"

    Jeśli jest obecny, usuń ten wiersz:

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

    Jeśli Xcode wyświetli prośbę o odblokowanie pliku SDKDemoAPIKey w celu edycji, kliknij Unlock.

    Objective-C

    Edytuj plik SDKDemoAPIKey i wklej klucz interfejsu API do odpowiedniej stałej. Na przykład:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    Jeśli jest obecny, usuń ten wiersz:

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

    Jeśli Xcode wyświetli prośbę o odblokowanie pliku SDKDemoAPIKey w celu edycji, kliknij Unlock.

  7. Skompiluj aplikację.
  8. Jeśli kompilacja się nie powiedzie lub aplikacja ulegnie awarii z powodu błędu dotyczącego klucza interfejsu API podczas pierwszego uruchomienia, sprawdź, czy podane zostały klucze wymagane w instrukcjach powyżej.
  9. Jeśli uruchomisz przykładową aplikację, w oknie symulatora iOS pojawi się lista wersji demonstracyjnych Miejsc.
  10. Jeśli pojawi się prośba o zezwolenie aplikacji demonstracyjnej na dostęp do Twojej lokalizacji, kliknij Zezwól.
  11. Wybrana próbka jest teraz gotowa do uruchomienia.