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()
Aktualne miejsce Places API initialize()
Szczegóły miejsca Places API initialize()
Zdjęcia miejsc Places API initialize()

Przejście na nowe interfejsy API

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

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

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

Wdrożone na standardowej platformie Google Cloud

Pakiet SDK Miejsc na Androida (nowy) jest zaimplementowany w infrastrukturze usługi w Google Cloud. Dzięki temu platforma jest bezpieczniejsza i bardziej wiarygodna. Ten standardowy projekt zapewnia spójność pakietów SDK, co zwiększa wydajność programowania za pomocą 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 obecnego pakietu SDK.

Nowe funkcje

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

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

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

  • Szczegóły miejsca (nowość) obejmują teraz w odpowiedzi obiekt Place nowej klasy Review. Klasa Place zawiera nową metodę getReviews(), która obsługuje to pole. Wywołaj funkcję Call getReviews(), aby zwrócić maksymalnie 5 opinii o miejscu.

  • Place Photo (Nowość) dodaje element AuthorAttributions do klasy PhotoMetadata. AuthorAttributions zawiera List obiektów AuthorAttribution.

Dodano nową odpowiedź URI do usługi Zdjęcia miejsc (nowa)

Możesz teraz użyć funkcji Place Photo (nowość), aby zwrócić 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 Place Details i Text Search używasz list pól, aby kontrolować listę pól, które mają być zwracane w odpowiedzi. Wtedy opłaty będą naliczane tylko za dane, o które poprosisz. Korzystanie z listy pól to dobra praktyka projektowania, która pozwala uniknąć wysyłania żądań dotyczących niepotrzebnych danych. 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 Użycie i rozliczenia.

Rozszerzone typy miejsc

Nowy pakiet SDK zawiera nowe typy miejsc, które są zwracane w ramach odpowiedzi na zapytania o szczegóły miejsca 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.