Pakiet Places SDK umożliwia wyszukiwanie i pobieranie informacji o różnych typach miejsc za pomocą ciągu tekstowego lub na podstawie bliskości. Pakiet SDK Miejsc to starsza wersja pakietu SDK Miejsc (nowy).
Z tego przewodnika dowiesz się, jakie są główne różnice między wersjami pakietu Places SDK i jak przejść na nową wersję tego pakietu.
Funkcje pakietu SDK dostępne w poszczególnych wersjach
W poniższej tabeli znajdziesz informacje o tym, których wersji pakietu SDK i interfejsu API wymagają poszczególne funkcje pakietu SDK:
| Funkcja | Places API włączone w kluczu interfejsu API | Metoda inicjowania | Minimalna wersja pakietu SDK |
|---|---|---|---|
| Autouzupełnianie (nowa wersja) | Places API (nowość) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Szczegóły miejsca (nowa) | Places API (nowość) | initializeWithNewPlacesApiEnabled() |
3.3.0 |
| Wyszukiwanie w pobliżu (nowość) | Places API (nowość) | initializeWithNewPlacesApiEnabled() |
3.5.0 |
| Umieszczanie zdjęć (nowość) | Places API (nowość) | initializeWithNewPlacesApiEnabled() |
3.4.0 |
| Wyszukiwanie tekstu (nowa funkcja) | 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 miejsca | Places API | initialize() |
Migracja do nowych interfejsów API
Aby przejść na nowe interfejsy API, zapoznaj się z tymi przewodnikami po migracji:
- Migracja do Szczegółów miejsca (nowa)
- Migracja na zdjęcie lokalizacji (nowa)
- Migracja na autouzupełnianie (nowa wersja)
Ulepszenia w pakiecie Places SDK na Androida (nowość)
Ta sekcja zawiera najważniejsze funkcje dodane do pakietu SDK Miejsc na Androida (nowy).
Wdrożone na platformie standardowej Google Cloud
Pakiet SDK Miejsc na Androida (nowy) jest implementowany w infrastrukturze usługi w Google Cloud. Dzięki temu wdrożeniu platforma jest bezpieczniejsza i bardziej zaufana. Ten standardowy interfejs zapewnia spójność pakietów SDK, co zwiększa wydajność tworzenia aplikacji za pomocą pakietu SDK Miejsc na Androida (nowy).
Poprawiona wydajność
Pakiet SDK Miejsc na Androida (nowy) zapewnia lepszą wydajność, dzięki czemu warto zastąpić aplikacje, które korzystają z dotychczasowego pakietu SDK.
Nowe funkcje
Pakiet SDK Miejsca na Androida (nowy) zawiera najnowsze wersje wszystkich funkcji pakietu SDK:
- Autouzupełnianie (nowa wersja)
- Szczegóły miejsca (nowa)
- Wyszukiwanie w pobliżu (nowość)
- Umieszczanie zdjęć (nowość)
- Wyszukiwanie tekstu (nowa funkcja)
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 Ulica Główna”. Usługa zwraca listę miejsc pasujących do ciągu tekstowego i współrzędnych lokalizacji.
nowe dane odpowiedzi dodane do Szczegółów miejsca (nowy) i Zdjęć miejsca (nowy);
Szczegóły miejsca (nowa wersja) zawiera teraz nową klasę Review w obiekcie
Placew odpowiedzi. Klasa Place zawiera nową metodęgetReviews(), która obsługuje to pole. WywołajgetReviews(), aby uzyskać maksymalnie 5 opinii o danym miejscu.Umieszczanie zdjęcia (nowa funkcja) umożliwia dodanie zdjęcia
AuthorAttributionsdo klasyPhotoMetadata.AuthorAttributionszawieraListAuthorAttributionobiektów.
Dodano nową odpowiedź URI do zdjęć miejsc (nowa wersja)
Teraz możesz użyć metody Place Photo (Nowa), aby zwrócić identyfikator URI bitmapy obrazu. Wcześniej można było zwrócić tylko samą bitmapę obrazu.
Uproszczone ustalanie cen
Pakiet Places SDK na Androida (nowy) upraszcza cennik, dzięki czemu płacisz tylko za używane dane. Uproszczone ceny są wdrażane za pomocą list pól, zwanych też maskami pól.
W przypadku zapytań Szczegóły miejsca i Wyszukiwanie tekstowe możesz używać list pól, aby kontrolować listę pól zwracanych w odpowiedzi. Następnie naliczymy opłatę tylko za żądane dane. Korzystanie z listy pól to dobra praktyka projektowania, która pozwala uniknąć żądania niepotrzebnych danych, co z kolei pozwala uniknąć niepotrzebnego czasu przetwarzania i 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 na zapytanie dotyczące szczegółów miejsca i wyszukiwania tekstowego. Możesz też używać tych nowych typów oraz dotychczasowych typów w wyszukiwaniu z wykorzystaniem wyszukiwania tekstowego. Nowe typy znajdują się w tabeli A.