Package google.maps.locationselection.v1beta

Indeks

LocationSelectionBeta

Usługa umożliwiająca uzyskanie informacji o miejscach w pobliżu oraz powiązanych punktach odbioru i zwrotu.

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

znajdować miejsca w pobliżu danej lokalizacji;
FindPickupPointsForLocation

rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse)

znajdować punkty odbioru w danej lokalizacji;
FindPickupPointsForPlace

rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse)

Znajdź punkty odbioru dla danego miejsca.

Adres

Adres miejsca.

Pola
formatted_address

FormattedAddress

Pełny adres tego miejsca w zrozumiałej dla człowieka formie.
address_components[]

AddressComponent

Lista komponentów adresu.

AddressComponent

Komponent adresu opisujący jedną część adresu.

Pola
component_text

string

Nazwa tego komponentu opisująca część adresu. Przykłady: „California”, „Amphitheatre Parkway”.
component_text_short_form

string

Krótka forma tekstu komponentu. np. „PL” dla „Kalifornia” i „PL” dla „Polska”.
types[]

string

Typy tego komponentu opisujące część adresu. Listę obsługiwanych typów znajdziesz na stronie https://developers.google.com/places/web-service/supported_types#table2.

Kompleks budowlany

Związek powiązany z miejscem.

Pola
type

CompoundType

Typ związku.
geometry

Geometry

Geometria powiązana z związkiem.
entrances[]

Entrance

Lista wejść powiązanych z obiektem.

CompoundTypeEnums

Typy związków

CompoundType

Wartość typu złożonego.

Wartości w polu enum
COMPOUND_TYPE_UNSPECIFIED Nieznany typ związku.
SECTION Sekcja złożony. https://support.google.com/mapskb/answer/7054299
BUILDING Budynek złożony. https://support.google.com/mapskb/answer/7013011
GROUNDS Tereny kompleksowe. https://support.google.com/mapskb/answer/7046859

Wejście

Wejście do miejsca.

Pola
location

LatLng

Lokalizacja wejścia.

FindNearbyPlacesRequest

wiadomość z prośbą o wyświetlenie miejsc w pobliżu.

Pola
localization_preferences

LocalizationPreferences

Wymagane. Ustawienia używane do lokalizacji tekstu w odpowiedzi, np. imię i nazwisko oraz adres.
search_location

LatLng

Wymagane. Lokalizacja, w której mają być znalezione miejsca.
max_results

int32

Wymagane. Maksymalna liczba wyników do zwrócenia. Musi być większy niż 0.
wifi_access_points[]

WiFiAccessPoint

Punkty dostępu Wi-Fi w pobliżu lokalizacji prośby. Służy do zapewnienia wyników wyszukiwania o wyższej jakości.

FindNearbyPlacesResponse

Znajdź miejsca w pobliżu dla danej wiadomości z odpowiedzią na temat lokalizacji.

Pola
place_results[]

PlaceResult

Uporządkowana lista znalezionych miejsc. Pole może być puste, jeśli nie znaleziono żadnych miejsc wokół lokalizacji, dla której zażądano. Kolejność jest ustalana na podstawie kombinacji prawdopodobieństwa i odległości.

FindPickupPointsForLocationRequest

Komunikat z prośbą o żądanie FindPickupPointsForLocation.

Pola
localization_preferences

LocalizationPreferences

Wymagane. Ustawienia używane do lokalizacji tekstu w odpowiedzi, np. imię i nazwisko oraz adres.
search_location

LatLng

Wymagane. Lokalizacja do wyszukiwania punktów odbioru oraz obliczania odległości i czasu dotarcia do punktu odbioru.
order_by

PickupPointOrder

Wymagane. Kolejność, która ma być używana przy zwracaniu wyników.
destination

LatLng

Miejsce docelowe klienta. Ustaw, kiedy żądasz punktów odbioru posortowanych według przewidywanego czasu dotarcia do miejsca docelowego.
max_results

int32

Wymagane. Maksymalna liczba wyników do zwrócenia. Musi być większy niż 0.
travel_modes[]

TravelMode

Wymagane. Zwracane są tylko punkty odbioru, które umożliwiają co najmniej jeden z wybranych trybów podróży. Obsługiwane środki transportu: DRIVING i TWO_WHEELER. Musisz określić co najmniej 1 tryb.
compute_walking_eta

bool

Jeśli ma wartość true (prawda), obliczany jest przewidywany czas dotarcia pieszo z miejsca wyszukiwania do punktu odbioru.
compute_driving_eta

bool

Jeśli podasz wartość prawda i określisz miejsce docelowe, obliczony będzie szacowany czas dotarcia na miejsce z punktu odbioru do miejsca docelowego.
wifi_access_points[]

WiFiAccessPoint

Punkty dostępu Wi-Fi w pobliżu lokalizacji wyszukiwania. Służy do zapewnienia wyników wyszukiwania o wyższej jakości.

FindPickupPointsForLocationResponse

Znajdź punkty odbioru w odpowiedzi na wiadomość o lokalizacji.

Pola
place_pickup_point_results[]

PlacePickupPointResult

Punkty odbioru w pobliżu z powiązanym identyfikatorem miejsca. Wyniki na tej liście są uporządkowane według kryteriów podanych w zapytaniu. Liczba wyników w polu „place_pickup_point_results” może być większa niż liczba wyników w polu „place_results”.
place_results[]

PlaceResult

Szczegóły miejsc powiązanych z pobliskimi punktami odbioru. Wyniki na tej liście nie są uporządkowane.

FindPickupPointsForPlaceRequest

Wiadomość z prośbą o wyświetlenie punktów odbioru w danym miejscu.

Pola
place_id

string

Wymagane. Identyfikator miejsca, dla którego wymagane są punkty odbioru.
localization_preferences

LocalizationPreferences

Wymagane. Ustawienia używane do lokalizacji tekstu w odpowiedzi, np. imię i nazwisko oraz adres.
search_location

LatLng

Lokalizacja do wyszukiwania punktów odbioru oraz obliczania odległości i czasu dotarcia do punktu odbioru. Jeśli nie jest ustawiony, używana jest lokalizacja miejsca powiązana z danym identyfikatorem miejsca.
order_by

PickupPointOrder

Wymagane. Użyta kolejność zwracania wyników.
destination

LatLng

Miejsce docelowe klienta. Określ, czy punkty odbioru mają być sortowane według czasu dojazdu do miejsca docelowego.
max_results

int32

Wymagane. Maksymalna liczba wyników do zwrócenia. Musi być większy niż 0.
travel_modes[]

TravelMode

Wymagane. Zwracane są tylko punkty odbioru, które umożliwiają co najmniej jeden z wybranych trybów podróży. Obsługiwane środki transportu: DRIVING i TWO_WHEELER. Musisz określić co najmniej 1 tryb.
compute_walking_eta

bool

Jeśli ma wartość true (prawda), obliczany jest przewidywany czas dotarcia pieszo z miejsca wyszukiwania do punktu odbioru.
compute_driving_eta

bool

Jeśli ma wartość true i jest określony punkt docelowy, obliczany jest przewidywany czas przejazdu z miejsca odbioru do miejsca docelowego.

FindPickupPointsForPlaceResponse

Znajdź punkty odbioru w odpowiedzi na wiadomość o miejscu.

Pola
pickup_point_results[]

PickupPointResult

Punkty odbioru spełniające kryteria prośby. Może być puste, jeśli żadne punkty odbioru nie pasują do kryteriów prośby.
place_result

PlaceResult

Miejsce powiązane z podanym identyfikatorem miejsca w żądaniu.

FormattedAddress

Pełny adres nadawcy wiadomości w formie zrozumiałej dla człowieka.

Pola
lines[]

string

Wiersze tekstu opisujące adres. Musi być co najmniej 1 wiersz.

Geometria

Geometria miejsca.

Pola
location

LatLng

Główny punkt elementu zawierającego tę wiadomość.
viewport

Viewport

Widok, który umożliwia wyświetlanie miejsca na mapie o średnim rozmiarze.
display_boundary

Struct

Określa wielokąt w formacie GeoJSON Polygon.

LocalizationPreferences

Pełny adres nadawcy wiadomości w formie zrozumiałej dla człowieka.

Pola
language_code

string

Wymagane. Tag języka BCP-47 używany do lokalizowania tekstów. Przykładowe tagi językowe: „en-US”, „hi-IN”, „fr-CA” itp.
region_code

string

Wymagane. Kod kraju/regionu Unicode (CLDR) miejsca, z którego pochodzi żądanie, np. „US” i „419”.

Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#unicode_region_subtag.

PickupPoint

Szczegóły dotyczące punktu odbioru lub nadania.

Pola
id

string

Unikalny identyfikator punktu odbioru. Musi być obecna.
display_name

string

Krótka, czytelna dla człowieka nazwa punktu odbioru. Zlokalizowane zgodnie z preferencjami podanymi w żądaniu.
address

Address

Adres punktu odbioru.
description

string

dłuższy opis punktu odbioru, który może zawierać informacje o dojeździe do tego miejsca;
location

LatLng

Lokalizacja punktu odbioru, czyli miejsca, w którym pasażer lub odbiorca spotyka się z kierowcą. Musi być obecna.

PickupPointOrderEnums

Zestaw wartości określający kolejność sortowania pasujących punktów odbioru.

PickupPointOrder

Wartość zamówienia z odbiorem.

Wartości w polu enum
PICKUP_POINT_ORDER_UNSPECIFIED Nieokreślony porządek punktów odbioru. Domyślnie DISTANCE_FROM_ORIGIN.
DISTANCE_FROM_SEARCH_LOCATION rosnąco według odległości w linii prostej od miejsca wyszukiwania do zwróconego punktu odbioru;
WALKING_ETA_FROM_SEARCH_LOCATION rosnąco według czasu przejścia klienta od miejsca wyszukiwania do punktu odbioru;
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION rosnąco według czasu przejazdu od punktu odbioru do miejsca docelowego klienta; Z tego trybu można korzystać tylko wtedy, gdy ustawiono miejsce docelowe i wartość parametru compute_driving_eta jest zdefiniowana jako Prawda. Jeśli w żądaniu określono kilka trybów podróży, kolejność jest określana na podstawie pierwszego podanego w żądaniu środka transportu.

PickupPointResult

Szczegóły dotyczące wyniku wyszukiwania punktu odbioru.

Pola
pickup_point

PickupPoint

Rzeczywisty punkt odbioru pasujący do żądania.
distance_meters

float

Odległość w linii prostej od tego punktu odbioru do search_location określonego w żądaniu.
travel_details[]

TravelDetail

Szczegóły związane z podróżą do i z tego punktu odbioru w przypadku każdego żądanego środka transportu.

Miejsce

Szczegóły dotyczące miejsca.

Pola
place_id

string

Identyfikator miejsca. Identyfikator miejsca to tekst, który jednoznacznie identyfikuje miejsce. https://developers.google.com/places/web-service/place-id
display_name

string

Zlokalizowana nazwa miejsca. Zlokalizowane zgodnie z preferencjami podanymi w żądaniu.
language_code

string

Kod języka w polach tekstowych powiązanych z miejscem. Na przykład „nazwa” i „adres”.
address

Address

Adres miejsca.
geometry

Geometry

Geometria miejsca.
types[]

string

Zestaw tagów typu dla tego wyniku. Na przykład „political” i „locality”. https://developers.google.com/places/web-service/supported_types
associated_compounds[]

Compound

Związki związane z miejscem.

PlacePickupPointResult

Punkty odbioru z powiązanym identyfikatorem miejsca.

Pola
pickup_point_result

PickupPointResult

Szczegóły dotyczące punktu odbioru. To pole jest wymagane.
associated_place_id

string

Identyfikator powiązanego miejsca.

PlaceResult

Szczegóły dotyczące wyniku wyszukiwania miejsca.

Pola
place

Place

Szczegóły dotyczące miejsca.
distance_meters

float

Odległość w linii prostej od lokalizacji wyszukiwania do geometrii lub środka miejsca.

TrafficRestrictionEnums

Typy ograniczeń ruchu w lokalizacji.

TrafficRestriction

Wartość ograniczenia ruchu.

Wartości w polu enum
TRAFFIC_RESTRICTION_UNSPECIFIED Ograniczenie nie jest nieokreślone.
NO_RESTRICTION Nie są stosowane żadne ograniczenia ruchu.
OTHER_RESTRICTION Mogą obowiązywać pewne ograniczenia ruchu, np. droga może być prywatna lub dostęp do powiązanej lokalizacji może być płatny.

TravelDetail

Szczegóły związane z podróżą.

Pola
travel_mode

TravelMode

Tryb podróży, w którym obliczany jest szacowany czas dotarcia.
estimated_arrival_time

Timestamp

Szacowany czas dotarcia na miejsce. Szacowany czas dotarcia pieszo jest obliczany od lokalizacji wyszukiwania do lokalizacji punktu odbioru, gdy w żądaniu ustawiono parametr compute_walking_eta. Szacowany czas dotarcia samochodem jest obliczany od punktu odbioru do miejsca docelowego dla każdego żądanego trybu podróży niepieszej, gdy w żądaniu są ustawione parametry compute_driving_eta i destination. Szacowany czas dotarcia na miejsce jest obliczany na podstawie natężenia ruchu i NIE podlega ograniczeniom dotyczącym natężenia ruchu.
traffic_restriction

TrafficRestriction

Ograniczenie dotyczące środka transportu.

TravelModeEnums

Lista dostępnych środków transportu, które można wykorzystać w danej lokalizacji.

TravelMode

Wartość środka transportu.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie podano trybu podróży.
WALKING Chodzenie, używane w przypadku pieszych.
DRIVING Jazda samochodem osobowym.
TWO_WHEELER Dwukołowy pojazd mechaniczny (np. motocykl lub skuter).

WiFiAccessPoint

Informacje o punkcie dostępu Wi-Fi.

Pola
mac_address

int64

Adres MAC punktu dostępu.
strength_dbm

sint32

Siła sygnału punktu dostępu wyrażona w dBm.