開始使用

Google Maps Directions API 是計算位置之間的路線規劃的服務。您可以搜尋數種運輸模式的路線規劃，包括大眾運輸、開車、步行或騎單車。

此服務也以用戶端 Google Maps JavaScript API 之一部分的方式提供，或是搭配 Java Client、Python Client、Go Client 與 Node.js Client for Google Maps Services 針對伺服器端使用。

範例要求與回應

您可以透過 HTTP 介面搭配以網址字串建構的要求和 API 金鑰，使用文字字串或緯度/經度座標以識別位置，來存取 Google Maps Directions API。

下列範例以 JSON 格式要求查詢從迪士尼樂園到好萊塢環球影城的開車路線規劃：

https://maps.googleapis.com/maps/api/directions/json?origin=Disneyland&destination=Universal+Studios+Hollywood4&key=YOUR_API_KEY

嘗試一下！測試此要求的方法是在網頁瀏覽器輸入網址（請務必使用您的實際 API 金鑰取代 ‘YOUR_API_KEY’）。回應會傳回開車路線規劃。

查看開發人員指南，瞭解建置要求網址與可用參數的詳細資訊以及瞭解回應。

下面是 JSON 格式的範例回應：

{
   "geocoded_waypoints" : [
      {
         "geocoder_status" : "OK",
         "place_id" : "ChIJRVY_etDX3IARGYLVpoq7f68",
         "types" : [
            "bus_station",
            "transit_station",
            "point_of_interest",
            "establishment"
         ]
      },
      {
         "geocoder_status" : "OK",
         "partial_match" : true,
         "place_id" : "ChIJp2Mn4E2-woARQS2FILlxUzk",
         "types" : [ "route" ]
      }
   ],
   "routes" : [
      {
         "bounds" : {
            "northeast" : {
               "lat" : 34.1330949,
               "lng" : -117.9143879
            },
            "southwest" : {
               "lat" : 33.8068768,
               "lng" : -118.3527671
            }
         },
         "copyrights" : "Map data ©2016 Google",
         "legs" : [
            {
               "distance" : {
                  "text" : "35.9 mi",
                  "value" : 57824
               },
               "duration" : {
                  "text" : "51 mins",
                  "value" : 3062
               },
               "end_address" : "Universal Studios Blvd, Los Angeles, CA 90068, USA",
               "end_location" : {
                  "lat" : 34.1330949,
                  "lng" : -118.3524442
               },
               "start_address" : "Disneyland (Harbor Blvd.), S Harbor Blvd, Anaheim, CA 92802, USA",
               "start_location" : {
                  "lat" : 33.8098177,
                  "lng" : -117.9154353
               },

  ... Additional results truncated in this example[] ...


         "overview_polyline" : {
            "points" : "knjmEnjunUbKCfEA?_@]@kMBeE@qIIoF@wH@eFFk@WOUI_@?u@j@k@`@EXLTZHh@Y`AgApAaCrCUd@cDpDuAtAoApA{YlZiBdBaIhGkFrDeCtBuFxFmIdJmOjPaChDeBlDiAdD}ApGcDxU}@hEmAxD}[tt@yNb\\yBdEqFnJqB~DeFxMgK~VsMr[uKzVoCxEsEtG}BzCkHhKWh@]t@{AxEcClLkCjLi@`CwBfHaEzJuBdEyEhIaBnCiF|K_Oz\\
            {MdZwAbDaKbUiB|CgCnDkDbEiE|FqBlDsLdXqQra@kX|m@aF|KcHtLm@pAaE~JcTxh@w\\`v@gQv`@}F`MqK`PeGzIyGfJiG~GeLhLgIpIcE~FsDrHcFfLqDzH{CxEwAbBgC|B}F|DiQzKsbBdeA{k@~\\oc@bWoKjGaEzCoEzEwDxFsUh^wJfOySx[uBnCgCbCoFlDmDvAiCr@eRzDuNxC_EvAiFpCaC|AqGpEwHzFoQnQoTrTqBlCyDnGmCfEmDpDyGzGsIzHuZzYwBpBsC`CqBlAsBbAqCxAoBrAqDdDcNfMgHbHiPtReBtCkD|GqAhBwBzBsG~FoAhAaCbDeBvD_BlEyM``@uBvKiA~DmAlCkA|B}@lBcChHoJnXcB`GoAnIS~CIjFDd]A|QMlD{@jH[vAk@`CoGxRgPzf@aBbHoB~HeMx^eDtJ}BnG{DhJU`@mBzCoCjDaAx@mAnAgCnBmAp@uAj@{Cr@wBPkB@kBSsEW{GV}BEeCWyAWwHs@qH?
            cIHkDXuDn@mCt@mE`BsH|CyAp@}AdAaAtAy@lBg@pCa@jE]fEcBhRq@pJKlCk@hLFrB@lD_@xCeA`DoBxDaHvM_FzImDzFeCpDeC|CkExDiJrHcBtAkDpDwObVuCpFeCdHoIl\\uBjIuClJsEvMyDbMqAhEoDlJ{C|J}FlZuBfLyDlXwB~QkArG_AnDiAxC{G|OgEdLaE`LkBbEwG~KgHnLoEjGgDxCaC`BuJdFkFtCgCnBuClD_HdMqEzHcBpB_C|BuEzCmPlIuE|B_EtDeBhCgAdCw@rCi@|DSfECrCAdCS~Di@jDYhA_AlC{AxCcL`U{GvM_DjFkBzBsB`BqDhBaEfAsTvEmEr@iCr@qDrAiFnCcEzCaE~D_@JmFdGQDwBvCeErEoD|BcFjC}DbEuD~D`@Zr@h@?d@Wr@}@vAgCbEaHfMqA`Cy@dAg@bAO`@gCi@w@W"
         },
         "summary" : "I-5 N and US-101 N",
         "warnings" : [],
         "waypoint_order" : []
      }
   ],
   "status" : "OK"
}

開始使用我們的用戶端程式庫進行編碼

用戶端程式庫透過提供常見工作之簡易、原生的實作（例如驗證、要求節流與自動重試），使利用 Google 地圖 Web 服務 API 進行開發的工作變得更輕鬆。Google Maps Directions API 可從 Java Client、Python Client、Go Client 與 Node.js Client for Google Maps Services 取得。

驗證、配額與政策

啟用 API 及取得 API 金鑰

若要使用 Google Maps Directions API，您必須先在 Google API Console 中啟用 API 並取得正確的驗證憑證。您必須在每個要求中提供 API 金鑰 （或如果您有進階方案，則必須提供用戶端編號）。

按一下下面的按鈕以依序操作整個程序，您將能夠：

1. 建立或選取專案
2. 啟用 API
3. 取得 API 金鑰

取得金鑰

深入瞭解驗證憑證。

配額

查看使用限制頁面，了解為 Google Maps Directions API 設定之配額的詳細資料。

政策

使用 Google Maps Directions API 時必須符合 API 政策。

深入瞭解

使用 Directions API 還可以執行其他工作，例如要求不同旅行模式的路線規劃、使用途經地點來計算經過其他位置的路線，和估算旅行時間。請參閱 Directions API 開發人員指南，了解更多範例與其他詳細資訊。