到着予定時刻にTomTomルーティングAPIを使用する方法

APIを使用して正確な到着時間を計算するためのチュートリアル

(Bre Teiko)(2020年10月22日)

ルーティングAPIの概要

Routing APIは、最速、最短、最もエキサイティングなルートなど、さまざまなタイプの車両の正確な方向を取得するために使用できる強力なツールです。また、目的のルートの幾何学的形状を提供し、

しかし、APIから見落とされている機能の1つは、要求されたルートの要約をフェッチするオプションです。この例のように、ユーザーに可能性を表示すると便利です。最寄りの病院または薬局を見つける必要があります。要約を取得することで、ここにあるマトリックスルーティングの例を使用してより適切な選択を提供できます。

これのもう1つの典型的な使用例は、ライドシェアリングアプリケーションです。走行距離またはETAのいずれかのみが必要なため、比較するルートを実際に作成する必要がない場合、エリア全体に分散しているプロバイダーのリストから最適なドライバーを計算するのは困難です。サマリーが魔法のように機能するのはこのときです。

サマリーは次のパラメータでリクエストされます:

値 polylineは、LatLngペア配列でルートのグラフィカル表現を返しますが、summaryOnlyは、このような応答で追加のJSONセクションを取得します:

ここにいくつかの興味深いデータがありますこれにより、このAPI自体が特に他のAPIと区別されます。

  1. トラフィックなし、ライブトラフィック、履歴トラフィックを考慮したさまざまなETAがあることがわかります。
  2. 代替ルートを取得できます元のルートからどれだけ逸脱しているかを確認します。

注:逸脱と代替ルートは、最初のルートが最初に計算されます。

注2:燃料消費量オンが推定されます。しかし、電気自動車または内燃機関車のいずれかの消費モデルに合格すると、計算ははるかに正確になります。

では、実際の車両を確認してみましょう。実例…

さまざまなタイプ、さまざまなETAS

シカゴのダウンタウンにあるホテルのさまざまなETAを確認します。「LaQuintaInn」はどうですか?このホテルでは、次の場所を使用します:

ホテルから、レストラン、ケイジャンクレオールスタイルのレストランの近くを見つけたいと思います。これには、カテゴリ検索API [ https://developer.tomtom.com/search-api/search-api-documentation-search/category-search]ホテル周辺の可能なレストランのリストを取得するには(ホテルのLatLngを位置バイアスとして使用)。

未使用のデータを削除すると、小さなリストが表示されます。これが最初の要素です:

ご覧のとおり、結果の一部としてホテルまでの距離も取得します。ただし、この値(メートル単位)は直接的な視点の距離であり、運転や徒歩による実際の距離ではありません。このCurlコマンドを実行すると、結果を複製できます。

実際の走行距離については、Routing APIを使用して、概要のみを要求し、さまざまな移動時間を計算するオプションを追加します。使用できるAPIエンドポイントは次のとおりです。

これにより、次のことが可能になります:

今のところこれで十分ですが、比較するルートをさらに増やす必要があります。そのためには、Matrix RoutingAPIを使用するよりも良い方法はありません。

すべての可能なルート/多くの宛先へのルートを取得する

開発者ポータルのドキュメントから:

マトリックスルーティングサービスを使用すると、出発地と目的地で定義された一連のルートのルートサマリーのマトリックスを計算できます。

  • このサービスは、指定されたすべてのオリジンについて、そのオリジンから指定されたすべての宛先へのルーティングのコストを計算します。
  • 起点のセットと宛先のセットは、テーブルの列ヘッダーと行ヘッダーと考えることができますが、テーブルの各セルには、からのルーティングのコストが含まれています。そのセルの出発地から目的地まで。

ルートごとに次のコストが計算されます:

  • 移動時間
  • 距離

こちらの完全なドキュメントを確認してください: https://developer.tomtom.com/routing-api/routing-api-documentation-matrix-routing/synchronous-matrix

これはまさに私たちが必要としているもののようです。

この場合、運転と歩行者の概要を計算して、歩くか運転するかを決定できます。また、リクエストは十分に単純であるため(ここでは複雑なルートはありません)、同期バージョンを使用できます。すべてのルートが計算されると、応答を待ちます。

注:マトリックスルーティングAPIの同期バージョンはafをタイムアウトします60秒後なので、必ず小さなルートでのみ使用してください。

エンドポイントはHTTP-POSTリクエストです。使用するURLは次のとおりです:

POST本文:ここでは、さまざまなルート(同じ出発地、さまざまな目的地)のリクエストを設定します。次の形式に従います:

私たちの場合、これは私たちのPOST本文です:

このリクエストでは、編集目的で切り捨てられた次の結果が得られます:

すべての宛先について、単純な呼び出しの実行から取得したものと同じ必要な情報を含む応答オブジェクトとそのRouteSummaryを取得します。ここでは、「CajunGrill」レストランが運転に最も近いことがわかります。これにより、ユーザーのリストまたはディスプレイにデータを入力できます。ウォーキングルートが必要な場合は、移動モードを歩行者に変更してみてください。例歩行者ルートの場合:

このリクエストの使用、「Cajun Grill」レストランも徒歩圏内に最も近いことがわかりますが、さまざまなレストランから選択する場合は、いつでもBatch Routing APIを使用して、単一のルートを使用して必要なすべてのルートを作成できます。電話: https://developer.tomtom.com/routing-api/routing-api-documentation/batch-routing

この方法ユーザーに表示する必要のあるルートのみを作成します。

概要

この記事では、ルーティングAPIと、ETAと実際の運転を取得する方法について説明しました。 Matrix RoutingAPIの応答でSummaryオブジェクトを介して徒歩圏内。

Matrix Routing APIを使用すると、さまざまな宛先からそのようなETAを取得できる1回の呼び出しでさまざまな要約をフェッチできます。

この記事がTomTomRoutingAPIをよりよく理解するのに役立つことを願っています-再ありがとうading and Happy Mapping!

ラストマイルモビリティおよびトランスポーテーションサービス向けのTomTomのサービスとソリューションの詳細については、モビリティとオンデマンドのページをご覧ください。 ここ

この記事は元々

https://developer.tomtom.com/blog 。原作者はホセホセロハスです。

コメントを残す

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です