Wybierz wersję pakietu SDK

Funkcje pakietu Places SDK dla Androida dostępne w Twojej aplikacji określane na podstawie kombinacji numeru wersji pakietu SDK (np. 3.5.0) używanego przez określone w konfiguracji aplikacji, interfejsy API włączone w kluczu interfejsu API oraz sposób zainicjować aplikację. W tym przewodniku objaśniamy różnice między wersjami Jak wybrać wersje, które są włączone w aplikacji.

Numery wersji pakietu SDK

Numer wersji pakietu SDK określony w kompilacji build.gradle na poziomie aplikacji określa, czy aplikacja ma dostęp do funkcji dodanych w konkretnej wersji. Na przykład autouzupełnianie (nowość) jest dostępne tylko w pakiecie SDK wersji 3.5.0 lub nowszej.

Więcej informacji o zmianach wprowadzonych w poszczególnych wersjach pakietu SDK znajdziesz w sekcji Miejsca Wersja pakietu SDK na Androida notatki.

Wersje interfejsu Places API dla pakietu SDK Places na Androida

Oprócz określenia wersji pakietu SDK musisz też wybrać usługa interfejsu API wywoływana przez pakiet SDK w konsoli Google Cloud: interfejs Places API lub Places API (nowość). Wraz z numerem wersji pakietu SDK i usługą interfejsu API określa, która wersja określonych funkcji jest dostępna w aplikacji, takich jak Autouzupełnianie lub Autouzupełnianie (nowość). Możesz określić tylko jeden pakiet SDK. możesz włączyć interfejs Places API i Places API (nową wersję) na swoim API, a następnie wybierz usługę, za pomocą której wywołuje pakiet SDK. Metodę używaną do inicjowania pakietu SDK w aplikacji. Jednak w większości przypadków warto włączyć interfejs Places API (nową) i użyć (nowych) wersji interfejsu funkcje pakietu SDK w aplikacji.

Wybierz wersję pakietu SDK i usługi interfejsu API

Aby wybrać funkcje pakietu SDK dostępne w Twojej aplikacji:

  1. W projekcie Google Cloud włącz interfejs Places API, Places API (nowość) lub i jednym, i drugim. Więcej informacji znajdziesz w sekcji Włączanie Interfejsy API
  2. W ograniczeniach klucza interfejsu API włącz Places API, Places API (nowość) lub i jednym, i drugim. Więcej informacji znajdziesz w artykule o ograniczaniu interfejsu API .
  3. W pliku build.gradle na poziomie aplikacji podaj numer wersji. Więcej Więcej informacji zawiera Instalacja.

  4. Zainicjuj aplikację przez wywołanie Places.initializeWithNewPlacesApiEnabled() lub Places.initialize() .

Więcej informacji o wyborze usługi Places API znajdziesz w artykule Konfigurowanie Projekt Google Cloud.

Funkcje pakietu SDK dostępne w poszczególnych wersjach

W tabeli poniżej pokazujemy, które wersje pakietu SDK i interfejsu API są wymagane w przypadku poszczególnych pakietów SDK cecha:

Funkcja Interfejs Places API został włączony 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()

Uwagi dotyczące wyboru wersji do włączenia

Aby zdecydować, którą wersję wybrać, weź pod uwagę te kwestie:

  • Jeśli jesteś nowym klientem i dopiero zaczynasz korzystać z pakietu SDK Miejsc na Androida, użyj interfejsu Places API (nowego) i nowego pakietu SDK.
  • Jeśli jesteś obecnym klientem, możesz dalej korzystać z obecnego pakietu SDK. Jednak aby zacząć korzystać z udoskonalonej funkcji i funkcji ulepszeń pakietu SDK Miejsc dla systemu Android (nowość), użyj nowej SDK. Przy przejściu na nowy pakiet SDK nie jest konieczna migracja. Wystarczy wykonać czynności opisane w artykule Wybieranie wersji pakietu SDK i interfejsu API usługi.
  • W pakiecie SDK Miejsc dla systemu Android tokeny sesji są dostępne od w wersji 3.5.0. Więcej informacji można znaleźć w sekcji Sesja tokeny.
  • Połączenia wykonywane za pomocą widżetów autouzupełniania miejsc zawsze mają nazwę Place autouzupełniania, a nie Autouzupełnianie miejsc (nowe); na wywołania widżetu nie mają wpływu metody inicjowania.
  • Zdjęcia miejsc (nowość) zwraca identyfikator URI tylko do obrazu bitmapy, a Place Zdjęcia zwracają tylko mapę bitową. .
  • Obecne miejsce to jest dostępna tylko w pakiecie SDK Miejsc dla systemu Android; nie jest dostępna w pakiecie SDK Miejsc na Androida (Nowość).

Ulepszenia pakietu SDK Miejsc na Androida (nowość)

W tej sekcji omawiamy najważniejsze funkcje dodane do pakietu SDK Miejsc na Androida (nowość).

Wdrożony na standardowej platformie Google Cloud

W usłudze wdrożono pakiet SDK Miejsc na Androida (nowość) infrastruktura w Google Cloud. Ta implementacja zapewnia bezpieczniejszą i bezpieczniejszą platformę. Ta standardowa konstrukcja zapewnia pewien poziom spójności we wszystkich pakietach SDK, wydajność programowania z pakietem SDK Miejsc na Androida (Nowość).

Poprawiona wydajność

Pakiet Places SDK na Androida (nowość) zapewnia większą wydajność, dzięki czemu warto zastąpić aplikacje, które korzystają z dotychczasowych pakietów SDK.

Nowe funkcje

Pakiet SDK Miejsc na Androida (nowość) zawiera najnowsze wersje wszystkich pakietów SDK funkcje:

Nowa usługa wyszukiwania tekstowego

Wyszukiwanie tekstowe (nowość) zwraca informacje informacji o zestawie miejsc na podstawie ciągu znaków, np. „pizza w Gdańsku” lub „sklepy obuwnicze w okolicy” lub „ulica Główna 123”. Usługa wysyła w odpowiedzi listę z wszystkich miejsc pasujących do ciągu tekstowego i z ustawionym odchyleniem lokalizacji.

Dodaliśmy nowe dane odpowiedzi do szczegółów miejsc (nowość) i zdjęć miejsc (nowość)

Dodano nową odpowiedź URI do Zdjęć miejsc (nowość)

Teraz możesz używać Zdjęcie miejsca (Nowość) zwracanie identyfikatora URI do mapy bitowej obrazu. Wcześniej można było zwrócić tylko bitmapy obrazu.

Uproszczone ustalanie cen

W przypadku pakietu SDK Miejsc dla systemu Android (nowego) cennik jest upraszczany, dzięki czemu reklamodawca płacić za dane, których używasz. Uproszczone ustalanie cen jest wdrażane za pomocą list pól, nazywane też maskami pola.

Ze szczegółami miejsca oraz Wyszukiwanie tekstowe wykorzystuje listy pól do kontrolowania listy które mają być zwracane w odpowiedzi. Opłaty są naliczane tylko za te dane. poproszono o dostęp. Dobrą praktyką jest użycie listy pól, dzięki której żądać zbędnych danych, co pozwala uniknąć niepotrzebnego czasu przetwarzania opłaty rozliczeniowe.

Szczegółowe informacje o cenach obu pakietów SDK znajdziesz w artykule Korzystanie z Płatności.

Rozszerzone typy miejsc

Nowy pakiet SDK dodaje typy miejsc podane w tabeli poniżej. Te typy są zwracanych w ramach szczegółów miejsca, a Odpowiedź dotycząca wyszukiwania tekstowego. Możesz również używać nowych typów metod, i ich istniejących typów. Nowe typy zostały uwzględnione w tabeli O.

Typ
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant gospodarstwo rolne korean_restaurant sporting_goods_store
barber_shop agroturystyka lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal market steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant krawiec
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant motel thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
konsultant heliport plac zabaw vegetarian_restaurant
convention_center hiking_area przedszkole vietnamese_restaurant
chata historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center hostel resort_hotel hurtownia
dental_clinic hotel rest_stop

Oprócz tych nowych typów interfejs Places API (nowość) przeniósł następujące typy z tabeli 2 interfejsu Places API do tabeli A dla interfejsu Places API (nowego). Oznacza to, że możesz teraz korzystać z tych typów treści w ramach szukaj:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality