這項產品目前處於舊版狀態。自 2026 年 10 月起，新的 Google Cloud 專案將無法再啟用 Directions API (舊版)。現有專案仍完全支援。如要使用新功能及提升效能，請遷移至 Routes API。

Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

路線規劃回應

歐洲經濟區 (EEA) 開發人員

這項產品目前處於舊版狀態。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 &lt;b&gt;south&lt;/b&gt; on &lt;b&gt;S Federal St&lt;/b&gt; toward &lt;b&gt;W Van Buren St&lt;/b&gt;</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 &lt;b&gt;right&lt;/b&gt; at the 1st cross street onto &lt;b&gt;W Van Buren St&lt;/b&gt;</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

欄位	必填	類型	說明
`routes`	required	Array<DirectionsRoute>	包含從起點到目的地的路線陣列。路線由巢狀結構的路段和步驟組成。詳情請參閱 DirectionsRoute。
`status`	required	DirectionsStatus	包含要求的狀態，也可能包含偵錯資訊，方便您追查要求失敗的原因。詳情請參閱 DirectionsStatus。
`available_travel_modes`	選填	Array<TravelMode>	包含可用交通方式的陣列。如果要求指定交通方式，但未取得任何結果，系統就會傳回這個欄位。陣列包含指定路線控點組合所在國家/地區可用的交通方式。如果有一或多個路線控點是「途經路線控點」，則不會傳回這個欄位。詳情請參閱 TravelMode。
`error_message`	選填	字串	如果服務傳回 `OK` 以外的狀態碼，回應物件中可能會有額外的 `error_message` 欄位。這個欄位包含更詳細的資訊，說明指定狀態碼背後的原因。這個欄位不一定會傳回，且內容可能會有變動。
`geocoded_waypoints`	選填	Array<DirectionsGeocodedWaypoint>	包含陣列，內含起點、目的地和路線控點地理編碼的詳細資料。geocoded_waypoints 陣列中的元素會根據其從零開始的位置，對應至起點、指定順序的路線控點和目的地。如果服務未傳回任何結果，則以文字經緯度值指定的路線控點不會顯示這些詳細資料。這是因為這類路線控點只有在找到路線後，才會進行反向地理編碼，取得代表地址。空 JSON 物件會佔用 geocoded_waypoints 陣列中的對應位置。詳情請參閱 DirectionsGeocodedWaypoint。

DirectionsRoute

路徑由巢狀 legs 和 steps 組成。

欄位	必填	類型	說明
`bounds`	required	邊界	包含 `overview_polyline` 的可視區域定界框。詳情請參閱「邊界」一節。
`copyrights`	required	字串	包含這條路線中要顯示的著作權通知。您必須自行處理及顯示這項資訊。這類內容應按原樣讀取。請勿以程式輔助方式剖析這個僅供顯示的內容。
`legs`	required	Array<DirectionsLeg>	這個陣列包含指定路線中，兩個地點之間路線的路段相關資訊。每指定一個路線控點或目的地時，就會有一個不同的路段。(沒有路線控點的路線，其 legs 陣列只會包含一個路段)。每個路段包含一系列的步驟。詳情請參閱 DirectionsLeg。
`overview_polyline`	required	DirectionsPolyline	包含一個物件，其中含有路線的編碼折線表示法。這條折線是導航路線的近似 (順暢) 路徑。詳情請參閱 DirectionsPolyline。
`summary`	required	字串	包含路線的簡短文字說明，適合用於命名及區分路線與替代路線。
`warnings`	required	Array<string>	包含警告陣列，在顯示導航路線時一併顯示。您必須自行處理並顯示這些警告。
`waypoint_order`	required	Array<integer>	一個陣列，表示計算的路線中任何路線控點的順序。如果要求在路線控點參數中傳遞 optimize:true，則這些路線控點可能會重新排序。
`fare`	選填	票價	如果有的話，會包含這條路線的總車資 (也就是總票價)。這個屬性只會針對大眾運輸要求傳回，且僅適用於所有大眾運輸路段皆有車資資訊的路線。詳情請參閱「票價」。

範圍

地理座標中的矩形，由西南角和東北角的點組成。

欄位	必填	類型	說明
`northeast`	required	LatLngLiteral	詳情請參閱 LatLngLiteral。
`southwest`	required	LatLngLiteral	詳情請參閱 LatLngLiteral。

LatLngLiteral

描述特定位置的物件，經緯度以十進制度數表示。

欄位	必填	類型	說明
`lat`	required	數字	緯度 (十進制度數)
`lng`	required	數字	經度 (十進制度)

DirectionsLeg

欄位	必填	類型	說明
`end_address`	required	字串	包含這個路段 `end_location` 反向地理編碼後，產生的人類可讀地址 (通常是街道地址)。這類內容應按原樣讀取。請勿以程式輔助方式剖析格式化地址。
`end_location`	required	LatLngLiteral	這個路段指定目的地的經緯度座標。Directions API 在計算地點之間的路線時，會使用距離起點和終點最近的交通選項 (通常是道路)，因此 `end_location` 可能和這個路段的目的地不同 (例如道路不位於目的地附近)。詳情請參閱 LatLngLiteral。
`start_address`	required	字串	包含對這個路段的 `start_location` 進行反向地理編碼後，產生的清楚易懂地址 (通常是街道地址)。這類內容應按原樣讀取。請勿以程式輔助方式剖析格式化地址。
`start_location`	required	LatLngLiteral	這個路段起點的經緯度座標。Directions API 在計算地點之間的路線時，會使用距離起點和終點最近的交通選項 (通常是道路)，因此 `start_location` 可能與這個路段的起點不同 (例如道路不位於起點附近)。詳情請參閱 LatLngLiteral。
`steps`	required	<DirectionsStep> 陣列	步驟陣列，表示旅程路段中每個不同步驟的相關資訊。詳情請參閱 DirectionsStep。
`traffic_speed_entry`	選填	Array<DirectionsTrafficSpeedEntry>	已淘汰：這個陣列一律為空白。路段車速資訊。詳情請參閱 DirectionsTrafficSpeedEntry。
`via_waypoint`	required	Array<DirectionsViaWaypoint>	這個路段沿途的中途路線控點位置。詳情請參閱 DirectionsViaWaypoint。
`arrival_time`	選填	TimeZoneTextValueObject	包含這個路段的預計到達時間。只有大眾運輸路線才會傳回這個屬性。詳情請參閱 TimeZoneTextValueObject。
`departure_time`	選填	TimeZoneTextValueObject	包含這個路段的預計出發時間，以 Time 物件的形式指定。`departure_time` 僅適用於大眾運輸路線。詳情請參閱 TimeZoneTextValueObject。
`distance`	選填	TextValueObject	這個航段涵蓋的總距離。詳情請參閱 TextValueObject。
`duration`	選填	TextValueObject	這個航段的總期間。詳情請參閱 TextValueObject。
`duration_in_traffic`	選填	TextValueObject	表示這個路段所需的總時間。這個值是根據目前和歷來的路況條件，預估塞車時間。請參閱 `traffic_model` 要求參數，瞭解可用於要求傳回樂觀、悲觀或最佳猜測預估值的選項。只有符合下列所有條件時，系統才會傳回車程時間：要求不含行經停靠點的路線控點。如果要求內含路線控點，請在每個路線控點前面加上 `via:`，避免行經中途點。專為行車路線發出的要求，也就是 mode 參數設為 `driving`。要求內含 `departure_time` 參數。要求的路線可提供路況。詳情請參閱 TextValueObject。

DirectionsStep

steps 陣列中的每個元素，都定義了計算路線中的一個步驟。步驟是導航路線中最小的組成單位，其中包含單一步驟，用來描述旅程中某條具體指示。例如：「在自由路向左轉」。步驟不僅描述指示，也提供距離和所需時間相關資訊，說明目前步驟和下個步驟之間的關係。例如，在步驟「併入國道六號」中，可能包含「37 公里」和「40 分鐘」的所需時間，表示從目前步驟到下個步驟的所需時間為 37 公里/40 分鐘。

使用 Directions API 搜尋大眾運輸路線時，步驟陣列會包含額外的大眾運輸詳細資料，並以 transit_details 陣列的形式呈現。如果路線規劃包含多種交通方式，系統就會在內部步驟陣列中提供步行或行車步驟的詳細路線。舉例來說，步行步驟會包含從開始到結束地點的路線指示：「從火車站步行到 228 公園」。這個步驟會在內部步驟陣列中包含該路線的詳細步行路線，例如：「向左轉，朝館前路前進」、「請於襄陽路向左轉」以及「請於公園路向右轉」。

欄位	必填	類型	說明
`duration`	required	TextValueObject	包含執行目前步驟直到下個步驟的一般所需時間。如果沒有時間資訊，就無法定義這個欄位。詳情請參閱 TextValueObject。
`end_location`	required	LatLngLiteral	包含這個步驟最後一個點的位置。詳情請參閱 LatLngLiteral。
`html_instructions`	required	字串	包含這個步驟的格式化指示，以 HTML 文字字串表示。這類內容應按原樣讀取。請勿以程式輔助方式剖析這個僅供顯示的內容。
`polyline`	required	DirectionsPolyline	包含單一 points 物件，其中含有步驟的編碼折線表示法。這條折線是步驟的近似 (順暢) 路徑。詳情請參閱 DirectionsPolyline。
`start_location`	required	LatLngLiteral	包含目前步驟的起點位置。詳情請參閱 LatLngLiteral。
`travel_mode`	required	TravelMode	包含使用的交通工具類型。詳情請參閱 TravelMode。
`distance`	選填	TextValueObject	包含目前步驟到下個步驟所涵蓋的距離。如果沒有距離資訊，就無法定義這個欄位。詳情請參閱 TextValueObject。
`maneuver`	選填	字串	包含目前步驟要採取的動作 (左轉、匯入、直行等)。值可能隨時變更，我們也可能會在未事先通知的情況下導入新值。 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`
`steps`	選填		包含大眾運輸路線中步行或行車步驟的詳細路線。只有在 travel_mode 設為「transit」時，才會提供子步驟。內部步驟陣列與步驟類型相同。
`transit_details`	選填	DirectionsTransitDetails	如果交通方式為 `transit`，則會顯示這個步驟的相關詳細資料。詳情請參閱 DirectionsTransitDetails。

TextValueObject

包含數值和格式化文字表示法的物件。

欄位	必填	類型	說明
`text`	required	字串	字串值。
`value`	required	數字	數值。

DirectionsPolyline

折線編碼是一種有損壓縮演算法，可讓您將一系列座標儲存為單一字串。點座標是使用帶正負號的值進行編碼。如果只有幾個靜態點，也可以使用互動式折線編碼公用程式。

編碼程序會使用熟悉的 base64 編碼配置，將二進位值轉換為 ASCII 字元的一系列字元代碼：為確保這些字元正確顯示，編碼值會與 63 (ASCII 字元「?」) 相加，然後再轉換為 ASCII。演算法也會檢查每個位元組群組的最低有效位元，確認指定點是否有其他字元代碼；如果這個位元設為 1，表示該點尚未完全形成，後面必須加上其他資料。

此外，為了節省空間，點只會包含與前一個點的偏移量 (第一個點除外)。所有點都以 Base64 編碼為帶正負號的整數，因為經緯度是帶正負號的值。折線內的編碼格式必須以合理的精確度，表示經緯度這兩個座標。假設經度最大值為 +/- 180 度，精確度為小數點後 5 位 (180.00000 至 -180.00000)，則需要 32 位元帶正負號的二進位整數值。

欄位	必填	類型	說明
`points`	required	字串	折線的單一字串表示法。

TravelMode

DRIVING (預設) 表示使用路網計算。
BICYCLING 會要求計算沿途設有單車道與專用道路 (如有) 的單車路線。
TRANSIT 會要求使用大眾運輸路線 (如有) 進行計算。
WALKING 會要求計算沿途設有人行道和騎樓 (如有) 的步行路線。

DirectionsTransitDetails

與其他交通方式無關的額外資訊。

欄位	必填	類型	說明
`arrival_stop`	選填	DirectionsTransitStop	抵達的大眾運輸站。詳情請參閱 DirectionsTransitStop。
`arrival_time`	選填	TimeZoneTextValueObject	詳情請參閱 TimeZoneTextValueObject。
`departure_stop`	選填	DirectionsTransitStop	出發的大眾運輸停靠站。詳情請參閱 DirectionsTransitStop。
`departure_time`	選填	TimeZoneTextValueObject	詳情請參閱 TimeZoneTextValueObject。
`headsign`	選填	字串	指定這條路線的行進方向，如交通工具或出發站上所標示的方向。這通常是終點站。
`headway`	選填	整數	指定從目前同一站點出發的預計間隔秒數。例如，假設 `headway` 的值為 600，則表示如果錯過上一班公車，下一班預計要等 10 分鐘。
`line`	選填	DirectionsTransitLine	包含目前步驟中使用的大眾運輸路線相關資訊。詳情請參閱 DirectionsTransitLine。
`num_stops`	選填	整數	從出發站到抵達站的停靠站數量。其中包含抵達站，但不包含出發站。例如，假設您的路線是從 A 站出發，途經 B、C 兩站，最後抵達 D 站，則 `num_stops` 會傳回 3。
`trip_short_name`	選填	字串	時間表和看板上顯示的文字，可供乘客識別大眾運輸行程。文字應能識別服務日內的特定行程。舉例來說，「538」是平日 15:10 從加州聖荷西出發前往加州沙加緬度的 Amtrak 火車`trip_short_name`。

DirectionsTransitStop

欄位	必填	類型	說明
`location`	required	LatLngLiteral	停靠站的位置。詳情請參閱 LatLngLiteral。
`name`	required	字串	大眾運輸停靠站的名稱。

TimeZoneTextValueObject

包含 Unix 紀元時間、時區和格式化文字表示法的物件。

欄位	必填	類型	說明
`text`	required	字串	以字串形式指定的時間，時區與指定時區相同。
`time_zone`	required	字串	包含時區。這個值是時區名稱 (如 IANA 時區資料庫中所定義)，例如「America/New_York」。
`value`	required	數字	指定的時間，以 Unix 紀元時間表示，或自世界標準時間 1970 年 1 月 1 日午夜起算的秒數。

DirectionsTransitLine

欄位	必填	類型	說明
`agencies`	required	Array<DirectionsTransitAgency>	營運這條大眾運輸路線的運輸公司。詳情請參閱 DirectionsTransitAgency。
`name`	required	字串	這條大眾運輸路線的全名，例如「8 Avenue Local」。
`color`	選填	字串	這條路線常用的顏色。
`icon`	選填	字串	包含這條路線相關圖示的網址。
`short_name`	選填	字串	這條大眾運輸路線的簡稱。通常是一個路線編號，例如「板南線」或「237」。
`text_color`	選填	字串	這條路線常用的顏色。
`url`	選填	字串	包含這條大眾運輸路線的網址 (由運輸公司提供)。
`vehicle`	選填	DirectionsTransitVehicle	這條大眾運輸路線使用的交通工具類型。詳情請參閱 DirectionsTransitVehicle。

DirectionsTransitAgency

欄位	必填	類型	說明
`name`	選填	字串	這間運輸公司的名稱。
`phone`	選填	字串	運輸公司的電話號碼。
`url`	選填	字串	運輸公司的網址。

DirectionsTransitVehicle

欄位	必填	類型	說明
`name`	required	字串	這個交通工具的名稱，首字母大寫。
`type`	required	字串	使用的車輛類型。 `BUS` - 公車。 `CABLE_CAR` - 靠電纜運作的交通工具，通常在地面上行駛。空中纜車可視為 GONDOLA_LIFT 類型。 `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` - 地上輕軌電車。 `TROLLEYBUS` - 無軌電車。 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`
`icon`	選填	字串	包含此交通工具類型相關圖示的網址。
`local_icon`	選填	字串	包含此交通工具類型相關圖示的網址 (根據本地交通標誌)。

DirectionsTrafficSpeedEntry

欄位	必填	類型	說明
`offset_meters`	required	數字	沿著路徑的偏移量 (以公尺為單位)，這個速度類別在此範圍內有效。
`speed_category`	required	字串	這段路徑目前的車流量/車速。

DirectionsViaWaypoint

欄位	必填	類型	說明
`location`	選填	LatLngLiteral	路線控點的位置。詳情請參閱 LatLngLiteral。
`step_index`	選填	整數	包含路線控點的步驟索引。
`step_interpolation`	選填	數字	路線控點在步驟折線上的位置，以 0 到 1 的比率表示。

票價

路線的總車資。

{
  "currency" : "USD",
  "value" : 6,
  "text" : "$6.00"
}

欄位	必填	類型	說明
`currency`	required	字串	ISO 4217 貨幣代碼，表示金額採用的貨幣。
`text`	required	字串	票價總額，格式為要求的語言。
`value`	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

欄位	必填	類型	說明
`geocoder_status`	選填	字串	表示地理編碼作業產生的狀態碼。這個欄位可能包含的值如下： The allowed values include: `OK`, and `ZERO_RESULTS`
`partial_match`	選填		指出地理編碼器沒有傳回與原始要求完全比對的結果，但可以比對部分要求的地址。建議您檢查原始要求，確認是否有拼寫錯誤和/或不完整的地址。出現部分相符結果的最常見原因，是系統在要求中傳遞的縣市內找不到街道地址。如果要求比對同一個縣市內的兩個或更多地點，也可能會傳回部分相符的結果。舉例來說，「21 Henr St, Bristol, UK」會傳回 Henry Street 和 Henrietta Street 這兩項部分相符的結果。請注意，如果要求包含拼寫錯誤的地址元件，地理編碼服務可能就會建議使用替代地址。透過這種方式觸發的建議，也會標示為部分相符。
`place_id`	選填	字串	可與其他 Google API 搭配使用的專屬 ID。請參閱地點 ID 總覽。
`types`	選填	Array<string>	指出用於計算路線的地理編碼結果地址類型。 `administrative_area_level_1` 表示國家/地區層級底下的第一順位行政實體。在美國境內，這類行政層級是指州。部分國家沒有這類行政層級。在大多數情況下，administrative_area_level_1 簡稱會與 ISO 3166-2 子行政區以及其他廣泛流通的清單密切相符。然而，地理編碼結果是根據多種信號和位置資料計算得出，因此我們對於結果無法做出保證。 `administrative_area_level_2` 表示國家/地區層級底下的第二順位行政實體。在美國境內，這類行政層級是指郡。部分國家沒有這類行政層級。 `administrative_area_level_3` 表示國家/地區層級底下的第三順位行政實體。這個類型是指次級行政區。部分國家沒有這類行政層級。 `administrative_area_level_4` 表示國家/地區層級底下的第四順位行政實體。這個類型是指次級行政區。部分國家沒有這類行政層級。 `administrative_area_level_5` 表示國家/地區層級底下的第五順位行政實體。這個類型是指次級行政區。部分國家沒有這類行政層級。 `airport` 表示機場。 `colloquial_area` 表示實體的常用替代名稱。 `country` 表示國家政治實體，且通常是地理編碼器所傳回的最高順位類型。 `intersection` 表示主要的十字路口，通常有兩條主要道路交會。 `locality` 表示自治城市或鄉鎮的政治實體。 `natural_feature` 表示明顯的自然地貌。 `neighborhood` 表示具名社區 `park` 表示具名公園。 `plus_code` 表示經過編碼的位置參照，衍生自經緯度。對於沒有詳細地址的地點，Plus Codes 可用於取代街道地址，例如無編號的建築物或無名街道。詳情請參閱 https://plus.codes。 `point_of_interest` 表示具名搜尋點。一般來說，這些「搜尋點」是當地著名的實體，無法輕易歸入其他類別，例如「帝國大廈」或「艾菲爾鐵塔」。 `political` 表示政治實體。這個類型通常表示某些行政管理區的多邊形區域。 `postal_code` 表示國家/地區郵政地址所使用的郵遞區號。 `premise` 表示具名地點，通常是建築物或具有共同名稱的建築物群 `route` 表示具名道路 (例如「國道一號」)。 `street_address` 表示精確的街道地址。 `sublocality` 表示縣市底下的第一順位行政實體。某些地點可能會收到以下其中一種額外類型：sublocality_level_1 到 sublocality_level_5。每個鄉鎮市區層級都是一個行政實體。數字越大表示地理區域越小。 `subpremise` 表示具名地點底下的第一順位實體，通常是具有共同名稱的建築物群中的單一建築物 `tourist_attraction` 表示觀光景點。 `train_station` 表示火車站。 `transit_station` 表示大眾運輸站。如果類型清單為空白，表示特定地址元件沒有已知的類型 (例如法國的 Lieu-dit)。

路線規劃回應 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

回應範例

網址

curl

JSON

XML

DirectionsResponse

routes

status

available_travel_modes

error_message

geocoded_waypoints

DirectionsRoute

bounds

copyrights

legs

overview_polyline

summary

warnings

waypoint_order

fare

範圍

northeast

southwest

LatLngLiteral

lat

lng

DirectionsLeg

end_address

end_location

start_address

start_location

steps

traffic_speed_entry

via_waypoint

arrival_time

departure_time

distance

duration

duration_in_traffic

DirectionsStep

duration

end_location

html_instructions

polyline

start_location

travel_mode

distance

maneuver

steps

transit_details

TextValueObject

text

value

DirectionsPolyline

points

TravelMode

DirectionsTransitDetails

arrival_stop

arrival_time

departure_stop

departure_time

headsign

headway

line

num_stops

trip_short_name

DirectionsTransitStop

location

name

TimeZoneTextValueObject

text

time_zone

value

DirectionsTransitLine

agencies

name

color

icon

short_name

路線規劃回應

`routes`

`status`

`available_travel_modes`

`error_message`

`geocoded_waypoints`

`bounds`

`copyrights`

`legs`

`overview_polyline`

`summary`

`warnings`

`waypoint_order`

`fare`

`northeast`

`southwest`

`lat`

`lng`

`end_address`

`end_location`

`start_address`

`start_location`

`steps`

`traffic_speed_entry`

`via_waypoint`

`arrival_time`

`departure_time`

`distance`

`duration`

`duration_in_traffic`

`duration`

`end_location`

`html_instructions`

`polyline`

`start_location`

`travel_mode`

`distance`

`maneuver`

`steps`

`transit_details`

`text`

`value`

`points`

`arrival_stop`

`arrival_time`

`departure_stop`

`departure_time`

`headsign`

`headway`

`line`

`num_stops`

`trip_short_name`

`location`

`name`

`text`

`time_zone`

`value`

`agencies`

`name`

`color`

`icon`

`short_name`

`text_color`

`url`

`vehicle`

`name`

`phone`

`url`

`name`

`type`

`icon`

`local_icon`

`offset_meters`

`speed_category`

`location`

`step_index`

`step_interpolation`

`currency`

`text`

`value`