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

Z tego przewodnika dowiesz się, jakie są najważniejsze różnice między wersjami pakietu Places SDK, i jak przeprowadzić migrację do pakietu Places SDK na Androida (nowego).

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
Autouzupełnianie (nowość)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.5.0
Informacje o miejscu (nowe)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.3.0
Wyszukiwanie w pobliżu (nowość)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.5.0
Place Photos (nowość)	Places API (nowość)	initializeWithNewPlacesApiEnabled()	3.4.0
Wyszukiwanie tekstowe (nowość)	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)
Zdjęcia miejsc	Places API (starsza wersja)	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 informacji o miejscu (nowość)
• Migracja do usługi Place Photos (nowość)
• Migracja do autouzupełniania (nowość)

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

Ta sekcja zawiera 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 SDK Miejsc na Androida (nowy) zawiera najnowsze wersje wszystkich funkcji pakietu SDK:

• Autouzupełnianie (nowość)
• Informacje o miejscu (nowe)
• Wyszukiwanie w pobliżu (nowość)
• Place Photos (nowość)
• Wyszukiwanie tekstowe (nowość)

Wyszukiwanie tekstowe (nowość)

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 „ul. Główna 123”. Usługa odpowiada listą miejsc pasujących do ciągu tekstowego i wszelkich ustawionych odchyleń lokalizacji.

Nowe dane odpowiedzi dodane do usług Informacje o miejscu (New) i Place Photos (New)

• Informacje o miejscu (nowe) zawierają teraz w odpowiedzi obiekt Place z nową klasą Review. Klasa Place zawiera nową metodę getReviews() obsługi tego pola. Wywołanie getReviews() zwraca maksymalnie 5 opinii o miejscu.

• Place Photos (New) dodaje element 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ć usługi Place Photos (New), aby zwracać identyfikator URI do bitmapy obrazu. Wcześniej można było zwrócić 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 informacje o miejscu (New) i Wyszukaj tekst (New) używasz list pól, aby określić listę pól, które mają zostać zwrócone w odpowiedzi. Opłaty są naliczane 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.

Więcej informacji o cenach znajdziesz w artykule Wykorzystanie i rozliczenia.

Rozszerzone typy miejsc

Nowy pakiet SDK zawiera nowe typy miejsc, które są zwracane w ramach odpowiedzi na zapytania o informacje o miejscu (nowe) i wyszukiwanie tekstowe (nowe). Możesz też używać tych nowych typów, a także typów dotychczasowych, w wyszukiwaniu za pomocą wyszukiwania tekstowego (nowego). Nowe typy są uwzględnione w tabeli A.