Package google.maps.locationselection.v1beta

索引

LocationSelection (Beta 版)

提供附近地點和相關接送/下車地點的服務。

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

尋找特定地點附近的地點。
FindPickupPointsForLocation

rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse)

找出特定地點的上車地點。
FindPickupPointsForPlace

rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse)

找出指定地點的上車地點。

地址

地點的地址。

欄位
formatted_address

FormattedAddress

這個地點的完整地址，可供人類閱讀。
address_components[]

AddressComponent

地址元件清單。

AddressComponent

地址元件，用於描述地址的某個部分。

欄位
component_text

string

此元件的名稱，用於描述地址的部分內容。例如「California」、「Amphitheatre Parkway」。
component_text_short_form

string

元件文字的簡短形式。例如「加州」代表「CA」，「US」則代表「美國」。
types[]

string

這個元件描述地址的類型。如需支援的類型清單，請參閱 https://developers.google.com/places/web-service/supported_types#table2

建築

與地點相關的複合體。

欄位
type

CompoundType

化合物的類型。
geometry

Geometry

與複合體相關聯的幾何圖形。
entrances[]

Entrance

與化合物相關聯的入口清單。

CompoundTypeEnums

化合物的類型

CompoundType

複合類型的值。

列舉
COMPOUND_TYPE_UNSPECIFIED 複合類型不明。
SECTION 複合部分。https://support.google.com/mapskb/answer/7054299
BUILDING 複合建築物。https://support.google.com/mapskb/answer/7013011
GROUNDS 複合地面。https://support.google.com/mapskb/answer/7046859

入口

地點入口。

欄位
location

LatLng

入口的位置。

FindNearbyPlacesRequest

尋找附近地點要求訊息。

欄位
localization_preferences

LocalizationPreferences

必要欄位。用於將回應中的文字本地化的偏好設定，例如名稱和地址。
search_location

LatLng

必要欄位。需要尋找地點的位置。
max_results

int32

必要欄位。要傳回的結果數上限。必須大於 0。
wifi_access_points[]

WiFiAccessPoint

要求位置附近的 Wi-Fi 存取點。用於提供更優質的搜尋結果。

FindNearbyPlacesResponse

為指定位置回應訊息尋找附近地點。

欄位
place_results[]

PlaceResult

找到的地點排序清單。如果在要求位置附近找不到任何地點，則為空白。排序依據為機率和距離的組合。

FindPickupPointsForLocationRequest

FindPickupPointsForLocation 要求訊息。

欄位
localization_preferences

LocalizationPreferences

必要欄位。用於將回應中的文字本地化的偏好設定，例如名稱和地址。
search_location

LatLng

必要欄位。用於搜尋取貨點，以及計算距離和預計到達取貨地點的位置。
order_by

PickupPointOrder

必要欄位。傳回結果時使用的排序方式。
destination

LatLng

客戶的預定目的地位置。在要求乘車地點時，將其依目的地預估抵達時間排序。
max_results

int32

必要欄位。要傳回的結果數上限。必須大於 0。
travel_modes[]

TravelMode

必要欄位。系統只會傳回允許至少一種指定交通工具的接送地點。支援的交通模式：DRIVING 和 TWO_WHEELER。至少須指定一個模式。
compute_walking_eta

bool

如果為 true，系統會計算從搜尋位置到上車點的步行預估到達時間。
compute_driving_eta

bool

如果為 true 且已指定目的地，系統會計算從上車地點到目的地的預估車程時間。
wifi_access_points[]

WiFiAccessPoint

搜尋位置周圍的 Wi-Fi 存取點。用於提供更優質的搜尋結果。

FindPickupPointsForLocationResponse

找出所在位置回應訊息的上車地點。

欄位
place_pickup_point_results[]

PlacePickupPointResult

附近的取貨地點，以及相關聯的地點 ID。系統會根據要求中的條件排序這份清單中的結果。'place_pickup_point_results' 中的結果數量可能會超過 'place_results' 中的結果數量。
place_results[]

PlaceResult

與附近上車地點相關聯的地點詳細資料。這份清單中的結果並未依序排列。

FindPickupPointsForPlaceRequest

FindPickupPointsForPlace 要求訊息。

欄位
place_id

string

必要欄位。要求上車地點的地點 ID。
localization_preferences

LocalizationPreferences

必要欄位。用於將回應中的文字本地化的偏好設定，例如名稱和地址。
search_location

LatLng

用於搜尋取貨點，以及計算距離和預計到達取貨地點的位置。如果未設定，系統會使用與指定地點 ID 相關聯的地點位置。
order_by

PickupPointOrder

必要欄位。傳回結果時使用的排序方式。
destination

LatLng

客戶的預定目的地位置。設定是否要求按照目的地預計到達時間訂購取貨點。
max_results

int32

必要欄位。要傳回的結果數上限。必須大於 0。
travel_modes[]

TravelMode

必要欄位。系統只會傳回允許至少一種指定交通工具的接送地點。支援的交通模式：DRIVING 和 TWO_WHEELER。至少須指定一個模式。
compute_walking_eta

bool

如果為 true，系統會計算從搜尋位置到上車點的步行預估到達時間。
compute_driving_eta

bool

如果為 true 且已指定目的地，系統會計算從上車地點到目的地的預估車程時間。

FindPickupPointsForPlaceResponse

找出地點回應訊息的上車地點。

欄位
pickup_point_results[]

PickupPointResult

符合要求條件的上車地點。如果沒有符合要求條件的上車地點，這個值可能會為空白。
place_result

PlaceResult

與指定地點 ID 相關聯的地點。

FormattedAddress

一般且使用者可理解的完整地址，適用於包含這則訊息的實體。

欄位
lines[]

string

描述地址的文字行。至少須顯示一行。

幾何圖形

地點的幾何圖形。

欄位
location

LatLng

包含此訊息的實體的中心點。
viewport

Viewport

適合在平均大小地圖上顯示地點的可視區域。
display_boundary

Struct

使用 GeoJSON 多邊形格式指定多邊形

LocalizationPreferences

包含此訊息的實體的完整地址，可供人類閱讀。

欄位
language_code

string

必要欄位。用於本地化文字的 BCP-47 語言標記。語言代碼的範例包括「en-US」、「hi-IN」、「fr-CA」等。
region_code

string

必要欄位。發出要求的地點的 Unicode 國家/地區代碼 (CLDR)，例如「US」和「419」。

詳情請參閱 http://www.unicode.org/reports/tr35/#unicode_region_subtag。

PickupPoint

上車或下車地點的詳細資料。

欄位
id

string

接送地點的專屬 ID。必填項目。
display_name

string

簡短的接送地點名稱，方便使用者閱讀。請根據要求中提供的偏好設定提供本地化內容。
address

Address

取車地點的地址。
description

string

接送地點的詳細說明，可能包含前往該地點的方式。
location

LatLng

上車地點的位置，即乘客或接收者與司機會面的位置。必填項目。

PickupPointOrderEnums

一組值，用於指定相符的接送地點排序順序。

PickupPointOrder

接送地點順序的值。

列舉
PICKUP_POINT_ORDER_UNSPECIFIED 未指定取貨點順序。預設為 DISTANCE_FROM_ORIGIN。
DISTANCE_FROM_SEARCH_LOCATION 從搜尋地點到返回的接送地點，以直線距離排序 (由近至遠)。
WALKING_ETA_FROM_SEARCH_LOCATION 依消費者從搜尋地點到上車地點的步行時間，由低至高排序。
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION 依據從上車地點到消費者目的地的預估車程時間排序，由低至高。只有在設定目的地且 compute_driving_eta 為 true 時，才能使用這個模式。如果要求中提供多個 travel_mode，排序會以要求中的首個 travel_mode 為依據。

PickupPointResult

上車地點搜尋結果的詳細資料。

欄位
pickup_point

PickupPoint

符合要求的實際上車地點。
distance_meters

float

從此取貨點到要求中指定的 search_location 之間的直線距離。
travel_details[]

TravelDetail

各交通方式的往返這個上車地點詳細資料。

地點

地點詳細資料。

欄位
place_id

string

地點 ID。地點 ID 是用來識別特定地點的文字。https://developers.google.com/places/web-service/place-id
display_name

string

經過本地化的地點名稱。依據要求中提供的偏好設定進行本地化。
language_code

string

與地點相關聯的文字欄位語言代碼。例如「name」和「address」。
address

Address

地點的地址。
geometry

Geometry

地點的幾何圖形。
types[]

string

此結果的類型標記組合。例如「政治」和「行政區劃」。https://developers.google.com/places/web-service/supported_types
associated_compounds[]

Compound

與地點相關的化合物。

PlacePickupPointResult

含有相關地點 ID 的接送地點。

欄位
pickup_point_result

PickupPointResult

接送地點的詳細資料。這是必填欄位。
associated_place_id

string

相關地點的地點 ID。

PlaceResult

地點搜尋結果的詳細資料。

欄位
place

Place

地點詳細資料。
distance_meters

float

從搜尋位置到地點幾何圖形或中心的直線距離。

TrafficRestrictionEnums

地點的車流量限制類型。

TrafficRestriction

流量限制的值。

列舉
TRAFFIC_RESTRICTION_UNSPECIFIED 限制並非未指定。
NO_RESTRICTION 不會套用流量限制。
OTHER_RESTRICTION 可能會受到某些交通限制，例如道路屬於私人所有，或前往相關地點需支付費用。

TravelDetail

與旅遊相關的詳細資料。

欄位
travel_mode

TravelMode

用來計算預計到達時間的交通方式。
estimated_arrival_time

Timestamp

預計到達時間。在要求中設定 compute_walking_eta 時，系統會計算從搜尋位置到上車地點的步行預估時間。在要求行程模式為非行人時，如果在要求中設定了 compute_driving_eta 和目的地，系統會計算從上車地點到目的地的預估行車時間。開車預估抵達時間會考量交通狀況，且不受壅塞限制影響。
traffic_restriction

TrafficRestriction

適用於旅遊模式的限制。

TravelModeEnums

前往某個地點時可使用的交通方式清單。

TravelMode

交通模式的值。

列舉
TRAVEL_MODE_UNSPECIFIED 未指定交通方式。
WALKING 步行，供行人使用。
DRIVING Driving，用於乘用車。
TWO_WHEELER 機動二輪車 (例如摩托車或輕型機車)。

WiFiAccessPoint

Wi-Fi 存取點資訊。

欄位
mac_address

int64

存取點的 MAC 位址。
strength_dbm

sint32

存取點的訊號強度 (以 dBm 為單位)。