このプロダクトはレガシーステータスです。2026 年 10 月以降、新しい Google Cloud プロジェクトで Directions API（レガシー）を有効にすることはできなくなります。既存のプロジェクトは引き続き完全にサポートされます。新機能とパフォーマンスの向上については、Routes API に移行してください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

ルートの例

欧州経済領域（EEA）のデベロッパー

このプロダクトはレガシーステータスです。2026 年 10 月以降、新しい Google Cloud プロジェクトで Directions API（従来版）を有効にすることはできなくなります。既存のプロジェクトは引き続き完全にサポートされます。新機能とパフォーマンスの向上をご希望の場合は、Routes API に移行してください。

リクエストの例

次のリクエストは、オンタリオ州トロントからケベック州モントリオールまでの運転ルートを返します。

URL

https://maps.googleapis.com/maps/api/directions/json?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY'

mode パラメータと avoid パラメータを変更することで、最初のルート検索リクエストを変更して、主要な高速道路を避けた景色の良い自転車ルートを返すことができます。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?avoid=highways
  &destination=Montreal
  &mode=bicycling
  &origin=Toronto
  &key=YOUR_API_KEYYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&avoid=highways&mode=bicycling&key=YOUR_API_KEY'YOUR_API_KEY'

次のリクエストは、ニューヨークのブルックリンからニューヨークのクイーンズまでの乗換案内を検索します。リクエストで departure_time が指定されていないため、出発時刻はデフォルトで現在の時刻になります。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&keyYOUR_API_KEY'

次の乗換案内リクエストには、特定の出発時刻が含まれています。

注: この例では、出発時刻を 2012 年 7 月 30 日午前 9 時 45 分に指定しています。エラーを回避するには、リクエストを送信する前に、パラメータを将来の時刻に変更する必要があります。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=1343641500
  &destination=Queens
  &mode=transit
  &origin=Brooklyn
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Brooklyn&destination=Queens&mode=transit&departure_time=1343641500&key=YOUR_API_KEY'

次のリクエストでは、Plus Codes を使用して、インドのコルカタにある H8MW+WP から GCG2+3M までの運転ルートを返します。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=GCG2%2B3M%20Kolkata%20India
  &origin=H8MW%2BWP%20Kolkata%20India
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=H8MW%2BWP%20Kolkata%20India&destination=GCG2%2B3M%20Kolkata%20India&key=YOUR_API_KEY'

次のリクエストは、プレイス ID を使用して、英国のグラスゴーから英国のパースまでの運転ルートを返します。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y
  &origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE
  &keyYOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=place_id%3AChIJ685WIFYViEgRHlHvBbiD5nE&destination=place_id%3AChIJA01I-8YVhkgRGJb0fW4UX7Y&key=YOUR_API_KEY'

移動手段

ルートを計算するときは、使用する移動手段 mode を指定できます。デフォルトでは、driving のルートが計算されます。次の移動手段がサポートされています。

driving（デフォルト）は、道路網を利用した標準の運転ルートを示します。
walking は、歩行者専用道路と歩道（利用可能な場合）を通る徒歩経路をリクエストします。
bicycling は、自転車専用道路と優先道路（利用可能な場合）を使って自転車ルートをリクエストします。
transit は、公共交通機関を使用するルートをリクエストします（利用可能な場合）。モードを transit に設定する場合は、必要に応じて departure_time または arrival_time を指定できます。どちらの時刻も指定されていない場合、departure_time はデフォルトで現在時刻になります（つまり、出発時刻はデフォルトで現在時刻になります）。必要に応じて、transit_mode や transit_routing_preference を含めることもできます。

注: 徒歩経路と自転車ルートには、明確な歩道や自転車道が含まれていないことがあるため、これらのルートをリクエストすると、返される結果に warnings が含まれます。この警告はユーザーに表示する必要があります。

交通情報

次のすべてがあてはまる場合に交通情報が使用されます（Directions のレスポンスで duration_in_traffic フィールドを取得するには、これらの条件を満たす必要があります）。

travel mode パラメータが driving、または指定されていない（デフォルトの移動手段は driving）。
リクエストに有効な departure_time パラメータが含まれている。departure_time には、現在時刻または将来の時刻を設定できます。過去の時刻は指定できません。
リクエストに立ち寄り地点が含まれていない。リクエストに地点が含まれている場合は、立ち寄らずに経由するだけであることを示すため、各地点に接頭詞として via: を付ける必要があります。例:
```
&waypoints=via:San Francisco|via:Mountain View|...
```

必要に応じて、リクエストに traffic_model パラメータを含めて、所要時間を計算する上での仮定条件を指定できます。

次の URL は、マサチューセッツ州ボストンからマサチューセッツ州コンコードまで、チャールズタウンとレキシントンを経由するルートを検索する Directions リクエストを開始します。リクエストには出発時刻が含まれており、Directions レスポンスで duration_in_traffic フィールドを返すためのすべての要件を満たしています。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?departure_time=now
  &destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&departure_time=now&key=YOUR_API_KEY'

ウェイポイント

。

Directions API（レガシー）を使用してルートを計算するときに、ウェイポイントを指定して、中間地点の通過または立ち寄りを含むルートを返すことができます。地点は、車、徒歩、自転車ルートには追加できますが、乗換案内には追加できません。

`waypoints` パラメータでロケーションを指定します。

1 つ以上の場所を、プレイス ID、住所、緯度/経度座標の形式で、パイプ文字（| または %7C）で区切って指定できます。デフォルトでは、指定した地点を指定した順番で通るルートが計算されます。ウェイポイントの値を解析する際の優先順位は、プレイス ID、緯度と経度の座標、住所の順です。

プレイス ID を渡す場合は、先頭に place_id: を付ける必要があります。プレイス ID は、Geocoding API と Places API（Place Autocomplete を含む）から取得できます。Place Autocomplete から取得したプレイス ID の使用例については、Place Autocomplete とルートをご覧ください。プレイス ID について詳しくは、プレイス ID の概要をご覧ください。
効率性と正確性を高めるため、可能な場合はプレイス ID を使用してください。これらの ID は、緯度/経度の値のペアのように一意に明示され、アクセスポイントや交通変数などのルート設定にジオコーディングのメリットをもたらします。住所とは異なり、ID を使用する場合は、サービスが検索を実行したり、場所の詳細をリクエストしたりする必要がないため、パフォーマンスが向上します。
緯度と経度の座標を渡すと、その値はフロントエンドサーバーに直接送信され、ジオコーディングなしでルートが計算されます。ポイントは道路にスナップされるため、アプリに必要な精度が得られない場合があります。座標は、アクセスポイントや追加のジオコーディングの詳細を考慮せずに、アプリがルート設定に必要なポイントを正確に指定していることが確実な場合に使用します。緯度と経度の値がスペース（%20）ではなくカンマ（%2C）で区切られていることを確認します。
住所を渡すと、Directions サービスは文字列をジオコーディングし、緯度と経度の座標に変換してルートを計算します。住所の値が曖昧な場合、類似した住所との曖昧さを解消するために検索が呼び出されることがあります。たとえば、「1st Street」は完全な値である場合もあれば、「1st street NE」や「1st St SE」の部分的な値である場合もあります。この結果は、Geocoding API から返される結果とは異なる場合があります。プレイス ID を使用すると、誤解を避けることができます。ルートリクエストの結果のトラブルシューティングをご覧ください。

または、エンコード化ポリラインアルゴリズムを使用して、エンコードされた一連のポイントを指定することもできます。エンコードされたセットは、URL が大幅に短くなるため、多数のウェイポイントがある場合に便利です。すべてのウェブサービスで、URL の文字数制限は 16,384 文字です。

エンコードされたポリラインの先頭には enc: を付け、その後にコロン（:）を付ける必要があります。例: waypoints=enc:gfo}EtohhU:。
複数のエンコードされたポリラインをパイプ文字（|）で区切って指定することもできます。例: waypoints=via:enc:wc~oAwquwMdlTxiKtqLyiK:|enc:c~vnAamswMvlTor@tjGi}L:| via:enc:udymA{~bxM:

次の URL は、マサチューセッツ州ボストンからマサチューセッツ州コンコードまでのルートを、チャールズタウン、レキシントンの順に経由して検索する Directions リクエストを開始します。この例では、次のアドレスを使用します。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=via%3ACharlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

経由地と通過地点を指定してルートを調整する

リクエスト内の各ウェイポイントについて、ルート案内レスポンスは legs 配列にエントリを追加して、その区間の経由地の詳細を提供します。

立ち寄り地点を追加せずに、ウェイポイントを使用してルートに影響を与える場合は、ウェイポイントに接頭辞 via: を追加します。via: が先頭に付加されたウェイポイントは、legs 配列にエントリを追加しませんが、ウェイポイントを経由するルートを生成します。

次の URL は、レキシントンを通過するルートを生成するように、前のリクエストを変更したものです。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Concord%2C%20MA
  &origin=Boston%2C%20MA
  &waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Boston%2C%20MA&destination=Concord%2C%20MA&waypoints=Charlestown%2CMA%7Cvia%3ALexington%2CMA&key=YOUR_API_KEY'

via: 接頭辞は、ユーザーが地図上でウェイポイントをドラッグしたときにルートを作成する場合に最も効果的です。これにより、ユーザーは最終的なルートをリアルタイムで確認でき、Directions API（従来版）でアクセス可能な場所にウェイポイントを配置できます。

注意: 立ち寄りを避けるために via: 接頭辞を使用すると、地点の解釈が厳密なルートになります。これにより、かなりの回り道になったり、Directions API（従来版）がその地点を通過するルートを作成できない場合に、ZERO_RESULTS というレスポンスのステータスコードが返されたりすることになります。

次の URL は、緯度/経度座標を使用してウェイポイントをリクエストします。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3A-37.81223%2C144.96254%7Cvia%3A-34.92788%2C138.60008&key=YOUR_API_KEY'

以下は、同じリクエストですがエンコードしたポリラインを使用しています。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=via%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

via: 指定子とロケーション修飾子は自由に組み合わせることができます。次に例を示します。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Perth%2C%20AU
  &origin=Sydney%2C%20AU
  &waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Sydney%2C%20AU&destination=Perth%2C%20AU&waypoints=side_of_road%3Avia%3Aenc%3AlexeF%7B~wsZejrPjtye%40%3A&key=YOUR_API_KEY'

ウェイポイントを最適化する

デフォルトでは、指定した地点を指定した順番で通るルートが計算されます。オプションで、optimize:true を waypoints パラメータ内の最初の引数として渡すと、ルートサービスで、より効率的な順序に地点を並べ替えて、指定されたルートを最適化できます（この最適化には巡回セールスマン問題が応用されています）。最適化で最も重視されるのは移動時間ですが、最も効率的なルートを判断する際は、距離や進路変更の回数なども考慮される場合があります。ルートサービスでルートを最適化するには、すべての地点が立ち寄り場所である必要があります。

ルートサービスで地点の順序を最適化するよう指定した場合は、その順序が routes オブジェクト内の waypoint_order フィールドで返されます。waypoint_order フィールドは、ゼロベースの値を返します。

次の例では、ルート最適化を使用して、南オーストラリア州のアデレードから南オーストラリア州の主要なワイン産地への道路移動を計算します。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Adelaide%2C%20SA
  &origin=Adelaide%2C%20SA
  &waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Adelaide%2C%20SA&destination=Adelaide%2C%20SA&waypoints=optimize%3Atrue%7CBarossa%20Valley%2C%20SA%7CClare%2C%20SA%7CConnawarra%2C%20SA%7CMcLaren%20Vale%2C%20SA&key=YOUR_API_KEY'

計算されたルートを調べると、計算では次のウェイポイント順序でウェイポイントが使用されていることがわかります。

"waypoint_order": [ 3, 2, 0, 1 ]

。

制限事項

特定の制限に準拠したルートが計算される場合があります。制限は、avoid パラメータと、回避する制限を示すパラメータの引数を使用して指定します。サポートされる制限は次のとおりです。

avoid=tolls
avoid=highways
avoid=ferries

有料道路、高速道路、フェリーの任意の組み合わせを避けるルートをリクエストするには、avoid パラメータに複数の制限を渡します。例: avoid=tolls|highways|ferries

注: 制限を追加しても、制限された対象物を含むルートが除外されるわけではありません。より好ましいルートが優先されるようになります。

単位系

ルートの結果には、distance フィールド内に text が含まれます。これは、ルートの特定の「ステップ」の距離を示すためにユーザーに表示されることがあります。デフォルトでは、このテキストは出発地の国や地域の単位系を使用します。

たとえば、「シカゴ、イリノイ」から「トロント、オンタリオ」へのルートはマイルで表示され、この逆のルートはキロメートルで表示されます。単位系のデフォルト設定は、リクエストの units パラメータ内で明示的に設定することでオーバーライドできます。その場合は、次のいずれかの値を渡します。

metric はメートル系を使用するよう指定します。テキスト表記の距離はキロメートルやメートルで返されます。
imperial はヤード・ポンド法を使用するよう指定します。テキスト表記の距離はマイルやフィートで返されます。

注: この単位系設定は、distance フィールド内に表示される text にのみ影響します。distance フィールドには values も含まれます。これは常にメートル単位で表されます。

リージョンのバイアス設定

region パラメータを使用すると、特定の地域の結果を返すようにルートサービスを設定できます。このパラメータは、地域バイアスを指定する 2 文字の ccTLD（国別コードトップレベルドメイン）引数を取ります。ほとんどの ccTLD コードは ISO 3166-1 alpha-2 コードと同じですが、いくつか注意が必要な例外もあります。たとえば、英国の ccTLD は「uk」（.co.uk）ですが、ISO 3166-1 コードは「gb」です（厳密には「グレートブリテンおよび北アイルランド連合王国」のエンティティ）。サポート対象の地域は、Google Maps Platform のサポート状況でご確認いただけます。

Google マップのメインアプリケーションで運転ルートが提供されているドメインであれば、どのドメインでも利用できます。

たとえば、region を es に設定すると、「Toledo」から「Madrid」へのルートをリクエストした場合に、「Toledo」がスペインの都市として解釈され、適切な結果が返されます。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &region=es
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid®ion=es&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJ8f21C60Lag0R_q11auhbf8Y",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes":
    [
      {
        "bounds":
          {
            "northeast": { "lat": 40.4165207, "lng": -3.7026134 },
            "southwest": { "lat": 39.862808, "lng": -4.029406799999999 },
          },
        "copyrights": "Map data ©2022 Inst. Geogr. Nacional",
        "legs":
          [
            {
              "distance": { "text": "74.3 km", "value": 74327 },
              "duration": { "text": "57 mins", "value": 3446 },
              "end_address": "Madrid, Spain",
              "end_location": { "lat": 40.4165207, "lng": -3.705076 },
              "start_address": "Toledo, Spain",
              "start_location": { "lat": 39.862808, "lng": -4.0273727 },
              "steps":
                [
                  {
                    "distance": { "text": "0.6 km", "value": 615 },
                    "duration": { "text": "2 mins", "value": 106 },
                    "end_location":
                      { "lat": 39.8681019, "lng": -4.029378299999999 },
                    "html_instructions": "Head <b>northwest</b> on <b>Av. de la Reconquista</b> toward <b>C. de la Diputación</b>",
                    "polyline":
                      {
                        "points": "quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC",
                      },
                    "start_location": { "lat": 39.862808, "lng": -4.0273727 },
                    "travel_mode": "DRIVING",
                  },
                  // Additional steps omitted for brevity
                ],
              "traffic_speed_entry": [],
              "via_waypoint": [],
            },
          ],
        "overview_polyline":
          {
            "points": "quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)",
          },
        "summary": "A-42",
        "warnings": [],
        "waypoint_order": [],
      },
    ],
  "status": "OK",
}

XML

      
<DirectionsResponse>
 <status>OK</status>
 <route>
  <summary>A-42</summary>
  <leg>
   <step>
    <travel_mode>DRIVING</travel_mode>
    <start_location>
     <lat>39.8628080</lat>
     <lng>-4.0273727</lng>
    </start_location>
    <end_location>
     <lat>39.8681019</lat>
     <lng>-4.0293783</lng>
    </end_location>
    <polyline>
     <points>quhrF`rqWCBQJUJm@PQFg@Ni@JeBh@}@XaD|@{@Vk@Ns@RUFoA^u@R_AXwA`@WHMBG@C?E?GAC?IC</points>
    </polyline>
    <duration>
     <value>106</value>
     <text>2 mins</text>
    </duration>
    <html_instructions>Head &lt;b&gt;northwest&lt;/b&gt; on &lt;b&gt;Av. de la Reconquista&lt;/b&gt; toward &lt;b&gt;C. de la Diputación&lt;/b&gt;</html_instructions>
    <distance>
     <value>615</value>
     <text>0.6 km</text>
    </distance>
   </step>
   <!-- Additional steps omitted for brevity -->
   <duration>
    <value>3446</value>
    <text>57 mins</text>
   </duration>
   <distance>
    <value>74327</value>
    <text>74.3 km</text>
   </distance>
   <start_location>
    <lat>39.8628080</lat>
    <lng>-4.0273727</lng>
   </start_location>
   <end_location>
    <lat>40.4165207</lat>
    <lng>-3.7050760</lng>
   </end_location>
   <start_address>Toledo, Spain</start_address>
   <end_address>Madrid, Spain</end_address>
  </leg>
  <copyrights>Map data ©2022 Inst. Geogr. Nacional</copyrights>
  <overview_polyline>
   <points>quhrF`rqWcHzBaNzDeG~A][?k@lA{Dr@mBR]HmA[WQDWE[g@mAeE... (truncated for brevity)</points>
  </overview_polyline>
  <bounds>
   <southwest>
    <lat>39.8628080</lat>
    <lng>-4.0294068</lng>
   </southwest>
   <northeast>
    <lat>40.4165207</lat>
    <lng>-3.7026134</lng>
   </northeast>
  </bounds>
 </route>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJ8f21C60Lag0R_q11auhbf8Y</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

region パラメータを指定せずに「トレド」から「マドリード」へのルートをリクエストすると、結果は返されません。これは、「トレド」がスペインではなくオハイオ州の都市として解釈されるためです。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Madrid
  &origin=Toledo
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=Toledo&destination=Madrid&key=YOUR_API_KEY'

JSON

      
{
  "geocoded_waypoints":
    [
      {
        "geocoder_status": "OK",
        "place_id": "ChIJeU4e_C2HO4gRRcM6RZ_IPHw",
        "types": ["locality", "political"],
      },
      {
        "geocoder_status": "OK",
        "place_id": "ChIJgTwKgJcpQg0RaSKMYcHeNsQ",
        "types": ["locality", "political"],
      },
    ],
  "routes": [],
  "status": "ZERO_RESULTS",
}

XML

      
<DirectionsResponse>
 <status>ZERO_RESULTS</status>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJeU4e_C2HO4gRRcM6RZ_IPHw</place_id>
 </geocoded_waypoint>
 <geocoded_waypoint>
  <geocoder_status>OK</geocoder_status>
  <type>locality</type>
  <type>political</type>
  <place_id>ChIJgTwKgJcpQg0RaSKMYcHeNsQ</place_id>
 </geocoded_waypoint>
</DirectionsResponse>

位置情報の修飾子

場所の修飾子を使用すると、ドライバーが特定の場所にどのように接近するかを指定できます。side_of_road パラメータを使用して、道路のどちら側を使用するかを指定したり、進行方向を指定して正しい進行方向を示したりできます。これらの修飾子は、中間ウェイポイントの via: 修飾子と自由に組み合わせることができます。

ルートが道路の特定の側を通過する必要があることを指定する

ウェイポイントを指定する際に、side_of_road: 接頭辞を使用すると、ウェイポイントが偏っている道路のどちら側を通るルートをリクエストできます。たとえば、次のルートリクエストでは、ウェイポイントが偏っている道路の側に車両が到着するように、長いルートが返されます。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=side_of_road%3A37.7663444%2C-122.4412006
  &origin=37.7680296%2C-122.4375126
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=37.7680296%2C-122.4375126&destination=side_of_road%3A37.7663444%2C-122.4412006&key=YOUR_API_KEY'

エンコードされたポリラインで side_of_road: を使用すると、パラメータはポリラインに沿ったすべての場所に適用されます。

side_of_road: 修飾子は、次の制限付きでのみ使用できます。

travel mode パラメータが driving、または指定されていない（デフォルトの移動手段は driving）。

ルートに特定の進行方向を指定する

ウェイポイントを指定する際に、特定の方向でウェイポイントを通過するルートをリクエストできます。この方向は、接頭辞 heading=X: で指定します。X は 0 以上 360 未満の整数値です。方位 0 は北、90 は東を示し、時計回りに続きます。たとえば、このルートリクエストでは、ルートは出発地から東に向かい、U ターンします。

URL

https://maps.googleapis.com/maps/api/directions/json
  ?destination=37.773245%2C-122.469502
  &origin=heading%3D90%3A37.773279%2C-122.468780
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/directions/json?origin=heading%3D90%3A37.773279%2C-122.468780&destination=37.773245%2C-122.469502&key=YOUR_API_KEY'

heading=X: 修飾子は、次の制限付きでのみ使用できます。

travel mode パラメータが driving、bicycling、または指定されていない（デフォルトの移動手段は driving）。
side_of_road 修飾子が同じ場所に指定されていない。
位置は緯度と経度の値で指定します。heading を住所、プレイス ID、エンコードされたポリラインとともに使用することはできません。

ルートの例 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

リクエストの例

URL

curl

URL

curl

URL

curl

URL

curl

URL

curl

URL

curl

移動手段

交通情報

URL

curl

ウェイポイント

waypoints パラメータでロケーションを指定します。

URL

curl

経由地と通過地点を指定してルートを調整する

URL

curl

URL

curl

URL

curl

URL

curl

ウェイポイントを最適化する

URL

curl

制限事項

単位系

リージョンのバイアス設定

URL

curl

JSON

XML

URL

curl

JSON

XML

位置情報の修飾子

ルートが道路の特定の側を通過する必要があることを指定する

URL

curl

ルートに特定の進行方向を指定する

URL

curl

ルートの例

`waypoints` パラメータでロケーションを指定します。