Package google.maps.locationselection.v1beta

Indeks

LocationSelectionBeta

Usługa uzyskiwania informacji o miejscach w pobliżu oraz powiązanych z nimi punktów odbioru i zwrotu.

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

Znajdź miejsca w pobliżu dla danej lokalizacji.

FindPickupPointsForLocation

rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse)

Znajdź punkty odbioru dla danej lokalizacji.

FindPickupPointsForPlace

rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse)

Znajdź punkty odbioru dla danego miejsca.

Adres

Adres miejsca.

Pola
formatted_address

FormattedAddress

Pełny, czytelny dla człowieka adres tego miejsca.

address_components[]

AddressComponent

Lista komponentów adresu.

AddressComponent

Składnik adresu opisujący jedną część adresu.

Pola
component_text

string

Nazwa tego komponentu opisująca część adresu. Przykłady to „Kalifornia”, „Emilii Plater 23”.

component_text_short_form

string

Skrócona forma tekstu komponentu. Przykłady: „CA” dla „Kalifornii” i „US” w przypadku Polski.

types[]

string

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

Kompleks budowlany

Kompleks związany z miejscem.

Pola
type

CompoundType

Rodzaj związku.

geometry

Geometry

Geometria powiązana z związkiem.

entrances[]

Entrance

Lista wejść powiązanych z kompleksem.

CompoundTypeEnums

Rodzaje związków chemicznych

CompoundType

Wartość typu związku.

Wartości w polu enum
COMPOUND_TYPE_UNSPECIFIED Nieznany typ związku.
SECTION Złożona część. https://support.google.com/mapskb/answer/7054299
BUILDING Kompleks budynków (https://support.google.com/mapskb/answer/7013011)
GROUNDS Tereny kompleksu (https://support.google.com/mapskb/answer/7046859)

Wejście

Wejście do danego miejsca.

Pola
location

LatLng

Lokalizacja wejścia.

FindNearbyPlacesRequest

Komunikat z prośbą o znalezienie miejsc w pobliżu.

Pola
localization_preferences

LocalizationPreferences

To pole jest wymagane. Preferencje używane do lokalizowania tekstów w odpowiedzi, np. imienia i nazwiska oraz adresu.

search_location

LatLng

To pole jest wymagane. Lokalizacja, w której należy znaleźć miejsca.

max_results

int32

To pole jest 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 żądania. Służy do poprawy jakości wyników wyszukiwania.

FindNearbyPlacesResponse

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

Pola
place_results[]

PlaceResult

Uporządkowana lista miejsc znalezionych. Pole może być puste, jeśli nie znaleziono żadnych miejsc w pobliżu lokalizacji żądania. Ich kolejność zależy od prawdopodobieństwa i odległości.

FindPickupPointsForLocationRequest

Komunikat z żądaniem usługi FindPickupPointsForLocation.

Pola
localization_preferences

LocalizationPreferences

To pole jest wymagane. Preferencje używane do lokalizowania tekstów w odpowiedzi, np. imienia i nazwiska oraz adresu.

search_location

LatLng

To pole jest wymagane. Lokalizacja używana do wyszukiwania punktów odbioru oraz obliczania odległości i szacowanego czasu dotarcia do punktów odbioru.

order_by

PickupPointOrder

To pole jest wymagane. Kolejność użycia przy zwracaniu wyników.

destination

LatLng

Zamierzona lokalizacja klienta. Ustaw, gdy chcesz poprosić o punkty odbioru posortowane według szacowanego czasu dotarcia na miejsce.

max_results

int32

To pole jest wymagane. Maksymalna liczba wyników do zwrócenia. Musi być większy niż 0.

travel_modes[]

TravelMode

To pole jest wymagane. Zwracane są tylko punkty odbioru, które umożliwiają korzystanie z co najmniej jednego z podanych środków transportu. Obsługiwane tryby podróży: DRIVING i TWO_WHEELER. Musisz określić co najmniej 1 tryb.

compute_walking_eta

bool

Jeśli ma wartość prawda, oblicza się szacowany czas dotarcia z lokalizacji wyszukiwania do punktu odbioru.

compute_driving_eta

bool

Jeśli określone są wartości prawda i miejsce docelowe, obliczany jest szacowany czas dotarcia z punktu odbioru do miejsca docelowego.

wifi_access_points[]

WiFiAccessPoint

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

FindPickupPointsForLocationResponse

Znajdź punkty odbioru dla wiadomości z odpowiedzią z lokalizacją.

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 żądaniu. Liczba wyników w atrybucie „place_pickup_point_results” może być większa niż liczba wyników w atrybucie „place_results”.

place_results[]

PlaceResult

Szczegółowe informacje o miejscach powiązanych z pobliskimi punktami odbioru. Wyniki na tej liście nie są uporządkowane.

FindPickupPointsForPlaceRequest

Wiadomość z prośbą FindPickupPointsForPlace.

Pola
place_id

string

To pole jest wymagane. Identyfikator miejsca, w przypadku którego wymagane są punkty odbioru.

localization_preferences

LocalizationPreferences

To pole jest wymagane. Preferencje używane do lokalizowania tekstów w odpowiedzi, np. imienia i nazwiska oraz adresu.

search_location

LatLng

Lokalizacja używana do wyszukiwania punktów odbioru oraz obliczania odległości i szacowanego czasu dotarcia do punktów odbioru. Jeśli jej nie skonfigurujesz, zostanie użyta lokalizacja miejsca powiązanego z danym identyfikatorem miejsca.

order_by

PickupPointOrder

To pole jest wymagane. Kolejność użycia przy zwracaniu wyników.

destination

LatLng

Zamierzona lokalizacja klienta. Ustaw, jeśli chcesz zamówić punkty odbioru według szacowanego czasu dotarcia na miejsce.

max_results

int32

To pole jest wymagane. Maksymalna liczba wyników do zwrócenia. Musi być większy niż 0.

travel_modes[]

TravelMode

To pole jest wymagane. Zwracane są tylko punkty odbioru, które umożliwiają korzystanie z co najmniej jednego z podanych środków transportu. Obsługiwane tryby podróży: DRIVING i TWO_WHEELER. Musisz określić co najmniej 1 tryb.

compute_walking_eta

bool

Jeśli ma wartość prawda, oblicza się szacowany czas dotarcia z lokalizacji wyszukiwania do punktu odbioru.

compute_driving_eta

bool

Jeśli określone są wartości prawda i miejsce docelowe, obliczany jest szacowany czas dotarcia z punktu odbioru do miejsca docelowego.

FindPickupPointsForPlaceResponse

Znajdź punkty odbioru dla wiadomości z odpowiedzią dotyczącą miejsca.

Pola
pickup_point_results[]

PickupPointResult

Punkty odbioru spełniające kryteria. Pole może być puste, jeśli żaden punkt odbioru nie spełnia kryteriów żądania.

place_result

PlaceResult

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

FormattedAddress

Pełny, czytelny dla człowieka adres jednostki zawierającej tę wiadomość.

Pola
lines[]

string

Wiersze tekstu opisujące adres. Wymagany jest co najmniej 1 wiersz.

Geometria

Geometria miejsca.

Pola
location

LatLng

Centralny punkt jednostki zawierającej tę wiadomość.

viewport

Viewport

Widoczny obszar umożliwiający wyświetlanie miejsca na mapie średniej wielkości.

display_boundary

Struct

Określa wielokąt w formacie GeoJSON Polygon

LocalizationPreferences

Pełny, czytelny dla człowieka adres jednostki zawierającej tę wiadomość.

Pola
language_code

string

To pole jest wymagane. Tag języka BCP-47 używany do lokalizowania tekstów. Przykłady tagów języka to „en-US”, „hi-IN”, „fr-CA” itp.

region_code

string

To pole jest wymagane. Kod Unicode kraju/regionu (CLDR) lokalizacji, z której pochodzi żądanie, np. „US” lub „419”.

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

PickupPoint

Informacje o miejscu odbioru lub odbioru.

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 tym, jak dotrzeć na miejsce.

location

LatLng

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

PickupPointOrderEnums

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

PickupPointOrder

Wartość zamówienia z punktem odbioru.

Wartości w polu enum
PICKUP_POINT_ORDER_UNSPECIFIED Nie określono zamówienia w punkcie odbioru. Domyślna wartość to DISTANCE_FROM_ORIGIN.
DISTANCE_FROM_SEARCH_LOCATION Rosnąco według odległości od lokalizacji wyszukiwania do zwróconego punktu odbioru.
WALKING_ETA_FROM_SEARCH_LOCATION Rosnąco według czasu przejścia piechotą od miejsca wyszukiwania do punktu odbioru.
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION Rosnąco według trasy dojazdu z punktu odbioru do miejsca docelowego konsumenta. Tego trybu można używać tylko wtedy, gdy ustawione jest miejsce docelowe, a parametr compute_driving_eta ma wartość prawda. Jeśli w żądaniu podano wiele trybów podróży, kolejność jest określana na podstawie pierwszego parametru travel_mode w żądaniu.

PickupPointResult

Szczegółowe informacje o wyniku wyszukiwania punktu odbioru.

Pola
pickup_point

PickupPoint

Rzeczywisty punkt odbioru zgodny z żądaniem.

distance_meters

float

Odległość w linii prostej od tego punktu odbioru do lokalizacji search_location określonej w żądaniu.

travel_details[]

TravelDetail

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

Miejsce

Szczegółowe informacje o miejscu.

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 „imię i nazwisko” oraz „adres”.

address

Address

Adres miejsca.

geometry

Geometry

Geometria miejsca.

types[]

string

Zestaw tagów typów dla tego wyniku. Na przykład „polityczne” i „locality”. https://developers.google.com/places/web-service/supported_types

associated_compounds[]

Compound

Związki powiązane z tym miejscem.

PlacePickupPointResult

Punkty odbioru z powiązanym identyfikatorem miejsca.

Pola
pickup_point_result

PickupPointResult

Informacje o punkcie odbioru. Musi być obecna.

associated_place_id

string

Identyfikator powiązanego miejsca.

PlaceResult

Szczegółowe informacje o wynikach wyszukiwania miejsc.

Pola
place

Place

Szczegółowe informacje o miejscu.

distance_meters

float

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

TrafficRestrictionEnums

Typy ograniczeń ruchu dla danej lokalizacji.

TrafficRestriction

Wartość ograniczenia ruchu.

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

TravelDetail

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

Pola
travel_mode

TravelMode

Środek podróży, w którym oblicza się szacowany czas dotarcia.

estimated_arrival_time

Timestamp

Szacowany czas dotarcia na miejsce. Szacowany czas dotarcia na miejsce jest obliczany na podstawie lokalizacji wyszukiwania do lokalizacji punktu odbioru, jeśli w żądaniu ustawiono wartość compute_walking_eta. Szacowany czas dotarcia na miejsce jest obliczany od lokalizacji punktu odbioru do miejsca docelowego w przypadku każdego żądanego trybu podróży dla niepełnosprawnych, jeśli w żądaniu określono opcję compute_driving_eta i miejsce docelowe. Szacowany czas dotarcia na miejsce jest obliczany na podstawie natężenia ruchu i NIE podlega ograniczeniom dotyczącym korków.

traffic_restriction

TrafficRestriction

Ograniczenie dotyczące środka transportu.

TravelModeEnums

Lista środków transportu dostępnych podczas podróży do wybranej lokalizacji.

TravelMode

Wartość środka transportu.

Wartości w polu enum
TRAVEL_MODE_UNSPECIFIED Nie podano środka transportu.
WALKING Pieszo, używane dla pieszych.
DRIVING Samochód, używany w samochodach osobowych.
TWO_WHEELER Motocykl z silnikiem (np. motocykl lub motorower).

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 w dBm.