Skrócone informacje o pakiecie SDK Miejsc na Androida

Pakiet Places SDK for Android umożliwia aplikacjom na Androida dostęp do bazy danych Google zawierającej informacje o miejscach i firmach za pomocą autouzupełniania miejsc, informacji o miejscu, wyszukiwania w pobliżu, wyszukiwania tekstowego i zdjęć miejsc. Pakiet SDK Miejsc na Androida (nowy) to aktualna wersja, która zależy od Places API (nowego).

Pakiet SDK Miejsc na Androida: najważniejsze informacje

  • Usługa: pakiet SDK Miejsc na Androida
  • Inna nazwa: pakiet SDK Miejsc na Androida (nowy)
  • Kategoria: Miejsca
  • Platforma: Android
  • Działa na: kliencie (kod aplikacji lub przeglądarki)
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie pakietu SDK Miejsc na Androida

Pakiet SDK Miejsc na Androida: kiedy go używać

Używaj pakietu Places SDK for Android, gdy:

  • Potrzebujesz informacji o miejscu, zdjęć, wyszukiwania w pobliżu lub wyników wyszukiwania tekstu w natywnej aplikacji na Androida.
  • Potrzebujesz gotowego widżetu autouzupełniania lub komponentów pakietu Places UI Kit, które zwracają prognozy miejsc podczas wpisywania tekstu przez użytkowników w aplikacji na Androida.
  • Musisz utworzyć funkcje Androida uwzględniające lokalizację na podstawie firm i ciekawych miejsc w pobliżu urządzenia użytkownika.

Kiedy nie używać pakietu SDK Miejsc na Androida:

Pakiet SDK Miejsc na Androida: konfiguracja

Oficjalne pakiety SDK Miejsc na Androida:

  • maven: com.google.android.libraries.places:places

Pakiet SDK Miejsc na Androida: typowe błędy

  • Problem: żądania wyszukiwania w pobliżu bez listy pól (maski pola) lub z pustą listą zwracają błąd. Rozwiązanie: podaj co najmniej 1 wartość Place.Field na liście pól SearchNearbyRequest. Zobacz /maps/documentation/places/android-sdk/nearby-search.
  • Problem: funkcje informacji o miejscu (nowa wersja), Wyszukiwania w pobliżu (nowa wersja) i autouzupełniania (nowa wersja) nie działają, gdy klucz interfejsu API nie ma interfejsu Places API (nowa wersja) lub gdy aplikacja wywołuje Places.initialize() w pakiecie SDK w wersji 5.x lub starszej. W wersji 6.0.2 usunięto Places.initialize(), więc kod, który go wywołuje, nie kompiluje się po uaktualnieniu. Rozwiązanie: włącz Places API (nowy), dodaj go do dozwolonych interfejsów API klucza interfejsu API i zainicjuj za pomocą Places.initializeWithNewPlacesApiEnabled(). Zobacz /maps/documentation/places/android-sdk/legacy/migrate-overview.
  • Problem: Place zwracany przez fetchPlace() nie ma PhotoMetadata (więc nie ma nic do rozwiązania), gdy lista pól pomija PHOTO_METADATAS. Rozwiązanie: dodaj Place.Field.PHOTO_METADATAS do listy pól. Metoda fetchResolvedPhotoUri() została wycofana, dlatego do wyświetlania zdjęć używaj komponentu informacji o miejscu w interfejsie Places UI Kit. Zobacz /maps/documentation/places/android-sdk/place-photos.
  • Problem: aplikacje, które wyświetlają informacje o miejscu, zdjęcia lub opinie bez zwracanych informacji o autorze i źródle, naruszają zasady. Rozwiązanie: wyświetlaj atrybucje zwracane z obiektami Place, PhotoMetadata i Review. Zobacz /maps/documentation/places/android-sdk/policies.

Pakiet SDK Miejsc na Androida: funkcje starsze i wycofane

  • Funkcje pakietu Places SDK for Android (starsza wersja) / Places API (starsza wersja) (autouzupełnianie, Aktualne miejsce, informacje o miejscu, zdjęcia miejsca w starszej wersji): starsza wersja od 1 marca 2025 r. Zamiennik: funkcje pakietu Places SDK for Android (New) obsługiwane przez Places API (New), inicjowane za pomocą Places.initializeWithNewPlacesApiEnabled(). Problem: od października 2026 r. w nowych projektach w chmurze nie będzie można włączyć Places API (starszej wersji) (istniejące projekty będą nadal obsługiwane). W pakiecie SDK w wersji 6.0.2 usunięto starsze metody, które występują tylko w wersji 5.x i starszych. Zobacz przewodnik po migracji.
  • Places.initialize(): wycofany od 30 września 2026 r. Wymiana: Places.initializeWithNewPlacesApiEnabled(). Objaw: metoda została usunięta z pakietu SDK w wersji 6.0.2; kod, który ją wywołuje, nie jest już kompilowany. Zobacz przewodnik po migracji.
  • PlacesClient.findCurrentPlace() i awaitFindCurrentPlace() (Aktualne miejsce, starsza wersja): wycofane od 30 września 2026 r. Zamiennik: PlacesClient.searchNearby() (Wyszukiwanie w pobliżu (Nowe)). Objaw: metody i klasy FindCurrentPlaceRequest/FindCurrentPlaceResponse zostały usunięte w wersji 6.0.2. Zobacz przewodnik po migracji.
  • PlacesClient.fetchPhoto() i awaitFetchPhoto(): wycofane od 30 września 2026 r. Zamiennik: komponent Informacje o miejscu w Places UI Kit (PlacesClient.fetchResolvedPhotoUri() jest wycofany). Objaw: metody i klasy FetchPhotoRequest/FetchPhotoResponse zostały usunięte w wersji 6.0.2. Zobacz przewodnik po migracji.
  • Widżet autouzupełniania Places API (starsza wersja) (Autocomplete, AutocompleteSupportFragment, AutocompleteActivityMode): wycofany 30 września 2026 r. Zamiennik: widżet Autouzupełnianie miejsc (nowe) (PlaceAutocomplete) lub PlacesClient.findAutocompletePredictions(). Objaw: klasy usunięte z pakietu SDK w wersji 6.0.2. Zobacz przewodnik po migracji.
  • Biblioteka zgodności Places (com.google.android.libraries.places:places-compat): wycofana 31 marca 2022 r. Zamiennik: pakiet SDK Miejsc na Androida (com.google.android.libraries.places:places). Objaw: zatrzymanie na wersji 2.6.0; brak nowych funkcji i poprawek błędów.
  • Klasa AutocompleteFragment: wycofana od 25 września 2025 r. Zamiennik: widżet autouzupełniania miejsc (nowy) (PlaceAutocomplete). Objaw: klasa została usunięta z pakietu SDK w wersji 5.0.0 (klasa AutocompleteSupportFragment została też usunięta w wersji 6.0.2).

Co można zrobić za pomocą pakietu SDK Miejsc na Androida

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 Androida: generatywna AI

Pakiet SDK Miejsc na Androida: miejsca

Pakiet SDK Miejsc na Androida: 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