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) |
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
Placez nową klasą Review. Klasa Place zawiera nową metodęgetReviews()obsługi tego pola. WywołaniegetReviews()zwraca maksymalnie 5 opinii o miejscu.Place Photos (New) dodaje element
AuthorAttributionsdo klasyPhotoMetadata.AuthorAttributionszawieraListobiektówAuthorAttribution.
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.