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

Pakiet SDK Miejsc na Androida obsługuje szczegóły miejsca (starsza wersja). Jeśli znasz pakiet Places SDK na Androida (starsza wersja), Szczegóły miejsca (nowe) wprowadza te zmiany:

• Korzysta z nowego modelu cenowego. Informacje o cenach wszystkich interfejsów API znajdziesz w sekcji Places SDK na Androida (nowy).

• Musisz zainicjować aplikację, wywołując metodę Places.initializeWithNewPlacesApiEnabled(). Więcej informacji o wybieraniu usługi Places API znajdziesz w artykule Konfigurowanie projektu Google Cloud.

• Maskowanie pola jest wymagane. Musisz określić, które pola mają być zwracane 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

Każde miejsce może mieć powiązane z nim co najmniej 1 wartość typu. Pakiet SDK Miejsc Google 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 tekstowych. Zwracane wartości zależą od wersji pakietu SDK Miejsc na Androida:

• Pakiet SDK Miejsc na Androida (nowy): zwraca ciągi zdefiniowane w tabeli A i tabeli B na stronie Typy miejsc (nowe), 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 nowszych.

Dostęp do opinii o miejscu

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ć przypisanie i przypisanie autorstwa. Jeśli wyświetlasz opinię w aplikacji, musisz też podać informacje o atrybucji lub autorze. Więcej informacji znajdziesz w artykule Wyświetlanie opinii.

Więcej informacji znajdziesz w dokumentacji dotyczącej atrybucji.

Kod języka nazwy miejsca dostępu

W pakiecie SDK Miejsc na Androida (starsza wersja) 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 na liście pól w żądaniu szczegółów miejsca.

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

1. Do listy pól w żądaniu dodaj Place.Field.DISPLAY_NAME. 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(). 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 do szczegółów miejsca parametr żądania kodu regionu. Kod regionu jest używany do formatowania odpowiedzi. Jest on określany jako dwuznakowy 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, ale są pewne wyjątki. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”). Ten 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 (nowe).