索引
LocationSelectionBeta
(介面)Address
(訊息)AddressComponent
(訊息)Compound
(訊息)CompoundTypeEnums
(訊息)CompoundTypeEnums.CompoundType
(列舉)Entrance
(訊息)FindNearbyPlacesRequest
(訊息)FindNearbyPlacesResponse
(訊息)FindPickupPointsForLocationRequest
(訊息)FindPickupPointsForLocationResponse
(訊息)FindPickupPointsForPlaceRequest
(訊息)FindPickupPointsForPlaceResponse
(訊息)FormattedAddress
(訊息)Geometry
(訊息)LocalizationPreferences
(訊息)PickupPoint
(訊息)PickupPointOrderEnums
(訊息)PickupPointOrderEnums.PickupPointOrder
(列舉)PickupPointResult
(訊息)Place
(訊息)PlacePickupPointResult
(訊息)PlaceResult
(訊息)TrafficRestrictionEnums
(訊息)TrafficRestrictionEnums.TrafficRestriction
(列舉)TravelDetail
(訊息)TravelModeEnums
(訊息)TravelModeEnums.TravelMode
(列舉)WiFiAccessPoint
(訊息)
LocationSelectionBeta
用於取得附近地點和相關的上車和下車地點的服務。
FindNearbyPlaces |
---|
尋找特定地點附近的地點。 |
FindPickupPointsForLocation |
---|
找出特定地點的上車地點。 |
FindPickupPointsForPlace |
---|
找出特定地點的上車地點, |
地址
地點的地址。
欄位 | |
---|---|
formatted_address |
這個地點的完整清楚易懂地址。 |
address_components[] |
地址元件清單。 |
AddressComponent
地址元件,用來描述地址的一部分。
欄位 | |
---|---|
component_text |
這個元件名稱,用來說明地址的一部分。例如「加州」、「Amphitheatre Parkway」。 |
component_text_short_form |
元件文字的簡短格式。例如「CA」代表「加州」,「US」代表「美國」。 |
types[] |
這個元件類型,用來說明地址的一部分。如需支援的類型的清單,請參閱 https://developers.google.com/places/web-service/supported_types#table2 |
建築
與地點相關聯的化合物。
欄位 | |
---|---|
type |
化合物類型。 |
geometry |
與化合物相關聯的幾何圖形。 |
entrances[] |
與化合物相關的入口清單。 |
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 |
入口的位置。 |
FindNearbyPlacesRequest
「尋找附近地點」要求訊息。
欄位 | |
---|---|
localization_preferences |
必要欄位。用於將回應文字 (例如姓名和地址) 本地化的偏好設定。 |
search_location |
必要欄位。待搜尋地點的位置。 |
max_results |
必要欄位。要傳回的結果數上限。必須大於 0。 |
wifi_access_points[] |
要求位置附近的 Wi-Fi 存取點。用於提供高品質的搜尋結果。 |
FindNearbyPlacesResponse
根據指定的位置回應訊息尋找附近地點。
欄位 | |
---|---|
place_results[] |
找到的地點已排序清單。如果要求位置周圍找不到地點,就可能空白。排序依據可能性和距離的組合。 |
FindPickupPointsForLocationRequest
FindPickupPointsForLocation 要求訊息。
欄位 | |
---|---|
localization_preferences |
必要欄位。用於將回應文字 (例如姓名和地址) 本地化的偏好設定。 |
search_location |
必要欄位。這個位置可用來搜尋上車地點,以及計算前往上車地點的距離和預計到達時間。 |
order_by |
必要欄位。傳回結果時使用的排序方式。 |
destination |
客戶前往的目的地位置。請在要求上車地點 (依目的地預計到達時間排序) 時設定。 |
max_results |
必要欄位。要傳回的結果數上限。必須大於 0。 |
travel_modes[] |
必要欄位。系統只會傳回允許至少一種指定交通方式的上車點。支援的交通方式:DRIVING 和 TWO_WHEELER。至少須指定一個模式。 |
compute_walking_eta |
如果為 true,則會計算從搜尋位置到取貨地點的步行預計到達時間。 |
compute_driving_eta |
如果指定 true 和目的地,系統就會計算從上車點到目的地的行車時間。 |
wifi_access_points[] |
搜尋位置附近的 Wi-Fi 存取點。用於提供高品質的搜尋結果。 |
FindPickupPointsForLocationResponse
找出位置回覆訊息的取貨地點。
欄位 | |
---|---|
place_pickup_point_results[] |
具有關聯地點 ID 的附近上車地點。這份清單中的結果會根據要求中的條件排序。「place_pickup_point_results」的結果數量可能會超過「place_results」的結果數量。 |
place_results[] |
與附近上車地點相關聯的地點詳細資料。這份清單中的結果不會排序。 |
FindPickupPointsForPlaceRequest
FindPickupPointsForPlace 要求訊息。
欄位 | |
---|---|
place_id |
必要欄位。要求取貨地點的地點 ID。 |
localization_preferences |
必要欄位。用於將回應文字 (例如姓名和地址) 本地化的偏好設定。 |
search_location |
這個位置可用來搜尋上車地點,以及計算前往上車地點的距離和預計到達時間。如未設定,系統會使用與指定地點 ID 相關聯的地點位置。 |
order_by |
必要欄位。傳回結果時使用的排序方式。 |
destination |
客戶前往的目的地位置。如果要求依目的地預計到達時間訂購取貨地點,請設定。 |
max_results |
必要欄位。要傳回的結果數上限。必須大於 0。 |
travel_modes[] |
必要欄位。系統只會傳回允許至少一種指定交通方式的上車點。支援的交通方式:DRIVING 和 TWO_WHEELER。至少須指定一個模式。 |
compute_walking_eta |
如果為 true,則會計算從搜尋位置到取貨地點的步行預計到達時間。 |
compute_driving_eta |
如果指定 true 和目的地,系統就會計算從上車點到目的地的行車時間。 |
FindPickupPointsForPlaceResponse
找出地點回應訊息的取貨地點。
欄位 | |
---|---|
pickup_point_results[] |
符合要求條件的取貨地點,如果沒有符合要求條件的上車地點,則可留空。 |
place_result |
與要求中的指定地點 ID 相關聯的地點。 |
FormattedAddress
清楚易懂的完整地址,適用於包含此訊息的實體。
欄位 | |
---|---|
lines[] |
描述地址的文字行。至少要有一行。 |
幾何圖形
地點的幾何圖形。
欄位 | |
---|---|
location |
包含這則訊息的實體中心點。 |
viewport |
適合在平均大小地圖上顯示地點的可視區域。 |
display_boundary |
使用 GeoJSON 多邊形格式指定多邊形 |
LocalizationPreferences
清楚易懂的完整地址,適用於包含此訊息的實體。
欄位 | |
---|---|
language_code |
必要欄位。用於本地化文字的 BCP-47 語言標記。語言標記範例包括「en-US」、「hi-IN」、「fr-CA」等。 |
region_code |
必要欄位。要求來源地區的萬國碼 (Unicode) 國家/地區代碼 (CLDR),例如「US」和「419」。 詳情請參閱 http://www.unicode.org/reports/tr35/#unicode_region_subtag。 |
PickupPoint
上車或下車地點詳細資料。
欄位 | |
---|---|
id |
取貨地點的專屬 ID。這是必填欄位。 |
display_name |
使用者可理解的取貨地點簡短名稱。按照要求中提供的偏好設定本地化。 |
address |
取貨地點的地址。 |
description |
取貨地點的詳細說明,包括如何前往目的地。 |
location |
上車地點的位置,乘客或接收器與司機取得的位置。這是必填欄位。 |
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 |
符合要求的實際上車點。 |
distance_meters |
從這個上車點到要求中指定的 search_location 的直線距離。 |
travel_details[] |
針對每個所要求交通方式,從這個上車點進程及出發的相關詳細資料。 |
地點
地點的詳細資訊。
欄位 | |
---|---|
place_id |
地點的地點 ID。地點 ID 是用來識別特定地點的文字,https://developers.google.com/places/web-service/place-id |
display_name |
已本地化地點的名稱。按照要求中提供的偏好設定本地化。 |
language_code |
地點相關文字欄位的語言代碼。例如「name」和「address」。 |
address |
地點的地址。 |
geometry |
地點的幾何圖形。 |
types[] |
這個結果的一組類型標記。例如「political」和「locality」。https://developers.google.com/places/web-service/supported_types |
associated_compounds[] |
與地點相關的化合物。 |
PlacePickupPointResult
附有相關地點 ID 的取貨地點。
欄位 | |
---|---|
pickup_point_result |
上車地點詳細資料。這是必填欄位。 |
associated_place_id |
相關地點的地點 ID。 |
PlaceResult
Place Search 結果的詳細資料。
欄位 | |
---|---|
place |
地點的詳細資訊。 |
distance_meters |
搜尋位置到地點幾何圖形或中心的直線距離。 |
TrafficRestrictionEnums
特定地區的流量限制類型。
TrafficRestriction
流量限制的值。
列舉 | |
---|---|
TRAFFIC_RESTRICTION_UNSPECIFIED |
未指定限制。 |
NO_RESTRICTION |
未套用任何流量限制。 |
OTHER_RESTRICTION |
部分車流量可能受限,例如道路為私人道路或使用者必須付費才能進入相關地點。 |
TravelDetail
與旅遊相關的詳細資料。
欄位 | |
---|---|
travel_mode |
用於計算預計到達時間的交通方式。 |
estimated_arrival_time |
預計抵達時間。在要求中設定了 compute_walking_eta 時,「步行 ETA」會從搜尋位置到取貨地點地點計算。在要求中設定了 compute_driving_eta 和目的地時,系統會根據每個非行人要求的交通方式,計算開車預計到達時間。開車預計到達時間是以車流量為準,因此不受壅塞限制。 |
traffic_restriction |
適用於交通方式的限制。 |
TravelModeEnums
該地點可用的交通方式清單。
TravelMode
交通方式的值。
列舉 | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
未指定交通方式。 |
WALKING |
步行,供行人使用。 |
DRIVING |
開車,用於載客車。 |
TWO_WHEELER |
重機機車 (例如摩托車或輕型摩托車)。 |
WiFiAccessPoint
Wi-Fi 存取點資訊。
欄位 | |
---|---|
mac_address |
存取點的 MAC 位址。 |
strength_dbm |
存取點的訊號強度,單位為 dBm。 |