Pakiet SDK Miejsc do przykładowego kodu na iOS

Aplikacja demonstracyjna pakietu SDK Miejsc na iOS w GitHub, która jest dostarczana z pakietem SDK Miejsc na iOS, prezentuje wiele funkcji, w tym Autouzupełnianie miejsc i Place Photos. 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 początkowego dla swojej aplikacji.

Po uruchomieniu przykładowej aplikacji wyświetli się lista dostępnych przykładów, które możesz uruchomić na własnym urządzeniu. Wybierz jedną z opcji.

Uruchamianie pełnej przykładowej aplikacji lokalnie

Przykładowa aplikacja pakietu SDK Miejsc na iOS jest dostępna jako archiwum do pobrania w 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 zostały rozpakowane pliki przykładowe, i otwórz katalog 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 File (Plik) > Add Package Dependencies (Dodaj zależności pakietu). Wpisz https://github.com/googlemaps/ios-places-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, a potem kliknij Add Package (Dodaj pakiet).
4. Włącz w projekcie w konsoli Google Cloud pakiet SDK Miejsc na iOS i  pakiet Maps SDK na iOS.
5. Uzyskaj klucz interfejsu API z projektu, w którym włączony jest interfejs Places API lub Places API (nowy).
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).

   Aby zdefiniować klucze interfejsu API, dodaj do pliku konfiguracji 2 wiersze:

   PLACES_API_KEY = YOUR_PLACES_API_KEY i MAPS_API_KEY = YOUR_MAPS_API_KEY.

   Zastąp YOUR_PLACES_API_KEY i YOUR_MAPS_API_KEY kluczami interfejsu API z poprzednich kroków.

   Więcej informacji o tworzeniu lokalnego pliku konfiguracji znajdziesz w artykule Format pliku ustawień konfiguracji (xcconfig).

   Swift

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

   let placesAPIKey = "YOUR_API_KEY"

   Jeśli występuje, 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 Odblokuj.

   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 występuje, 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 Odblokuj.

7. Tworzenie aplikacji
8. Jeśli kompilacja się nie powiedzie lub aplikacja ulegnie awarii z błędem dotyczącym klucza interfejsu API podczas pierwszego uruchomienia, sprawdź, czy podane klucze są zgodne z instrukcjami powyżej.
9. Jeśli uruchomisz przykładową aplikację, w oknie symulatora iOS pojawi się lista wersji demonstracyjnych interfejsu Places API.
10. Gdy pojawi się prośba o zezwolenie aplikacji w wersji demonstracyjnej na dostęp do Twojej lokalizacji, wybierz Zezwól.
11. Wybrana próbka jest teraz gotowa do uruchomienia.