Roads API を使用する理由
Roads API を使用して、制限速度、推定到着時間、その他の道路のメタデータを取得できます。この道路に関するメタデータを使用すると、次のような機能で運転用アプリを強化できます。
- 緯度と経度の座標を道路や道路に関連付けます。
- 一連の座標に基づいて最寄りの道路を探す
- 道路区間の制限速度を表示する
Roads API でできること
Roads API を使用すると、GPS 座標を道路のジオメトリにマッピングし、道路区間の速度制限を求めることができます。
- 道路へのスナップ: 指定された一連の 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 が含まれます。詳しくは、道路へのスナップに関するガイドのレスポンスをご覧ください。 |
|
最寄りの道路 |
最大 100 個の独立した緯度と経度の座標と、指定された各地点に最も近い道路のプレイス ID の配列。ポイントは連続している必要はありません。詳しくは、最寄りの道路のガイドの回答をご覧ください。 |
|
制限速度 |
最大 100 個の道路メタデータ要素の配列。制限速度とプレイス ID(単位は KPH または MPH)が含まれます。詳細については、速度制限ガイドのレスポンスをご覧ください。 |
Roads API の使用方法
1 | 道路へのスナップのデモを試す | デモをクリックしてトラックを作成し、道路のエンドポイントへのスナップによってどのようにスムーズなデータが提供されるかを確認します。 「道路へのスナップ」ガイドのデモをご覧ください。API キーは必要ありません。 |
2 | セットアップする | まず Google Cloud プロジェクトをセットアップするの手順に進み、それから API キーの使用方法を確認してください。 |
3 | 道路へのスナップのリクエスト | 道路へのスナップの例のいずれかを使用 し、ユースケースに関連するものを試してください。 |
4 | 道路の制限速度を確認する | 道路へのスナップのリクエストで指定したのと同じパスデータを使用して、制限速度クエリを発行します。パスを使用したリクエストの例をご覧ください。 |
5 | 長いパスを処理する方法 | 高度なコンセプト ガイドの長いパスの処理に関するセクションをご覧ください。 |
6 | 道路データを独自のアプリに統合できます。 | 道路スナップのデモの詳細なコードサンプルを確認して、道路データの機能を独自のアプリに組み込みましょう。 |
利用可能なクライアント ライブラリ
次のいずれかのクライアント ライブラリを使用して、任意の言語でこの API を呼び出します。
- Google マップサービス用の Java クライアント
- Google マップサービス用の Python クライアント
- Google マップ サービス向け Go クライアント
- Google マップサービス用の Node.js クライアント
Google マップ サービス用の Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。GitHub からダウンロードしてください。GitHub には、インストール手順とサンプルコードも掲載されています。
次のステップ
- Roads API を試す: Roads Inspector に移動します。
- Roads API リクエストの作成方法: 使用するサービスに移動します。
- 高度なコンセプトについて理解する: 高度なコンセプトに進みます。
- ベスト プラクティスを実践する: ウェブサービスのベスト プラクティスをご覧ください。