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:
- Musisz wywołać Places z serwera lub backendu przez HTTP, a nie z aplikacji na Androida. Zamiast tego użyj Places API (New).
- Tworzysz natywną aplikację na iOS. Zamiast tego użyj pakietu Places SDK na iOS.
- Tworzysz stronę internetową w przeglądarce. Zamiast tego użyj Maps JavaScript API.
Pakiet SDK Miejsc na Androida: konfiguracja
- Usługa do włączenia:
places.googleapis.com - Uwierzytelnianie: klucz interfejsu API
- Atrybucja wykorzystania: wywołaj
Places.addInternalUsageAttributionId(String)podczas inicjowania pakietu SDK, aby wysłać identyfikator atrybucji wykorzystania. Aby zrezygnować, usuń wywołanie lub przekaż pusty ciąg znaków. - Pierwsze kroki: skonfiguruj pakiet SDK Miejsc na Androida
- Dokumentacja: dokumentacja pakietu SDK Miejsc na Androida
- Ceny: korzystanie z pakietu Places SDK for Android i rozliczenia
- Zasady: Zasady dotyczące pakietu SDK Miejsc na Androida
- Informacje o wersji: informacje o wersji pakietu SDK Miejsc na Androida
Oficjalne pakiety SDK Miejsc na Androida:
- maven:
com.google.android.libraries.places:places
Pakiet SDK Miejsc na Androida: produkty powiązane
- Często używane z: Maps SDK na Androida
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.Fieldna liście pólSearchNearbyRequest. 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ętoPlaces.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:
Placezwracany przezfetchPlace()nie maPhotoMetadata(więc nie ma nic do rozwiązania), gdy lista pól pomijaPHOTO_METADATAS. Rozwiązanie: dodajPlace.Field.PHOTO_METADATASdo listy pól. MetodafetchResolvedPhotoUri()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,PhotoMetadataiReview. 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()iawaitFindCurrentPlace()(Aktualne miejsce, starsza wersja): wycofane od 30 września 2026 r. Zamiennik:PlacesClient.searchNearby()(Wyszukiwanie w pobliżu (Nowe)). Objaw: metody i klasyFindCurrentPlaceRequest/FindCurrentPlaceResponsezostały usunięte w wersji 6.0.2. Zobacz przewodnik po migracji.PlacesClient.fetchPhoto()iawaitFetchPhoto(): wycofane od 30 września 2026 r. Zamiennik: komponent Informacje o miejscu w Places UI Kit (PlacesClient.fetchResolvedPhotoUri()jest wycofany). Objaw: metody i klasyFetchPhotoRequest/FetchPhotoResponsezostał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) lubPlacesClient.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 (klasaAutocompleteSupportFragmentzostał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
- 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 Androida: 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.
- Zwróć identyfikator URI, aby otworzyć stronę z informacjami o miejscu w Mapach Google.
- 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.
- Zwracaj odległość, czas podróży i identyfikator URI wskazówek dojazdu między miejscem początkowym wstępnie zdefiniowanej trasy a każdym z miejsc zwróconych na podstawie ciągu zapytania, które również znajdują się na trasie.
- Zwracanie odległości, czasu podróży i identyfikatora URI wskazówek dojazdu między każdym z miejsc zwróconych na podstawie ciągu zapytania, które znajdują się na wstępnie zdefiniowanej trasie, a miejscem docelowym trasy.
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