Roads API の概要

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

Roads API を使用する理由

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

  • 緯度と経度の座標を道路に接続します。
  • 一連の座標から最も近い道路を特定する
  • 道路区間の制限速度を取得する

Roads API でできること

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

  • 道路にスナップ: このサービスは、指定された 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
Nearest roads

最大 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 で確認できます。

次のステップ