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 地点に最も近い道路区間を返します。GPS ポイントは最大 100 個指定できます。指定する地点は、連続したパス上の地点である必要はありません。
  • 速度制限 このサービスは、道路区間に掲示されている速度制限を返します。速度制限サービスは、アセット トラッキング ライセンスを保有しているすべてのお客様がご利用いただけます。従量課金制に移行した 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
Nearest roads

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

最大 100 個の道路メタデータ要素の配列。制限速度とプレイス ID が含まれ、単位は km/h または 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 には、インストール手順とサンプルコードも用意されています。

次のステップ