Roads API の概要

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

Roads API を使用する理由

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

  • 緯度と経度の座標を道路に接続する。
  • 座標セットの最寄りの道路を検索する
  • 道路区分の制限速度を取得する

Roads API でできること

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

  • Snap to Roads このサービスは、指定された GPS 座標セットに基づいて、走行した可能性が最も高い 道路を返します。ルートに沿って収集された最大 100 個の GPS 地点を指定できます。必要に応じて、サービスに追加の地点を補間するようリクエストすることもできます。これにより、道路のジオメトリに沿ってスムーズに移動するパスが生成されます。
  • 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 で利用できるリソースと、返されるデータの概要を示します。

データリソース 返されるデータ 返される形式
Snap to Roads

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

最大 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 には、インストール手順とサンプルコードも掲載されています。

次のステップ