Omówienie pakietu SDK Miejsc (starszej wersji)

SDK Miejsc umożliwia wyszukiwanie i pobieranie informacji o różnych typach miejsc za pomocą ciągu tekstowego lub na podstawie odległości. Pakiet SDK Miejsc to starsza wersja pakietu SDK Miejsc (nowa).

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

Funkcje pakietu SDK dostępne w poszczególnych wersjach

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

Funkcja	Włączony interfejs Places API w kluczu interfejsu API	Metoda inicjowania	Minimalna wersja pakietu SDK
Autouzupełnianie (nowość)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.5.0
Szczegóły miejsca (nowe)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.3.0
Wyszukiwanie w pobliżu (nowość)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.5.0
Zdjęcia miejsc (nowość)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.4.0
Wyszukiwanie tekstowe (nowość)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.3.0
Autouzupełnianie miejsc	Places API	initialize() (Wycofano)
Aktualne miejsce	Places API	initialize() (Wycofano)
Szczegóły miejsca	Places API	initialize() (Wycofano)
Zdjęcia miejsc	Places API	initialize() (Wycofano)

Wycofano: metoda Places.initialize została wycofana. Zamiast niej używaj Places.initializeWithNewPlacesApiEnabled(). Pamiętaj, że aby używać Places.initializeWithNewPlacesApiEnabled(), musisz włączyć interfejs Places API (nowy) 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 szczegółów miejsca (nowość)
• Przejdź na interfejs Place Photo (nowy)
• Migracja do autouzupełniania (nowość)

Ulepszenia w pakiecie Places SDK na Androida (nowość)

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

Wdrożone na standardowej platformie Google Cloud

Pakiet SDK Miejsc na Androida (nowy) jest zaimplementowany w infrastrukturze usług w Google Cloud. Dzięki temu platforma jest bezpieczniejsza i bardziej wiarygodna. Ten standardowy projekt zapewnia spójność pakietów SDK, co zwiększa efektywność programowania z użyciem pakietu SDK Miejsc na Androida (nowego).

Poprawiona wydajność

Pakiet SDK Miejsc na Androida (nowy) zapewnia większą wydajność, dlatego warto zastąpić nim aplikacje korzystające z dotychczasowego pakietu SDK.

Nowe funkcje

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

• Autouzupełnianie (nowość)
• Szczegóły miejsca (nowe)
• Wyszukiwanie w pobliżu (nowość)
• Zdjęcia miejsc (nowość)
• Wyszukiwanie tekstowe (nowość)

Nowa usługa wyszukiwania tekstowego

Wyszukiwanie tekstowe (nowość) zwraca informacje o zbiorze miejsc na podstawie ciągu znaków, np. „pizza w Nowym Jorku”, „sklepy obuwnicze w pobliżu Ottawy” lub „ulica Główna 123”. Usługa odpowiada listą miejsc pasujących do ciągu tekstowego i ustawionego odchylenia lokalizacji.

Nowe dane odpowiedzi dodane do Szczegółów miejsca (nowe) i Zdjęć miejsca (nowe)

• Informacje o miejscu (nowość) obejmują teraz w odpowiedzi obiekt Place nowej klasy Review. Klasa Place zawiera nową metodę getReviews() obsługi tego pola. Wywołanie getReviews() zwraca maksymalnie 5 opinii o miejscu.

• Place Photo (Nowa) dodaje AuthorAttributions do klasy PhotoMetadata. AuthorAttributions zawiera List obiektów AuthorAttribution.

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

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

Uproszczone ceny

Ceny są uproszczone w przypadku pakietu Places SDK na Androida (nowego), dzięki czemu płacisz tylko za wykorzystane dane. Uproszczone określanie cen jest wdrażane za pomocą list pól, zwanych też maskami pól.

W przypadku interfejsów Place Details i Text Search używasz list pól, aby określić listę pól, które mają zostać zwrócone w odpowiedzi. Wtedy opłata jest naliczana tylko za dane, o które prosisz. Korzystanie z listy pól to dobra praktyka projektowania, która pozwala uniknąć wysyłania zapytań o niepotrzebne dane. Dzięki temu można skrócić czas przetwarzania i uniknąć niepotrzebnych opłat.

Szczegółowe informacje o cenach obu pakietów SDK znajdziesz w sekcji Wykorzystanie i rozliczenia.

Rozszerzone typy miejsc

Nowy pakiet SDK zawiera nowe typy miejsc, które są zwracane w ramach odpowiedzi Informacje o miejscu i Wyszukiwanie tekstowe. Możesz też używać tych nowych typów i dotychczasowych typów w wyszukiwaniu za pomocą wyszukiwania tekstowego. Nowe typy są uwzględnione w tabeli A.