Przenieś do Szczegółów miejsca (nowość)

Pakiet SDK Miejsc na Androida obsługuje dotychczasowe szczegóły miejsca. Jeśli znasz dotychczasowy pakiet SDK Miejsc na Androida, w nowej wersji funkcji Szczegóły miejsca wprowadzono te zmiany:

• Używa nowego modelu cenowego. Informacje o cenach wszystkich interfejsów API znajdziesz w artykule Pakiet SDK Miejsc 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. Musisz określić, które pola mają zostać zwrócone w odpowiedzi. Nie ma domyślnej listy zwracanych pól. Jeśli pominiesz tę listę, metody zwrócą błąd.

W sekcjach poniżej opisujemy dodatkowe zmiany.

Dostęp do nowych typów miejsc

Z każdą lokalizacją 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 artykule 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 SDK Miejsc 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

Pakiet SDK Miejsc na Androida (nowy) 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ż podać informacje o źródle lub autora. Więcej informacji znajdziesz w artykule Wyświetlanie opinii.

Więcej informacji znajdziesz w dokumentacji dotyczącej przypisywania zasług.

Kod języka nazwy miejsca

Istniejąca 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 szczegółów miejsca.

Obiekt Place zawiera teraz kod języka dla ciągu tekstowego nazwy. Aby wypełnić obiekt Place kodem języka:

1. Uwzględnij pole Place.Field.DISPLAY_NAME na liście pól żądania. Ta wartość konfiguruje odpowiedź tak, aby zawierała zarówno nazwę miejsca, jak i kod języka w obiekcie Place.

2. Zadzwoń pod numer PlacesClient.fetchPlace(). Funkcja PlacesClient.findCurrentPlace() nie obsługuje pola kodu języka.

3. Użyj metody Place.getNameLanguageCode(), aby uzyskać dostęp do pola kodu języka w obiekcie Place.

Ustawianie kodu regionu

Pakiet SDK Miejsc 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 pasuje do kodu 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 ccTLD Wielkiej Brytanii to „uk” (.co.uk), a jej kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”). Parametr może wpływać na wyniki na podstawie obowiązującego prawa.

Przykładowe żądanie

Pełny przykład znajdziesz w sekcji Szczegóły miejsca (nowa wersja).