Roads API の概要

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

Roads API を使用する理由

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

  • 緯度と経度の座標を道路または道路に接続します。
  • 座標のセットから最も近い道路を探す
  • 道路セグメントの速度制限の適用

Roads API でできること

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

  • Snap to Roads このサービスは、指定された GPS 座標セットに基づいて、移動の可能性が最も高い道路を返します。ルート沿いに収集される GPS 地点は 100 個まで指定できます。必要に応じて、追加ポイントを補間するようサービスをリクエストし、道路のジオメトリにスムーズに追随するパスを作成することもできます。
  • 最寄りの道路: このサービスは GPS 地点から最も近い道路セグメントを返します。最大 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 地点の配列を返します。道路スナップされた経度/緯度の座標と、場所 ID が含まれます。詳しくは、道路へのスナップ ガイドのレスポンスをご覧ください。
  • JSON
最寄りの道路

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

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

次のステップ