Distance Matrix

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

DistanceMatrixService 類別

google.maps.DistanceMatrixService 類別

計算多個起點與目的地之間距離的服務。

DistanceMatrixService
DistanceMatrixService()
參數:
建立新的 DistanceMatrixService 執行個體,將距離矩陣查詢傳送至 Google 伺服器。
getDistanceMatrix
getDistanceMatrix(request[, callback])
參數:
提出距離矩陣要求。

DistanceMatrixRequest 介面

google.maps.DistanceMatrixRequest 介面介面

DistanceMatrixService 傳送的距離矩陣查詢,其中包含起點和目的地位置陣列,以及各種計算指標選項。

destinations
類型:Array<string|LatLng|LatLngLiteral|Place>
包含目的地地址字串的陣列,或 LatLngPlace 物件,用於計算距離和時間。這是必填欄位。
origins
類型:Array<string|LatLng|LatLngLiteral|Place>
包含計算原始距離字串或 LatLngPlace 物件的陣列,以用來計算距離和時間。這是必填欄位。
travelMode
類型:TravelMode
要求的路線類型。這是必填欄位。
avoidFerries optional
類型:boolean optional
如果為 true,請指示距離矩陣服務,盡可能避免搭乘渡輪。選用。
avoidHighways optional
類型:boolean optional
如果為 true,請指示距離矩陣服務,盡可能避開高速公路。選用。
avoidTolls optional
類型:boolean optional
如果為 true,則指示距離矩陣服務盡量避開收費路段。選用。
drivingOptions optional
類型:DrivingOptions optional
這些設定僅適用於 travelModeDRIVING 的要求。這個物件對其他交通方式沒有影響。
Betalanguage optional
類型:string optional
如果可行,傳回應傳回結果的語言語言 ID。請參閱支援語言清單
region optional
類型:string optional
用於地理編碼要求自訂調整的區域代碼。區域代碼接受 ccTLD (「頂層網域」) 雙字元值。多數 ccTLD 代碼與 ISO 3166-1 代碼相同,只有少數例外。舉例來說,英國的 ccTLD 是「uk」;.co.uk,而 ISO 3166-1 代碼則是「gb」。(英國為英國和北愛爾蘭的英國實體)。
transitOptions optional
類型:TransitOptions optional
這些設定僅適用於 travelMode 為 TRANSIT 的要求。這個物件對其他交通方式沒有影響。
unitSystem optional
類型:UnitSystem optional
顯示距離時使用的常用單位系統。選用,預設為公制。

DistanceMatrixResponse 介面

google.maps.DistanceMatrixResponse 介面介面

DistanceMatrixService 要求的回應,由格式化的起點和目的地地址以及 DistanceMatrixResponseRow 序列組成,分別對應到每個對應的起點地址。

destinationAddresses
類型:Array<string>
格式化的目的地地址。
originAddresses
類型:Array<string>
格式化的起點地址。
rows
對應至起點地址的矩陣列。

DistanceMatrixResponseRow 介面

google.maps.DistanceMatrixResponseRow 介面介面

回應 DistanceMatrixService 要求的一列,由 DistanceMatrixResponseElement 序列組成,每個相應的目的地位址各一個。

elements
對應目的地地址的列元素。

DistanceMatrixResponseElement 介面

google.maps.DistanceMatrixResponseElement 介面介面

回應 DistanceMatrixService 要求的單一元素,其中包含從起點到一個目的地之間的時間長度和距離。

distance
類型:Distance
此起點與目的地對組之間的距離。因為距離不明,這個屬性可能未定義。
duration
類型:Duration
此起點與目的地對組的期間。因為期間不明,這個屬性可能未定義。
duration_in_traffic
類型:Duration
這個來源與目的地配對的時間長度,會考量 trafficModel 屬性指定的流量條件。這項屬性可能為 undefined,因為時間長度可能不明。僅適用於付費方案客戶,且必須在提出要求時定義 drivingOptions
fare
類型:TransitFare
此來源-目的地配對的總費用。僅適用於大眾運輸要求。
status
此特定起點與目的地對組的狀態。

DistanceMatrixStatus 常數

google.maps.DistanceMatrixStatus 常數

完成距離矩陣要求後,DistanceMatrixService 通常會傳回要求的頂層狀態。請依據值或使用常數名稱來指定這些參數。例如 'OK'google.maps.DistanceMatrixStatus.OK

INVALID_REQUEST 提供的要求無效。
MAX_DIMENSIONS_EXCEEDED 該要求包含超過 25 個起點,或超過 25 個目的地。
MAX_ELEMENTS_EXCEEDED 起點與目的地的乘積超出每項查詢的限制。
OK 回應包含有效的結果。
OVER_QUERY_LIMIT 在允許的時段內要求了過多的元素。請稍後再試。
REQUEST_DENIED 服務拒絕您的網頁使用距離矩陣服務。
UNKNOWN_ERROR 伺服器發生錯誤,無法處理距離矩陣要求。如果您再試一次,可能會成功進行要求。

DistanceMatrixElementStatus 常數

google.maps.DistanceMatrixElementStatus 常數

完成距離矩陣要求後,DistanceMatrixService 會傳回特定來源-目的地組合的元素層級狀態。這些值會以字串的形式指定,例如 'OK'

NOT_FOUND 此起點和/或目的地對組不可進行地理編碼。
OK 回應包含有效的結果。
ZERO_RESULTS 在起點和目的地之間找不到路線。