這項產品目前處於舊版狀態。2026 年 10 月起,新的 Google Cloud 雲端專案將無法再啟用 Directions API (舊版)。現有專案仍可獲得完整支援。如要使用新功能並提升效能,請遷移至 Routes API。
回應範例
系統會根據網址要求路徑中 output 標記指示的格式,傳回路線規劃回應。
以下是 HTTP 要求範例,計算從伊利諾州芝加哥到加州洛杉磯的路線,途經密蘇里州喬普林和奧克拉荷馬州奧克拉荷馬市兩個路線控點。
網址
https://maps.googleapis.com/maps/api/directions/json ?destination=Los%20Angeles%2C%20CA &origin=Chicago%2C%20IL &waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Chicago%2C%20IL&destination=Los%20Angeles%2C%20CA&waypoints=Joplin%2C%20MO%7COklahoma%20City%2C%20OK&key=YOUR_API_KEY'
上述範例要求 JSON 輸出。您也可以要求 XML 輸出。選取下方分頁標籤,即可查看 JSON 和 XML 回應範例。
JSON
{ "geocoded_waypoints": [ { "geocoder_status": "OK", "place_id": "ChIJ7cv00DwsDogRAMDACa2m4K8", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJgdL4flSKrYcRnTpP0XQSojM", "types": ["locality", "political"], }, { "geocoder_status": "OK", "place_id": "ChIJE9on3F3HwoAR9AhGJW_fL-I", "types": ["locality", "political"], }, ], "routes": [ { "bounds": { "northeast": { "lat": 41.8781139, "lng": -87.6297872 }, "southwest": { "lat": 34.0523525, "lng": -118.2435717 }, }, "copyrights": "Map data ©2022 Google, INEGI", "legs": [ { "distance": { "text": "579 mi", "value": 932311 }, "duration": { "text": "8 hours 48 mins", "value": 31653 }, "end_address": "Joplin, MO, USA", "end_location": { "lat": 37.0842449, "lng": -94.513284 }, "start_address": "Chicago, IL, USA", "start_location": { "lat": 41.8781139, "lng": -87.6297872 }, "steps": [ { "distance": { "text": "443 ft", "value": 135 }, "duration": { "text": "1 min", "value": 24 }, "end_location": { "lat": 41.8769003, "lng": -87.6297353 }, "html_instructions": "Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b>", "polyline": { "points": "eir~FdezuOdCEjBC" }, "start_location": { "lat": 41.8781139, "lng": -87.6297872 }, "travel_mode": "DRIVING", }, { "distance": { "text": "269 ft", "value": 82 }, "duration": { "text": "1 min", "value": 20 }, "end_location": { "lat": 41.8768866, "lng": -87.63073 }, "html_instructions": "Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b>", "maneuver": "turn-right", "polyline": { "points": "sar~FzdzuO@fC?|@" }, "start_location": { "lat": 41.8769003, "lng": -87.6297353 }, "travel_mode": "DRIVING", }, // Additional steps omitted for brevity ], "traffic_speed_entry": [], "via_waypoint": [], }, // Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity ], "overview_polyline": { "points": "eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)", }, "summary": "I-55 S and I-44", "warnings": [], "waypoint_order": [0, 1], }, ], "status": "OK", }
XML
<DirectionsResponse> <status>OK</status> <route> <summary>I-55 S and I-44</summary> <leg> <step> <travel_mode>DRIVING</travel_mode> <start_location> <lat>41.8781139</lat> <lng>-87.6297872</lng> </start_location> <end_location> <lat>41.8769003</lat> <lng>-87.6297353</lng> </end_location> <polyline> <points>eir~FdezuOdCEjBC</points> </polyline> <duration> <value>24</value> <text>1 min</text> </duration> <html_instructions>Head <b>south</b> on <b>S Federal St</b> toward <b>W Van Buren St</b></html_instructions> <distance> <value>135</value> <text>443 ft</text> </distance> </step> <step> <travel_mode>DRIVING</travel_mode> <start_location> <lat>41.8769003</lat> <lng>-87.6297353</lng> </start_location> <end_location> <lat>41.8768866</lat> <lng>-87.6307300</lng> </end_location> <polyline> <points>sar~FzdzuO@fC?|@</points> </polyline> <duration> <value>20</value> <text>1 min</text> </duration> <html_instructions>Turn <b>right</b> at the 1st cross street onto <b>W Van Buren St</b></html_instructions> <distance> <value>82</value> <text>269 ft</text> </distance> <maneuver>turn-right</maneuver> </step> <!-- Additional steps omitted for brevity --> <duration> <value>31653</value> <text>8 hours 48 mins</text> </duration> <distance> <value>932311</value> <text>579 mi</text> </distance> <start_location> <lat>41.8781139</lat> <lng>-87.6297872</lng> </start_location> <end_location> <lat>37.0842449</lat> <lng>-94.5132840</lng> </end_location> <start_address>Chicago, IL, USA</start_address> <end_address>Joplin, MO, USA</end_address> </leg> <!-- Additional legs (Joplin to Oklahoma City, Oklahoma City to Los Angeles) omitted for brevity --> <copyrights>Map data ©2022 Google, INEGI</copyrights> <overview_polyline> <points>eir~FdezuOxyFzfFl`G|qZvtSzqo@d}EhlLtqIdjFhrTfvEdca@... (truncated for brevity)</points> </overview_polyline> <waypoint_index>0</waypoint_index> <waypoint_index>1</waypoint_index> <bounds> <southwest> <lat>34.0523525</lat> <lng>-118.2435717</lng> </southwest> <northeast> <lat>41.8781139</lat> <lng>-87.6297872</lng> </northeast> </bounds> </route> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJ7cv00DwsDogRAMDACa2m4K8</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJ69Pk6jdlyIcRDqM1KDY3Fpg</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJgdL4flSKrYcRnTpP0XQSojM</place_id> </geocoded_waypoint> <geocoded_waypoint> <geocoder_status>OK</geocoder_status> <type>locality</type> <type>political</type> <place_id>ChIJE9on3F3HwoAR9AhGJW_fL-I</place_id> </geocoded_waypoint> </DirectionsResponse>
這份文件的其餘部分將使用 JSON 語法。在大多數情況下,輸出格式並不影響說明文件中的概念或欄位名稱。不過,請注意下列細微差異:
- XML 結果會包裝在根
<DirectionsResponse>元素中。 - JSON 會以複數陣列 (例如
steps和legs) 表示具有多個元素的項目,而 XML 則會使用多個單數元素 (例如<step>和<leg>) 表示這些項目。 - JSON 透過
waypoint_order欄位表示路線控點順序,XML 則使用個別<waypoint_index>元素表示。 - 空白元素在 JSON 中會以空陣列表示,但在 XML 中則不會顯示任何這類元素。舉例來說,如果回應未產生任何結果,則會傳回 JSON 格式的空白
routes陣列,但不會傳回 XML 格式的<route>元素。
DirectionsResponse
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | Array<DirectionsRoute> |
包含從起點到目的地的路線陣列。路線由巢狀結構的路段和步驟組成。 詳情請參閱 DirectionsRoute。 |
|
required | DirectionsStatus |
包含要求的狀態,也可能包含偵錯資訊,方便您追查要求失敗的原因。 詳情請參閱 DirectionsStatus。 |
|
選填 | Array<TravelMode> |
包含可用交通方式的陣列。如果要求指定交通方式,但未取得任何結果,系統就會傳回這個欄位。陣列包含指定路線控點組合所在國家/地區可用的交通方式。如果有一或多個路線控點是「途經路線控點」,則不會傳回這個欄位。 詳情請參閱 TravelMode。 |
|
選填 | 字串 |
如果服務傳回 |
|
選填 | Array<DirectionsGeocodedWaypoint> |
包含陣列,內含起點、目的地和路線控點地理編碼的詳細資料。geocoded_waypoints 陣列中的元素會根據其從零開始的位置,對應至起點、指定順序的路線控點和目的地。 如果服務未傳回任何結果,則以文字經緯度值指定的路線控點不會顯示這些詳細資料。這是因為這類路線控點只有在找到路線後,才會進行反向地理編碼,取得代表地址。空 JSON 物件會佔用 geocoded_waypoints 陣列中的對應位置。 詳情請參閱 DirectionsGeocodedWaypoint。 |
DirectionsRoute
路徑由巢狀 legs 和 steps 組成。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 邊界 |
包含 詳情請參閱「邊界」一節。 |
|
required | 字串 |
包含這條路線中要顯示的著作權通知。您必須自行處理及顯示這項資訊。這類內容應按原樣讀取。請勿以程式輔助方式剖析這個僅供顯示的內容。 |
|
required | Array<DirectionsLeg> |
這個陣列包含指定路線中,兩個地點之間路線的路段相關資訊。每指定一個路線控點或目的地時,就會有一個不同的路段。(沒有路線控點的路線,其 legs 陣列只會包含一個路段)。每個路段包含一系列的步驟。 詳情請參閱 DirectionsLeg。 |
|
required | DirectionsPolyline |
包含一個物件,其中含有路線的編碼折線表示法。這條折線是導航路線的近似 (順暢) 路徑。 詳情請參閱 DirectionsPolyline。 |
|
required | 字串 |
包含路線的簡短文字說明,適合用於命名及區分路線與替代路線。 |
|
required | Array<string> |
包含警告陣列,在顯示導航路線時一併顯示。您必須自行處理並顯示這些警告。 |
|
required | Array<integer> |
一個陣列,表示計算的路線中任何路線控點的順序。如果要求在路線控點參數中傳遞 optimize:true,則這些路線控點可能會重新排序。 |
|
選填 | 票價 |
如果有的話,會包含這條路線的總車資 (也就是總票價)。 這個屬性只會針對大眾運輸要求傳回,且僅適用於所有大眾運輸路段皆有車資資訊的路線。 詳情請參閱「票價」。 |
範圍
地理座標中的矩形,由西南角和東北角的點組成。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | LatLngLiteral | 詳情請參閱 LatLngLiteral。 |
|
required | LatLngLiteral | 詳情請參閱 LatLngLiteral。 |
LatLngLiteral
描述特定位置的物件,經緯度以十進制度數表示。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 數字 |
緯度 (十進制度數) |
|
required | 數字 |
經度 (十進制度) |
DirectionsLeg
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 字串 |
包含這個路段 |
|
required | LatLngLiteral |
這個路段指定目的地的經緯度座標。Directions API 在計算地點之間的路線時,會使用距離起點和終點最近的交通選項 (通常是道路),因此 詳情請參閱 LatLngLiteral。 |
|
required | 字串 |
包含對這個路段的 |
|
required | LatLngLiteral |
這個路段起點的經緯度座標。Directions API 在計算地點之間的路線時,會使用距離起點和終點最近的交通選項 (通常是道路),因此 詳情請參閱 LatLngLiteral。 |
|
required | <DirectionsStep> 陣列 |
步驟陣列,表示旅程路段中每個不同步驟的相關資訊。 詳情請參閱 DirectionsStep。 |
|
選填 | Array<DirectionsTrafficSpeedEntry> |
路段車速資訊。 詳情請參閱 DirectionsTrafficSpeedEntry。 |
|
required | Array<DirectionsViaWaypoint> |
這個路段沿途的中途路線控點位置。 詳情請參閱 DirectionsViaWaypoint。 |
|
選填 | TimeZoneTextValueObject |
包含這個路段的預計到達時間。只有大眾運輸路線才會傳回這個屬性。 詳情請參閱 TimeZoneTextValueObject。 |
|
選填 | TimeZoneTextValueObject |
包含這個路段的預計出發時間,以 Time 物件的形式指定。 詳情請參閱 TimeZoneTextValueObject。 |
|
選填 | TextValueObject |
這個航段涵蓋的總距離。 詳情請參閱 TextValueObject。 |
|
選填 | TextValueObject |
這個航段的總期間。 詳情請參閱 TextValueObject。 |
|
選填 | TextValueObject |
表示這個路段所需的總時間。這個值是根據目前和歷來的路況條件,預估塞車時間。請參閱
詳情請參閱 TextValueObject。 |
DirectionsStep
steps 陣列中的每個元素,都定義了計算路線中的一個步驟。步驟是導航路線中最小的組成單位,其中包含單一步驟,用來描述旅程中某條具體指示。例如:「在自由路向左轉」。步驟不僅描述指示,也提供距離和所需時間相關資訊,說明目前步驟和下個步驟之間的關係。例如,在步驟「併入國道六號」中,可能包含「37 公里」和「40 分鐘」的所需時間,表示從目前步驟到下個步驟的所需時間為 37 公里/40 分鐘。
使用 Directions API 搜尋大眾運輸路線時,步驟陣列會包含額外的大眾運輸詳細資料,並以 transit_details 陣列的形式呈現。如果路線規劃包含多種交通方式,系統就會在內部步驟陣列中提供步行或行車步驟的詳細路線。舉例來說,步行步驟會包含從開始到結束地點的路線指示:「從火車站步行到 228 公園」。這個步驟會在內部步驟陣列中包含該路線的詳細步行路線,例如:「向左轉,朝館前路前進」、「請於襄陽路向左轉」以及「請於公園路向右轉」。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | TextValueObject |
包含執行目前步驟直到下個步驟的一般所需時間。如果沒有時間資訊,就無法定義這個欄位。 詳情請參閱 TextValueObject。 |
|
required | LatLngLiteral |
包含這個步驟最後一個點的位置。 詳情請參閱 LatLngLiteral。 |
|
required | 字串 |
包含這個步驟的格式化指示,以 HTML 文字字串表示。這類內容應按原樣讀取。請勿以程式輔助方式剖析這個僅供顯示的內容。 |
|
required | DirectionsPolyline |
包含單一 points 物件,其中含有步驟的編碼折線表示法。這條折線是步驟的近似 (順暢) 路徑。 詳情請參閱 DirectionsPolyline。 |
|
required | LatLngLiteral |
包含目前步驟的起點位置。 詳情請參閱 LatLngLiteral。 |
|
required | TravelMode |
包含使用的交通工具類型。 詳情請參閱 TravelMode。 |
|
選填 | TextValueObject |
包含目前步驟到下個步驟所涵蓋的距離。如果沒有距離資訊,就無法定義這個欄位。 詳情請參閱 TextValueObject。 |
|
選填 | 字串 |
包含目前步驟要採取的動作 (左轉、匯入、直行等)。 值可能隨時變更,我們也可能會在未事先通知的情況下導入新值。
The allowed values include:
turn-slight-left, turn-sharp-left,
turn-left, turn-slight-right, turn-sharp-right,
keep-right, keep-left, uturn-left,
uturn-right, turn-right, straight,
ramp-left, ramp-right, merge,
fork-left, fork-right, ferry,
ferry-train, roundabout-left, and
roundabout-right
|
|
選填 |
包含大眾運輸路線中步行或行車步驟的詳細路線。 只有在 travel_mode 設為「transit」時,才會提供子步驟。內部步驟陣列與步驟類型相同。 |
|
|
選填 | DirectionsTransitDetails |
如果交通方式為 詳情請參閱 DirectionsTransitDetails。 |
TextValueObject
包含數值和格式化文字表示法的物件。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 字串 |
字串值。 |
|
required | 數字 |
數值。 |
DirectionsPolyline
折線編碼是一種有損壓縮演算法,可讓您將一系列座標儲存為單一字串。點座標是使用帶正負號的值進行編碼。如果只有幾個靜態點,也可以使用互動式折線編碼公用程式。
編碼程序會使用熟悉的 base64 編碼配置,將二進位值轉換為 ASCII 字元的一系列字元代碼:為確保這些字元正確顯示,編碼值會與 63 (ASCII 字元「?」) 相加,然後再轉換為 ASCII。演算法也會檢查每個位元組群組的最低有效位元,確認指定點是否有其他字元代碼;如果這個位元設為 1,表示該點尚未完全形成,後面必須加上其他資料。
此外,為了節省空間,點只會包含與前一個點的偏移量 (第一個點除外)。所有點都以 Base64 編碼為帶正負號的整數,因為經緯度是帶正負號的值。折線內的編碼格式必須以合理的精確度,表示經緯度這兩個座標。假設經度最大值為 +/- 180 度,精確度為小數點後 5 位 (180.00000 至 -180.00000),則需要 32 位元帶正負號的二進位整數值。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 字串 |
折線的單一字串表示法。 |
TravelMode
DRIVING(預設) 表示使用路網計算。-
BICYCLING會要求計算沿途設有單車道與專用道路 (如有) 的單車路線。 TRANSIT會要求使用大眾運輸路線 (如有) 進行計算。-
WALKING會要求計算沿途設有人行道和騎樓 (如有) 的步行路線。
DirectionsTransitDetails
與其他交通方式無關的額外資訊。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
選填 | DirectionsTransitStop |
抵達的大眾運輸站。 詳情請參閱 DirectionsTransitStop。 |
|
選填 | TimeZoneTextValueObject | 詳情請參閱 TimeZoneTextValueObject。 |
|
選填 | DirectionsTransitStop |
出發的大眾運輸停靠站。 詳情請參閱 DirectionsTransitStop。 |
|
選填 | TimeZoneTextValueObject | 詳情請參閱 TimeZoneTextValueObject。 |
|
選填 | 字串 |
指定這條路線的行進方向,如交通工具或出發站上所標示的方向。這通常是終點站。 |
|
選填 | 整數 |
指定從目前同一站點出發的預計間隔秒數。例如,假設 |
|
選填 | DirectionsTransitLine |
包含目前步驟中使用的大眾運輸路線相關資訊。 詳情請參閱 DirectionsTransitLine。 |
|
選填 | 整數 |
從出發站到抵達站的停靠站數量。其中包含抵達站,但不包含出發站。例如,假設您的路線是從 A 站出發,途經 B、C 兩站,最後抵達 D 站,則 |
|
選填 | 字串 |
時間表和看板上顯示的文字,可供乘客識別大眾運輸行程。文字應能識別服務日內的特定行程。舉例來說,「538」是平日 15:10 從加州聖荷西出發前往加州沙加緬度的 Amtrak 火車 |
DirectionsTransitStop
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | LatLngLiteral |
停靠站的位置。 詳情請參閱 LatLngLiteral。 |
|
required | 字串 |
大眾運輸停靠站的名稱。 |
TimeZoneTextValueObject
包含 Unix 紀元時間、時區和格式化文字表示法的物件。
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 字串 |
以字串形式指定的時間,時區與指定時區相同。 |
|
required | 字串 |
包含時區。這個值是時區名稱 (如 IANA 時區資料庫中所定義),例如「America/New_York」。 |
|
required | 數字 |
指定的時間,以 Unix 紀元時間表示,或自世界標準時間 1970 年 1 月 1 日午夜起算的秒數。 |
DirectionsTransitLine
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | Array<DirectionsTransitAgency> |
營運這條大眾運輸路線的運輸公司。 詳情請參閱 DirectionsTransitAgency。 |
|
required | 字串 |
這條大眾運輸路線的全名,例如「8 Avenue Local」。 |
|
選填 | 字串 |
這條路線常用的顏色。 |
|
選填 | 字串 |
包含這條路線相關圖示的網址。 |
|
選填 | 字串 |
這條大眾運輸路線的簡稱。通常是一個路線編號,例如「板南線」或「237」。 |
|
選填 | 字串 |
這條路線常用的顏色。 |
|
選填 | 字串 |
包含這條大眾運輸路線的網址 (由運輸公司提供)。 |
|
選填 | DirectionsTransitVehicle |
這條大眾運輸路線使用的交通工具類型。 詳情請參閱 DirectionsTransitVehicle。 |
DirectionsTransitAgency
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
選填 | 字串 |
這間運輸公司的名稱。 |
|
選填 | 字串 |
運輸公司的電話號碼。 |
|
選填 | 字串 |
運輸公司的網址。 |
DirectionsTransitVehicle
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 字串 |
這個交通工具的名稱,首字母大寫。 |
|
required | 字串 |
使用的車輛類型。
The allowed values include:
BUS, CABLE_CAR,
COMMUTER_TRAIN, FERRY, FUNICULAR,
GONDOLA_LIFT, HEAVY_RAIL, HIGH_SPEED_TRAIN,
INTERCITY_BUS, LONG_DISTANCE_TRAIN, METRO_RAIL,
MONORAIL, OTHER, RAIL, SHARE_TAXI,
SUBWAY, TRAM, and
TROLLEYBUS
|
|
選填 | 字串 |
包含此交通工具類型相關圖示的網址。 |
|
選填 | 字串 |
包含此交通工具類型相關圖示的網址 (根據本地交通標誌)。 |
DirectionsTrafficSpeedEntry
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 數字 |
沿著路徑的偏移量 (以公尺為單位),這個速度類別在此範圍內有效。 |
|
required | 字串 |
這段路徑目前的車流量/車速。 |
DirectionsViaWaypoint
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
選填 | LatLngLiteral |
路線控點的位置。 詳情請參閱 LatLngLiteral。 |
|
選填 | 整數 |
包含路線控點的步驟索引。 |
|
選填 | 數字 |
路線控點在步驟折線上的位置,以 0 到 1 的比率表示。 |
票價
路線的總車資。
{
"currency" : "USD",
"value" : 6,
"text" : "$6.00"
}
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
required | 字串 |
ISO 4217 貨幣代碼,表示金額採用的貨幣。 |
|
required | 字串 |
票價總額,格式為要求的語言。 |
|
required | 數字 |
總車資金額,以上方指定的貨幣為單位。 |
DirectionsStatus
Directions 回應物件中的狀態欄位包含要求的狀態,且可能包含偵錯資訊,方便您追查 Directions 服務失敗的原因。狀態欄位可能包含下列值:
OK表示回應包含有效的結果。-
NOT_FOUND表示在要求的起點、目的地或路線控點中,有至少一個指定地點無法進行地理編碼處理。 -
ZERO_RESULTS表示系統在起點和目的地之間找不到路線。 -
MAX_WAYPOINTS_EXCEEDED表示要求中提供的路線控點過多。如果應用程式使用 Directions API 做為網路服務,或使用 Maps JavaScript API 中的路線規劃服務,則最多可包含 25 個路線控點,再加上起點和目的地。 -
MAX_ROUTE_LENGTH_EXCEEDED表示要求的路線過長,無法處理。系統傳回更複雜的路線時,就會發生這項錯誤。請嘗試減少路線控點、轉彎或指示的數量。 -
INVALID_REQUEST表示提供的要求無效。造成這種狀態的常見原因包括參數或參數值無效。 -
OVER_DAILY_LIMIT表示下列任一項目:- API 金鑰遺失或無效。
- 您的帳戶未啟用計費功能。
- 超過自行設定的用量上限。
- 您提供的付款方式已失效 (例如信用卡已過期)。
-
OVER_QUERY_LIMIT表示在允許的時間範圍內,服務收到過多來自應用程式的要求。 -
REQUEST_DENIED表示服務拒絕您的應用程式使用路線規劃服務。 -
UNKNOWN_ERROR表示伺服器發生錯誤,無法處理路線規劃要求。如果再試一次,要求可能會成功。
DirectionsGeocodedWaypoint
| 欄位 | 必填 | 類型 | 說明 |
|---|---|---|---|
|
選填 | 字串 |
表示地理編碼作業產生的狀態碼。這個欄位可能包含的值如下:
The allowed values include:
OK, and
ZERO_RESULTS
|
|
選填 |
指出地理編碼器沒有傳回與原始要求完全比對的結果,但可以比對部分要求的地址。建議您檢查原始要求,確認是否有拼寫錯誤和/或不完整的地址。 出現部分相符結果的最常見原因,是系統在要求中傳遞的縣市內找不到街道地址。如果要求比對同一個縣市內的兩個或更多地點,也可能會傳回部分相符的結果。舉例來說,「21 Henr St, Bristol, UK」會傳回 Henry Street 和 Henrietta Street 這兩項部分相符的結果。請注意,如果要求包含拼寫錯誤的地址元件,地理編碼服務可能就會建議使用替代地址。透過這種方式觸發的建議,也會標示為部分相符。 |
|
|
選填 | 字串 |
可與其他 Google API 搭配使用的專屬 ID。請參閱地點 ID 總覽。 |
|
選填 | Array<string> |
指出用於計算路線的地理編碼結果地址類型。
如果類型清單為空白,表示特定地址元件沒有已知的類型 (例如法國的 Lieu-dit)。 |