Pakiet SDK Miejsc na Androida obsługuje dotychczasowe szczegóły miejsca. Jeśli znasz dotychczasowy pakiet Places SDK na Androida, nowa wersja funkcji Szczegóły miejsca wprowadza następujące zmiany:
Używa nowego modelu cenowego. Informacje o cenach wszystkich interfejsów API znajdziesz w pakiecie SDK Places na Androida (nowy).
Aplikację musisz zainicjować, wywołując metodę
Places.initializeWithNewPlacesApiEnabled(). Więcej informacji o wybieraniu usługi Places API znajdziesz w artykule Konfigurowanie projektu Google Cloud.Maskowanie pól jest wymagane. W odpowiedzi musisz określić, które pola mają zostać zwrócone. Nie ma domyślnej listy zwracanych pól. Jeśli pominiesz tę listę, metody zwrócą błąd.
W następnych sekcjach opisano dodatkowe zmiany.
Dostęp do nowych typów miejsc
Z każdym miejscem może być powiązana co najmniej 1 wartość type. Pakiet SDK Places na Androida w wersji 3.3.0 i nowszych zawiera wiele nowych wartości typu. Pełną listę znajdziesz w sekcji Rozszerzone typy miejsc.
Metoda Place.getPlaceTypes() zwraca wartości typu jako listę wartości ciągu znaków. Zwracane wartości zależą od wersji pakietu Places SDK na Androida:
Pakiet SDK Miejsc na Androida (nowy): zwraca ciągi znaków zdefiniowane w tabeli A i tabeli B w sekcji Typy miejsc (nowy), w tym wszystkie typy miejsc dodane w wersji 3.3.0.
Pakiet SDK Miejsc na Androida: zwraca wyliczenia zdefiniowane przez
Place.Types, które nie obejmują nowych typów dodanych w wersji 3.3.0 i później.
Dostęp do opinii o miejscach
Nowy zestaw Places SDK na Androida zawiera klasę Review, która zawiera opinię o miejscu. Obiekt Place może zawierać maksymalnie 5 opinii.
Klasa Review może też zawierać informacje o źródle i autorze. Jeśli wyświetlasz opinię w aplikacji, musisz też wyświetlić informacje o źródle lub autora. Więcej informacji znajdziesz w artykule Wyświetlanie opinii.
Więcej informacji znajdziesz w dokumentacji dotyczącej przypisywania atrybucji.
Dostęp do kodu języka nazwy miejsca
Metoda Place.getName() zwraca ciąg tekstowy zawierający nazwę miejsca. Aby wypełnić obiekt Place nazwą miejsca, musisz uwzględnić Place.Field.DISPLAY_NAME w liście pól żądania informacji o miejscu.
Obiekt Place zawiera teraz kod języka dla ciągu znaków nazwy. Aby wypełnić obiekt Place kodem języka:
Uwzględnij pole
Place.Field.DISPLAY_NAMEna liście pól żądania. Ta wartość konfiguruje odpowiedź, aby zawierała zarówno nazwę miejsca, jak i kod języka w obiekciePlace.Zadzwoń pod numer
PlacesClient.fetchPlace().PlacesClient.findCurrentPlace()nie obsługuje pola kodu języka.Aby uzyskać dostęp do pola kodu języka w obiekcie
Place, użyj metodyPlace.getNameLanguageCode().
Ustawianie kodu regionu
Pakiet SDK Places na Androida (nowy) dodaje parametr żądania kodu regionu do szczegółów miejsca. Kod regionu służy do formatowania odpowiedzi i jest podawany jako 2-znakowy kod CLDR. Ten parametr może też wpływać na wyniki wyszukiwania. Nie ma wartości domyślnej. Aby ustawić kod regionu, musisz włączyć nowy pakiet SDK.
Jeśli nazwa kraju w polu adresu w odpowiedzi jest zgodna z kodem regionu, kod kraju jest pomijany w adresie.
Większość kodów CLDR jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład domena ccTLD Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Wielka Brytania i Irlandia Północna”). Parametr może wpływać na wyniki w zależności od obowiązujących przepisów.
Przykładowe żądanie
Pełny przykład znajdziesz w sekcji Szczegóły miejsca (nowa wersja).