Roads API の概要

Roads API は、地図上の 1 つ以上のポイントに緯度と経度の座標を指定した HTTPS リクエストを受け入れるサービスです。これらのポイントを使用して最寄りの道路区分を特定し、プレイス ID と最寄りの道路区分や制限速度などのメタデータを返します。

Roads API を使用するメリット

Roads API を使用して、制限速度、到着予定時刻、その他の道路のメタデータを取得できます。この道路のメタデータを使用すると、以下の機能で運転アプリを強化できます。

  • 緯度と経度の座標を道路(複数可)に接続します。
  • 一連の座標で最寄りの道路を検索する
  • 道路区間の制限速度を確認する

Roads API でできること

Roads API を使用すると、GPS 座標を道路のジオメトリにマッピングし、道路区間の速度制限を特定できます。

  • Snap to Roads: 指定された GPS 座標のセットに基づいて、移動した可能性が高い道路を返します。ルートで収集した GPS 地点を 100 個まで指定できます。オプションで、追加のポイントを補間して、道路の形状に滑らかに沿うパスを作成するようにリクエストすることもできます。
  • Nearest Roads: GPS 地点に最も近い道路セグメントを返します。最大 100 個の GPS 地点を指定できます。 指定する地点は、連続したパスの一部である必要はありません。
  • 制限速度: 道路セグメントに掲示されている制限速度を返します。制限速度サービスは、アセット トラッキング ライセンスをお持ちのすべてのお客様がご利用いただけます。従量課金制に移行した Google Maps Platform プレミアム プランのお客様については、この機能は引き続き有効です。

Roads API の仕組み

Roads API は、緯度と経度の座標またはプレイス ID を受け入れる 3 つのエンドポイントを使用して、道路のパス、セグメント、制限速度のデータを提供します。次の例は、緯度と経度の座標に基づく最寄りの道路のリクエストを示しています。

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

リソース

次の表は、Roads API で利用できるリソースと返されるデータをまとめたものです。

データリソース 返されるデータ 戻り値の形式
道路にスナップ

ルートから最大 100 個の GPS 地点の配列を返します。道路スナップされた経度/緯度の座標とプレイス ID が含まれます。詳しくは、道路へのスナップに関するガイドのレスポンスをご覧ください。

  • JSON
最寄りの道路

最大 100 個の独立した緯度と経度の座標の配列と、指定された各地点に最も近い道路のプレイス ID が含まれます。ポイントは連続である必要はありません。詳しくは、最寄りの道路のガイドのレスポンスをご覧ください。

制限速度

最大 100 個の道路のメタデータ要素の配列。制限速度とプレイス ID(単位は KPH または MPH)が含まれます。詳細については、制限速度ガイドのレスポンスをご覧ください。

Roads API の使用方法

1 道路へのスナップのデモを試す デモをクリックしてトラックを作成し、道路のエンドポイントへのスナップによってどのようにスムーズなデータが提供されるかをご確認ください。道路にスナップ」ガイドのデモをご覧ください。API キーは必要ありません。
2 セットアップする Google Cloud プロジェクトをセットアップするから始めて、以下の設定手順を完了してから、API キーの使用方法を学びます。
3 「道路へのスナップのリクエスト」を試す 道路へのスナップの例のいずれかを使用 し、ユースケースに関連するものを試してください。
4 道路の制限速度を確認する 道路へのスナップのリクエストで指定したものと同じパスデータを使用して、制限速度のクエリを発行します。パスを使用したリクエストの例をご覧ください。
5 長いパスを処理する方法 高度なコンセプト ガイドの長いパスの処理のセクションをご覧ください。
6 道路データを独自のアプリに組み込む 道路スナップ デモの詳細なコードサンプルを参照して、道路データの機能を独自のアプリに組み込みましょう。

利用可能なクライアント ライブラリ

次のいずれかのクライアント ライブラリを介して、任意の言語でこの API を呼び出します。

Google マップ サービス向けの Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリで、Apache 2.0 ライセンスに基づいてオープンソース化されています。GitHub からダウンロードしてください。GitHub には、インストール手順とサンプルコードも記載されています。

次のステップ