スタートガイド

Google Maps Directions API は、地点間のルートを計算するサービスで、複数の移動モード（交通機関、車、徒歩、自転車など）のルート検索に対応しています。

このサービスは、クライアント側の Google Maps JavaScript API の一部として利用可能です。または、Java Client、Python Client、Go Client および Node.js Client for Google Maps Services を使用してサーバー側で使用されます。

リクエストとレスポンスの例

Google Maps Directions API には、HTTP インターフェースを介してアクセスします。リスエストは URL 文字列として構成され、場所を特定するには、API キーに加えてテキスト文字列または緯度 / 経度座標を含めます。

次の例では、ディズニーランドからユニバーサル スタジオ ハリウッドまでの JSON 形式の運転ルートをリクエストしています。

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

お試しください。この URL をお使いのウェブブラウザに入力して、このリクエストをテストできます（‘YOUR_API_KEY’ を実際の API キーに置き換えてください）。レスポンスで、運転ルートが返されます。

リクエスト URL の作成と使用可能なパラメータおよびレスポンスの解釈の詳細については、デベロッパー ガイドをご覧ください。

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 Maps Web Services 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 キー（プレミアム プランの場合はクライアント ID）はリクエストごとに指定する必要があります。

下のボタンをクリックして、以下の処理を行ってください。

1. プロジェクトを作成または選択する
2. API を有効にする
3. API キーを取得する

キーの取得

認証資格情報の詳細。

割り当て

Google Maps Directions API に設定されている割り当ての詳細については、使用制限のページをご確認ください。

ポリシー

Google Maps Directions API を使用するには、API ポリシーに従う必要があります。

詳細を見る

Directions API には、他にもさまざまな交通手段によるルート案内のリクエスト、ウェイポイントを用いた追加ロケーションを経由するルートの計算、移動時間の推定などの機能があります。その他の例や詳細については、Directions API デベロッパー ガイドをご覧ください。