Kod przykładowy pakietu SDK Map na iOS

Wybierz platformę: Android iOS JavaScript

Repozytorium pakietu Maps SDK na iOS na GitHub zawiera przykłady ilustrujące użycie tego pakietu w aplikacji na iOS. Przykładowa aplikacja zawiera kod najważniejszych funkcji pakietu SDK i może służyć jako punkt wyjścia dla Twojej aplikacji.

Rozwiązywanie problemów: jeśli przykładowa aplikacja działa prawidłowo, ale nie widzisz mapy, sprawdź, czy klucz interfejsu API został dodany do pliku manifestu aplikacji zgodnie z opisem w artykule Używanie kluczy interfejsu API.

Lista przykładów Maps SDK na iOS

Poniżej znajdziesz kluczowe przykładowe działania z aplikacji demonstracyjnej, które zostały odtworzone na stronach, do których prowadzą linki. Pełną listę dostępnych przykładów znajdziesz w folderze z przykładami na GitHubie.

• Wyświetlanie podstawowej mapy
• Wyświetlanie okna informacyjnego znacznika
• Dodawanie znacznika do mapy
• Odwrotne geokodowanie lokalizacji
• Włączanie i wyłączanie gestów na mapie
• Obsługa zdarzeń znacznika
• Włączanie przycisku Moja lokalizacja
• Rysowanie wielokątów na mapie
• Rysowanie linii łamanych na mapie

Lokalne uruchamianie pełnej przykładowej aplikacji

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

Ważne: musisz usunąć wszystkie istniejące zależności dodane za pomocą CocoaPods lub ręcznie. Instrukcje znajdziesz w kroku 2 artykułu Konfigurowanie projektu w Xcode.

1. Uruchom git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git, aby sklonować repozytorium z przykładami do katalogu lokalnego.

2. Otwórz okno terminala, przejdź do katalogu, w którym sklonowano przykładowe pliki, i przejdź do katalogu GoogleMaps:

   Swift

   cd maps-sdk-for-ios-samples/GoogleMaps-Swift
   open GoogleMapsSwiftXCFrameworkDemos.xcodeproj

   Objective-C

   cd maps-sdk-for-ios-samples-main/GoogleMaps
   open GoogleMapsDemos.xcodeproj

3. W projekcie Xcode kliknij File (Plik) > Add Package Dependencies (Dodaj zależności pakietów). Wpisz https://github.com/googlemaps/ios-maps-sdk jako adres URL, naciśnij Enter, aby pobrać pakiet, i kliknij Add Package (Dodaj pakiet).
4. W Xcode naciśnij przycisk kompilacji, aby skompilować aplikację z bieżącym schematem. Kompilacja spowoduje błąd i pojawi się prośba o wpisanie klucza interfejsu API w pliku SDKConstants.swift w przypadku języka Swift lub w pliku SDKDemoAPIKey.h w przypadku języka Objective-C.
5. Pobierz klucz interfejsu API z projektu z włączonym pakietem Maps SDK na iOS.
6. Zmodyfikuj plik SDKConstants.swift w przypadku języka Swift lub plik SDKDemoAPIKey.h w przypadku języka Objective-C i wklej klucz interfejsu API do definicji stałej apiKey lub kAPIKey. Na przykład:

   Swift

   static let apiKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

7. W pliku SDKConstants.swift (Swift) lub SDKDemoAPIKey.h (Objective-C) usuń ten wiersz, ponieważ służy on do rejestrowania problemu zdefiniowanego przez użytkownika:

   Swift

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

   Objective-C

   #error Register for API Key and insert here.

8. Skompiluj i uruchom projekt. Pojawi się okno symulatora iOS z listą Maps SDK Demos (Wersje demonstracyjne pakietu Maps SDK).
9. Wybierz jedną z wyświetlonych opcji, aby wypróbować funkcję pakietu Maps SDK na iOS.
10. Jeśli pojawi się prośba o zezwolenie aplikacji GoogleMapsDemos na dostęp do Twojej lokalizacji, wybierz Zezwól.