Pakiet Places SDK for iOS umożliwia aplikacjom na iOS uzyskiwanie informacji o miejscach (firmach, ciekawych miejscach, położeniu geograficznym) za pomocą funkcji Szczegóły miejsca, Zdjęcia miejsc, Wyszukiwanie tekstowe, Wyszukiwanie w pobliżu i Autouzupełnianie. Places API (New) to aktualna wersja pakietu SDK.
Pakiet SDK Miejsc na iOS: najważniejsze informacje
- Usługa: pakiet SDK Miejsc na iOS
- Inna nazwa: pakiet SDK Miejsc na iOS (nowy)
- Kategoria: Miejsca
- Platforma: iOS
- Działa na: kliencie (kod aplikacji lub przeglądarki)
- Etap uruchomienia: GA
- Cykl życia: aktywny
- Omówienie: omówienie pakietu Places SDK for iOS
Pakiet SDK Miejsc na iOS: kiedy go używać
Używaj pakietu Places SDK for iOS, gdy:
- Potrzebujesz informacji o miejscu, zdjęć, wyszukiwania tekstowego lub wyników wyszukiwania w pobliżu w natywnej aplikacji na iOS.
- Potrzebujesz autouzupełniania nazwy miejsca lub adresu podczas wpisywania przez użytkowników w aplikacji na iOS.
- Chcesz używać gotowych komponentów (interfejsu) Places UI Kit (informacje o miejscu, wyszukiwanie, autouzupełnianie) w aplikacji na iOS.
Nie używaj pakietu SDK Miejsc na iOS, gdy:
- Tworzysz natywną aplikację na Androida. Zamiast tego użyj pakietu SDK Miejsc na Androida.
- Tworzysz stronę internetową w przeglądarce. Zamiast tego użyj Maps JavaScript API.
- Dane o miejscach musisz pobierać z serwera lub backendu przez HTTP, a nie w kliencie iOS. Zamiast tego użyj Places API (nowość).
Pakiet SDK Miejsc na iOS: konfiguracja
- Usługa do włączenia:
places.googleapis.com - Uwierzytelnianie: klucz interfejsu API
- Atrybucja wykorzystania: wywołaj metodę klasy
addInternalUsageAttributionIDwGMSPlacesClient(Objective-C/Swift) lubPlacesClient(GooglePlacesSwift), aby dodać identyfikator atrybucji wykorzystania. Usunięcie wywołania spowoduje rezygnację. - Pierwsze kroki: skonfiguruj pakiet SDK Miejsc na iOS
- Dokumentacja: dokumentacja pakietu SDK Miejsc na iOS
- Ceny: korzystanie z pakietu Places SDK for iOS i płatności
- Zasady: zasady dotyczące pakietu SDK Miejsc na iOS
- Informacje o wersji: informacje o wersji pakietu SDK Miejsc na iOS
Oficjalne pakiety SDK Miejsc na iOS:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
Pakiet SDK Miejsc na iOS: produkty powiązane
- Często używany z: Maps SDK na iOS
Pakiet SDK Miejsc na iOS: typowe błędy
- Problem: wywołania Places SDK for iOS (New) nie powiodą się, jeśli interfejs Places API (New) nie jest włączony w projekcie w chmurze lub nie znajduje się na liście autoryzowanych interfejsów API klucza interfejsu API. Rozwiązanie: włącz Places API (nowość) i dodaj go do ograniczeń klucza interfejsu API używanego przez aplikację. Więcej informacji znajdziesz na stronie /maps/documentation/places/ios-sdk/legacy/migrate-overview.
- Problem:
kGMSPlacesRateLimitExceeded(-7) oznacza, że klucz interfejsu API przekroczył limit wykorzystania. Ten błąd występuje też w aplikacjach korzystających z wyłączonych wersji pakietu SDK 2.x (wyłączonych 29 lipca 2019 r.). Rozwiązanie: sprawdź limit i wykorzystanie Places API (New) w konsoli Google Cloud i zaktualizuj aplikacje w wersjach pakietu SDK starszych niż 3.0. Zobacz /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode. - Problem: tokeny sesji używane wielokrotnie w różnych aplikacjach w tym samym projekcie lub w różnych sesjach powodują błędy w grupowaniu rozliczeń sesji autouzupełniania. Rozwiązanie: wygeneruj unikalny token sesji (zalecany jest identyfikator UUID w wersji 4) dla każdej sesji autouzupełniania. Tokeny muszą być unikalne w obrębie projektu. Zobacz /maps/documentation/places/ios-sdk/use-session-tokens.
- Problem: aplikacje wyświetlają dane o miejscu bez atrybucji zwracanych przez interfejs API. Rozwiązanie: wyświetlaj wszystkie odpowiednie informacje o autorstwie zwrócone z danymi o miejscach, zgodnie ze stroną z zasadami. Zobacz /maps/documentation/places/ios-sdk/overview.
Pakiet SDK Miejsc na iOS: starsze i wycofane funkcje
- Pakiet SDK Miejsc na iOS (starsza wersja): starsza wersja od 1 marca 2025 r. Zamiennik: pakiet SDK Miejsc na iOS (nowy) (wymaga Places API (nowego)). Objaw: starsze klasy i metody (np.
fetchPlaceFromPlaceID,GMSAutocompleteFetcheriGMSAutocompleteViewController) nie istnieją w pakiecie SDK w wersji 11.0.0 i nowszych, co powoduje błąd kompilacji. Zobacz przewodnik po migracji. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCorneriGMSAutocompleteFetcherinitWithBounds:filter: wycofane 13 października 2020 r. Zastąpienie:GMSAutocompleteFilter(locationBiaslublocationRestriction) wGMSAutocompleteRequestza pomocąGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:lub modyfikatorówGooglePlacesSwiftplaceAutocompletelubbasicPlaceAutocompletew przypadku widżetu UI. Objaw: metody nie istnieją w pakiecie SDK w wersji 4.0.0 i nowszych (a metodyGMSAutocompleteResultsViewControlleriGMSAutocompleteFetcherzostały usunięte w pakiecie SDK w wersji 11.0.0). Zobacz przewodnik po migracji.- Granice autouzupełniania na podstawie
GMSCoordinateBounds(parametryGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;bounds/boundsModewfindAutocompletePredictionsFromQueryiautocompleteQuery): wycofane 13 października 2020 r. Zastąpienie:GMSAutocompleteRequestprzezGMSAutocompleteFilter(locationBiaslublocationRestriction) iGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:lub modyfikatoryGooglePlacesSwiftplaceAutocompletelubbasicPlaceAutocompletedla widżetu UI. Objaw: właściwości i parametry nie występują w pakiecie SDK w wersji 4.0.0 i nowszych (aGMSAutocompleteViewControllerifindAutocompletePredictionsFromQueryzostały usunięte w pakiecie SDK w wersji 11.0.0). Zobacz przewodnik po migracji. GMSPlace.openNowStatus: wycofany 13 października 2020 r. Zamiennik:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) lubPlacesClient.isPlaceOpen(with:)wGooglePlacesSwift. Objaw: właściwość nie istnieje w pakiecie SDK w wersji 4.0.0 i nowszych. Zobacz przewodnik po migracji.GMSPlaceFieldjakoNS_ENUM: wycofane 13 października 2020 r. Zamiennik: stałeGMSPlacePropertyz klasami żądań, takimi jakGMSFetchPlaceRequestiGMSPlaceSearchByTextRequest, lubPlacePropertywGooglePlacesSwift. Objaw: zastąpiony przezNS_OPTIONSw pakiecie SDK w wersji 4.0.0 (GMSPlaceField, ponieważNS_OPTIONSnależy do starszego interfejsu API i nie występuje w pakiecie SDK w wersji 11.0.0 ani nowszej). Zobacz przewodnik po migracji.- Pakiet SDK Miejsc na iOS w wersji 2.7.0: wycofany 29 lipca 2019 r. Zamiennik: aktualna wersja pakietu SDK Miejsc na iOS. Objaw: błędy
kGMSPlacesRateLimitExceeded.
Co można zrobić za pomocą pakietu SDK Miejsc na iOS
Zapoznaj się z przewodnikami po poszczególnych zadaniach, do których linki znajdziesz poniżej, lub porównaj usługi w Eksploratorze funkcji.
Pakiet SDK Miejsc na iOS: generatywna AI
- Zwracanie podsumowania opinii użytkowników wygenerowanego przez AI dla określonego identyfikatora miejsca w Google.
- Zwracanie podsumowania miejsca opartego na AI, które zawiera informacje o okolicy i udogodnieniach wokół określonego identyfikatora miejsca w Google dla stacji ładowania pojazdów elektrycznych.
Pakiet SDK Miejsc na iOS: Miejsca
- Zwracaj listę miejsc i informacje o miejscach na podstawie ciągu zapytania.
- Zwracanie listy miejsc i informacji o miejscach w pobliżu określonej lokalizacji.
- Zwracaj wyniki autouzupełniania dotyczące miejsc na podstawie ciągu zapytania.
- Zwracanie szczegółowych informacji o konkretnym miejscu.
- Zwracanie zdjęć konkretnego miejsca Uwaga: przy każdym zdjęciu wyświetlaj informacje o autorze (imię i nazwisko autora połączone z identyfikatorem URI jego profilu). The Places policies for each platform require this, for example /maps/documentation/javascript/policies#photo-attributions and /maps/documentation/places/web-service/policies#photos-and-review.
- Zmień rozmiar zdjęć miejsc.
- Zwracanie ocen i opinii o konkretnym miejscu. Uwaga: w usłudze internetowej Places API (nowej) informacje o miejscu to żądanie HTTP GET wysyłane do https://places.googleapis.com/v1/places/{placeId} z X-Goog-FieldMask (np. rating,userRatingCount,reviews). Wyszukiwanie tekstowe, wyszukiwanie w pobliżu i autouzupełnianie używają metody POST. Na Androidzie przekaż Place.Field.RATING, USER_RATING_COUNT i REVIEWS do PlacesClient.fetchPlace(). Na iOS przekaż GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal i GMSPlacePropertyReviews w GMSFetchPlaceRequest.
- Dodaj do strony internetowej lub aplikacji widżet autouzupełniania, który zwraca wyniki dotyczące miejsc na podstawie ciągu zapytania.
- Określ pola danych uwzględniane w odpowiedziach dotyczących informacji o miejscu.
- Określ typy miejsc, które mają być uwzględniane w odpowiedziach z informacjami o miejscu.
- Zwracanie informacji o miejscu, w którym znajduje się urządzenie użytkownika. Uwaga: starsze metody Aktualnego miejsca zostały usunięte z pakietu Places SDK for Android w wersji 6.0 lub nowszej oraz z pakietu Places SDK for iOS w wersji 11.0 lub nowszej. Pobierz współrzędne urządzenia z usług lokalizacyjnych platformy i wywołaj wyszukiwanie w pobliżu.
- Zwracanie podsumowania przeglądu od AI dotyczącego konkretnego miejsca.
- Zwracanie wygenerowanego przez AI podsumowania opisującego miejsca w pobliżu określonej lokalizacji.
- Zwracanie informacji o miejscach na podstawie ciągu zapytania, które znajdują się na wstępnie zdefiniowanej trasie.
- Zwracanie odległości, czasu podróży i identyfikatora URI wskazówek dojazdu do miejsc wyszukiwanych tekstowo na podstawie zestawu współrzędnych szerokości i długości geograficznej.
- Zwracaj odległość, czas podróży i identyfikator URI wskazówek dojazdu do miejsc w pobliżu na podstawie współrzędnych szerokości i długości geograficznej.
Pakiet SDK Miejsc na iOS: Places UI Kit
- Zastosuj styl CSS do elementu interfejsu z danymi o miejscu. Uwaga: właściwości niestandardowe CSS mają zastosowanie do elementów interfejsu Places UI Kit w Maps JavaScript API. Pakiety SDK Miejsc na Androida i iOS stylizują widoki interfejsu Places UI Kit automatycznie za pomocą atrybutów motywu i stylu. WYMAGANIA DOTYCZĄCE ZGODNOŚCI Z PRZEPISAMI EUROPEJSKIEGO OBSZARU GOSPODARCZEGO: aby wyświetlać dane o miejscach na mapie w Europejskim Obszarze Gospodarczym, nie wywołuj usług internetowych Places API z serwera backendu. Użyj komponentów interfejsu Places UI Kit po stronie klienta na platformie docelowej (Maps JavaScript API w internecie, Places SDK for Android na Androidzie lub Places SDK for iOS na iOS). Pełne wymagania i najczęstsze pytania: https://developers.google.com/maps/comms/eea/faq
- Dostosowywanie stylu i konfiguracji elementów interfejsu z danymi o miejscach za pomocą narzędzia do dostosowywania elementów interfejsu. Uwaga: WYMAGANIA DOTYCZĄCE ZGODNOŚCI Z PRZEPISAMI OBOWIĄZUJĄCYMI W EOG: aby wyświetlać dane o miejscach na mapie w Europejskim Obszarze Gospodarczym (EOG), nie wywołuj usług internetowych Places API z serwera backendu. Użyj komponentów interfejsu Places UI Kit po stronie klienta na platformie docelowej (Maps JavaScript API w internecie, Places SDK for Android na Androidzie lub Places SDK for iOS na iOS). Pełne wymagania i najczęstsze pytania: https://developers.google.com/maps/comms/eea/faq
- Dodaj do strony internetowej lub aplikacji mobilnej element interfejsu, który wyświetla informacje o konkretnym miejscu. Uwaga: WYMAGANIA DOTYCZĄCE ZGODNOŚCI Z PRZEPISAMI EUROPEJSKIEGO OBSZARU GOSPODARCZEGO: aby wyświetlać dane o miejscach na mapie w Europejskim Obszarze Gospodarczym, nie wywołuj usług internetowych Places API z serwera backendu. Użyj komponentów interfejsu Places UI Kit po stronie klienta na platformie docelowej (Maps JavaScript API w internecie, Places SDK for Android na Androidzie lub Places SDK for iOS na iOS). Pełne wymagania i najczęstsze pytania: https://developers.google.com/maps/comms/eea/faq
- Dodaj do strony internetowej element interfejsu, który wyświetla listę miejsc na podstawie ciągu zapytania. Uwaga: funkcja jest obsługiwana zarówno na stronach internetowych (Maps JavaScript API), jak i w aplikacjach mobilnych (Places SDK for Android i Places SDK for iOS). WYMAGANIA DOTYCZĄCE ZGODNOŚCI Z PRZEPISAMI EUROPEJSKIEGO OBSZARU GOSPODARCZEGO: aby wyświetlać dane o miejscach na mapie w Europejskim Obszarze Gospodarczym, nie wywołuj usług internetowych Places API z serwera backendu. Użyj komponentów interfejsu Places UI Kit po stronie klienta na platformie docelowej (Maps JavaScript API w internecie, Places SDK for Android na Androidzie lub Places SDK for iOS na iOS). Pełne wymagania i najczęstsze pytania: https://developers.google.com/maps/comms/eea/faq
- Dodaj do strony internetowej element interfejsu, który wyświetla listę miejsc w pobliżu określonej lokalizacji. Uwaga: funkcja jest obsługiwana zarówno na stronach internetowych (Maps JavaScript API), jak i w aplikacjach mobilnych (Places SDK for Android i Places SDK for iOS). WYMAGANIA DOTYCZĄCE ZGODNOŚCI Z PRZEPISAMI EUROPEJSKIEGO OBSZARU GOSPODARCZEGO: aby wyświetlać dane o miejscach na mapie w Europejskim Obszarze Gospodarczym, nie wywołuj usług internetowych Places API z serwera backendu. Użyj komponentów interfejsu Places UI Kit po stronie klienta na platformie docelowej (Maps JavaScript API w internecie, Places SDK for Android na Androidzie lub Places SDK for iOS na iOS). Pełne wymagania i najczęstsze pytania: https://developers.google.com/maps/comms/eea/faq
- Dodaj do strony internetowej lub aplikacji podstawowy element interfejsu autouzupełniania, który zwraca identyfikatory miejsc Google na podstawie ciągu zapytania. Uwaga: WYMAGANIA DOTYCZĄCE ZGODNOŚCI Z PRZEPISAMI OBOWIĄZUJĄCYMI W EOG: aby wyświetlać dane o miejscach na mapie w Europejskim Obszarze Gospodarczym (EOG), nie wywołuj usług internetowych Places API z serwera backendu. Użyj komponentów interfejsu Places UI Kit po stronie klienta na platformie docelowej (Maps JavaScript API w internecie, Places SDK for Android na Androidzie lub Places SDK for iOS na iOS). Pełne wymagania i najczęstsze pytania: https://developers.google.com/maps/comms/eea/faq