Roads API の概要

Roads API は、次を含む HTTPS リクエストを受け入れるサービスです。 地図上の 1 つ以上のポイントの緯度と経度の座標。このモデルは、 の地点に基づいて付近の道路セグメントが検出され、場所 ID とメタデータが返されます。 たとえば最寄りの道路セグメントや 制限速度などです

Roads API を使用する理由

Roads API を使用すると、制限速度や 到着時刻、その他の道路メタデータなどです。この道路と メタデータに基づき、次の機能を使用して運転用アプリを強化できます。

  • 緯度と経度の座標を道路に関連付けます。
  • 座標から最も近い道路を見つける
  • 道路区間の制限速度を調べる

Roads API でできること

Roads API を使用すると、GPS 座標を 道路のジオメトリを計算し、道路上の制限速度を決定します。 分割します

  • Snap to Roads: このサービスは、最も可能性の高い 提供された GPS 座標に基づいて走行した道路。最大 100 個の ルート上で収集された GPS 地点。必要に応じて、サービスに対して Google Cloud の は追加のポイントを補間して、滑らかに ジオメトリ。
  • Nearest Roads このサービスでは最寄りの道路が返されます。 セグメントに分割されます最大 100 個の GPS ポイントを指定できます。 指定する地点は、連続したパスの一部である必要はありません。
  • 制限速度 このサービスでは、投稿された 道路セグメントの速度制限制限速度サービスは、 アセット トラッキング ライセンスをお持ちのお客様が対象です。Google Maps Platform プレミアム プランの場合 お客様が従量課金制に移行した場合、この機能は引き続き アクティブです。

Roads API の仕組み

Roads API は、緯度と経度を受け入れる 3 つのエンドポイントを使用します。 座標またはプレイス ID を使用して、道路の道、区間、制限速度のデータを提供します。 次の例は、データセットに基づいて最も近い道路を検索するリクエストを示しています。 緯度と経度の座標:

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 地点の配列を返します。含まれるもの 道路スナップされた経度/緯度の座標 関連付けられます詳細を表示 対応 [道路にスナップ] をクリック ご覧ください
  • JSON
最寄りの道路

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

最大 100 個の道路メタデータ要素の配列。これには速度が含まれます 制限とプレイス ID があり、単位は KPH または MPH です。詳細を表示 [回答] 内 制限速度内 ご覧ください

Roads API の使用方法

1 「道路にスナップ」のデモを試す デモをクリックしてトラックを作成し、道路のエンドポイントにスナップする方法をご確認ください 滑らかなデータを提供します。詳しくは、 デモ [道路にスナップ] ガイドをご覧ください。API キーは必要ありません。
2 セットアップする まずは Google Cloud プロジェクトを作成し、以下の設定手順を完了します。 学習し、 API キーの使用方法をご覧ください。
3 道路へのスナップ リクエストを試す Snap のいずれかを使用 道路の例を参照し 、ユースケースに関連するものを試してください。
4 道路の通路で制限速度を確認する 「道路へのスナップ」リクエストで指定したものと同じパスデータを使って、 制限速度クエリを発行します詳しくは、 パスを使用したリクエストの例。
5 長いパスを処理する方法の詳細 以下のセクションを参照してください。 長いパスの処理 （高度なコンセプトのガイド）をご覧ください。
6 道路データを独自のアプリに組み込む 詳しくは、 道路スナップされたデモの詳細なコード例を開始 独自のアプリに道路データ機能を構築できます。

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

この API を 次のいずれかのクライアント ライブラリを使用できます。

Google マップ用の Java クライアント、Python クライアント、Go クライアント、Node.js クライアント サービスはコミュニティでサポートされているクライアント ライブラリで、 Apache 2.0 ライセンス。 GitHub からダウンロードしてください。GitHub には、インストール手順やサンプルコードも用意されています。

次のステップ