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 には、インストール手順やサンプルコードも用意されています。

次のステップ