Pakiet SDK Miejsc na Androida (starszy) obsługuje informacje o miejscu (starsze). Jeśli znasz informacje o miejscu (starsza wersja), informacje o miejscu (nowa wersja) wprowadza te zmiany:
Korzysta z nowego modelu cenowego. Informacje o cenach wszystkich interfejsów API znajdziesz w sekcji Wykorzystanie i rozliczenia.
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 ciągu tekstowego. 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 (starszy): 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
zawierającą opinię o miejscu. Obiekt Place może zawierać maksymalnie 5 opinii.
Klasa Review może też zawierać przypisanie autorstwa i przypisanie autorstwa do autora. Jeśli wyświetlasz opinię w aplikacji, musisz też wyświetlać informacje o atrybucji lub autorze. Więcej informacji znajdziesz w artykule Wyświetlanie opinii.
Więcej informacji znajdziesz w dokumentacji dotyczącej atrybucji.
Uzyskiwanie kodu języka nazwy miejsca
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 z nazwą. Aby wypełnić obiekt Place kodem języka, musisz:
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 obiekciePlace.Zadzwoń pod numer
PlacesClient.fetchPlace().PlacesClient.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 do informacji o miejscu 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, z kilkoma istotnymi wyjątkami. 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”). Parametr może wpływać na wyniki na podstawie obowiązujących przepisów.
Przykładowe żądanie
Pełny przykład znajdziesz w sekcji Informacje o miejscu (starsza wersja).