Omówienie pakietu SDK Miejsc na Androida (starsza wersja)

Ta usługa ma stan „starsza wersja”. Od października 2026 r. nie będzie już można włączać interfejsu Places API (starszej wersji) w nowych projektach Google Cloud. Istniejące projekty są nadal w pełni obsługiwane. Aby korzystać z nowych funkcji i zwiększonej wydajności, przejdź na Places API (nowość).

Z tego przewodnika dowiesz się, jakie są najważniejsze różnice między wersjami pakietu SDK Miejsc, i jak przejść na pakiet SDK Miejsc na Androida (nowy).

Funkcje pakietu SDK dostępne w poszczególnych wersjach

W tabeli poniżej znajdziesz informacje o tym, które wersje pakietu SDK i interfejsu API są wymagane w przypadku poszczególnych funkcji pakietu SDK:

Funkcja	Wersja interfejsu Places API	Metoda inicjowania	Minimalna wersja pakietu SDK
Autocomplete (New)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.5.0
Informacje o miejscu (nowa wersja)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.3.0
Nearby Search (New)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Photos (New)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.4.0
Text Search (New)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.3.0
Autouzupełnianie miejsc	Places API (starsza wersja)	initialize() (Wycofano)
Aktualne miejsce	Places API (starsza wersja)	initialize() (Wycofano)
Informacje o miejscu	Places API (starsza wersja)	initialize() (Wycofano)
Place Photos	Places API (starsza wersja)	initialize() (Wycofano)

Wycofana: metoda Places.initialize została wycofana. Zamiast tego użyj Places.initializeWithNewPlacesApiEnabled(). Pamiętaj, że aby korzystać z usługi Places.initializeWithNewPlacesApiEnabled(), musisz włączyć Places API (New) w kluczu interfejsu API w konsoli Google Cloud.

Przejście na nowe interfejsy API

Aby przejść na nowe interfejsy API, zapoznaj się z tymi przewodnikami po migracji:

• Migracja do usługi Informacje o miejscu (nowej)
• Migracja do usługi Place Photos (New)
• Migracja do autouzupełniania (nowość)

Ulepszenia w pakiecie SDK Miejsc na Androida (nowa wersja)

W tej sekcji opisano najważniejsze funkcje dodane do pakietu SDK Miejsc na Androida (nowego).

Wdrożone na standardowej platformie Google Cloud

Pakiet Places SDK for Android (New) jest wdrażany w infrastrukturze usług w Google Cloud. Dzięki temu platforma jest bezpieczniejsza i bardziej godna zaufania. Ten standardowy projekt zapewnia spójność pakietów SDK, co zwiększa efektywność programowania za pomocą pakietu SDK Miejsc na Androida (nowego).

Poprawiona wydajność

Pakiet Places SDK for Android (New) zapewnia lepszą wydajność, dlatego warto zastąpić aplikacje, które korzystają z dotychczasowego pakietu SDK.

Nowe funkcje

Pakiet SDK Miejsc na Androida (nowy) zawiera najnowsze wersje wszystkich funkcji pakietu SDK:

• Autocomplete (New)
• Informacje o miejscu (nowa wersja)
• Nearby Search (New)
• Place Photos (New)
• Text Search (New)

Wyszukiwanie tekstu (nowe)

Wyszukiwanie tekstowe (nowe) zwraca informacje o zbiorze miejsc na podstawie ciągu znaków, np. „pizza w Nowym Jorku”, „sklepy obuwnicze w pobliżu Warszawy” lub „ul. Główna 123”. Usługa odpowiada listą miejsc pasujących do ciągu tekstowego i ustawionych preferencji lokalizacji.

Nowe dane odpowiedzi dodane do informacji o miejscu (nowych) i zdjęć miejsca (nowych)

• Informacje o miejscu (nowe) zawierają teraz w obiekcie odpowiedzi Place nową klasę Review. Klasa Place zawiera nową metodę getReviews() do obsługi tego pola. Wywołaj getReviews(), aby zwrócić maksymalnie 5 opinii o miejscu.

• Zdjęcia miejsc (nowe) dodaje metodę AuthorAttributions do klasy PhotoMetadata. AuthorAttributions zawiera List obiektów AuthorAttribution.

Dodano nową odpowiedź URI do usługi Place Photos (New)

Możesz teraz używać metody Place Photos (New), aby zwracać identyfikator URI do bitmapy obrazu. Wcześniej można było zwrócić tylko samą bitmapę obrazu.

Uproszczone ceny

W przypadku pakietu Places SDK for Android (New) cennik jest uproszczony, dzięki czemu płacisz tylko za dane, których używasz. Uproszczone ceny są wdrażane za pomocą list pól, nazywanych też maskami pól.

W przypadku informacji o miejscu (nowych) i wyszukiwania tekstowego (nowego) możesz używać list pól, aby określać, które pola mają być zwracane w odpowiedzi. Opłaty są naliczane tylko za żądane dane. Używanie listy pól to dobra praktyka projektowa, która pozwala uniknąć żądania niepotrzebnych danych, co pomaga skrócić czas przetwarzania i uniknąć niepotrzebnych opłat.

Więcej informacji o cenach znajdziesz w artykule Użycie i rozliczenia.

Rozszerzone typy miejsc

Nowy pakiet SDK zawiera nowe typy miejsc, które są zwracane w odpowiedzi na żądania informacji o miejscu (nowe) i Wyszukaj tekst (nowe). Możesz też używać tych nowych typów i istniejących typów w wyszukiwaniu za pomocą funkcji Wyszukaj tekst (New). Nowe typy są wymienione w tabeli A.