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 が含まれます。詳しくは、Snap to Roads ガイドのレスポンスをご覧ください。

  • JSON
最寄りの道路

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

制限速度

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

Roads API の使用方法

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

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

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

Google マップ サービス向けの Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。これらのライブラリは GitHub からダウンロードできます。インストール手順とサンプルコードも GitHub で確認可能です。

次のステップ