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 następujące zmiany:
Korzysta z 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 recenzji.
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 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ź tak, aby zawierała zarówno nazwę miejsca, jak i kod języka w obiekciePlace.Zadzwoń pod numer
PlacesClient.fetchPlace(). FunkcjaPlacesClient.findCurrentPlace()nie obsługuje pola kodu języka.Użyj metody
Place.getNameLanguageCode(), aby uzyskać dostęp do pola kodu języka w obiekciePlace.
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ących przepisów.
Przykładowe żądanie
Pełny przykład znajdziesz w sekcji Szczegóły miejsca (nowa wersja).