Krótkie wprowadzenie do pakietu SDK Miejsc na iOS

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:

Pakiet SDK Miejsc na iOS: konfiguracja

Oficjalne pakiety SDK Miejsc na iOS:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

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, GMSAutocompleteFetcher i GMSAutocompleteViewController) nie istnieją w pakiecie SDK w wersji 11.0.0 i nowszych, co powoduje błąd kompilacji. Zobacz przewodnik po migracji.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner i GMSAutocompleteFetcher initWithBounds:filter: wycofane 13 października 2020 r. Zastąpienie: GMSAutocompleteFilter (locationBias lub locationRestriction) w GMSAutocompleteRequest za pomocą GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: lub modyfikatorów GooglePlacesSwift placeAutocomplete lub basicPlaceAutocomplete w przypadku widżetu UI. Objaw: metody nie istnieją w pakiecie SDK w wersji 4.0.0 i nowszych (a metody GMSAutocompleteResultsViewController i GMSAutocompleteFetcher zostały usunięte w pakiecie SDK w wersji 11.0.0). Zobacz przewodnik po migracji.
  • Granice autouzupełniania na podstawie GMSCoordinateBounds (parametry GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; bounds/boundsMode w findAutocompletePredictionsFromQuery i autocompleteQuery): wycofane 13 października 2020 r. Zastąpienie: GMSAutocompleteRequest przez GMSAutocompleteFilter (locationBias lub locationRestriction) i GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: lub modyfikatory GooglePlacesSwift placeAutocomplete lub basicPlaceAutocomplete dla widżetu UI. Objaw: właściwości i parametry nie występują w pakiecie SDK w wersji 4.0.0 i nowszych (a GMSAutocompleteViewController i findAutocompletePredictionsFromQuery zostały usunięte w pakiecie SDK w wersji 11.0.0). Zobacz przewodnik po migracji.
  • GMSPlace.openNowStatus: wycofany 13 października 2020 r. Zamiennik: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) lub PlacesClient.isPlaceOpen(with:) w GooglePlacesSwift. Objaw: właściwość nie istnieje w pakiecie SDK w wersji 4.0.0 i nowszych. Zobacz przewodnik po migracji.
  • GMSPlaceField jako NS_ENUM: wycofane 13 października 2020 r. Zamiennik: stałe GMSPlaceProperty z klasami żądań, takimi jak GMSFetchPlaceRequest i GMSPlaceSearchByTextRequest, lub PlaceProperty w GooglePlacesSwift. Objaw: zastąpiony przez NS_OPTIONS w pakiecie SDK w wersji 4.0.0 (GMSPlaceField, ponieważ NS_OPTIONS należ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

Pakiet SDK Miejsc na iOS: Miejsca

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