ガイドAPIリファレンス
ガイド

発送時間の見積もり

このセクションでは、出荷およびセグメントの出発予定時間 (ETD) と到着予定時間 (ETA) の処理について説明します。 出荷とセグメントには、次の時間が設定される場合があります。

  • 実際の出発時間と到着時間。
  • 指定されたETD/ETAの時間。
  • 計算されたETD/ETAの時間。

実際の時間

実際の時間は出荷またはセグメントの状態が変わると更新され、状態遷移が実際に起きた時間を示します。

指定時間

指定時間とは、出荷予定時間のことです。出荷を作成するときに、出荷作成リクエストの出荷およびセグメントのprovidedEtdおよびprovidedEtaの時間を指定できます。 出荷計画から出荷を作成したときに、そのセグメント計画にdurationS値が定義されており、出荷作成リクエストにshipmentDeparture時間が指定されている場合、その出荷の指定時間は指定されたshipmentDeparture時間とセグメント計画のdurationS値に基づいて初期化されます。 指定時間が設定された後、トラッキングバックエンド値は変更されません。

計算時間

計算時間 (calculatedEtdおよびcalculatedEta) とは、出荷の予定時間です。 出荷にprovidedEtdプロパティ値が設定されている場合、初回の予測は、出荷が作成されたときにトラッキングバックエンドによって計算されます。出荷が開始される前にprovidedEtd値が更新されると、推定時間の再計算がトリガーされます。出荷のprovidedEtd値は、セグメントの所要時間を予測するための開始点として使用されます。 出荷が開始された後、トラッキングバックエンドは出荷の進行に応じて実際の時間に基づいて予測を更新します。予測の再計算は、セグメントのステータスが変更されたときと、進行中の出荷で使用されているトラッカーが取り込みを行ったときにトリガーされます。 セグメントのcalculatedEtaの予測値が更新されると、後続のセグメントの予定時間も更新され、進行中のセグメントのcalculatedEtaの変更を反映して再計算されます。 計算値は、以下で説明する複数のソースを基に計算されます。

出荷計画からの初期値

出荷計画を作成するときに、出荷セグメントに事前定義された所要時間 (durationS値) を割り当てることができます。この情報および出荷作成リクエストで指定されたshipmentDeparture時間を使用して、出荷が出荷計画からインスタンス化されるときに、出発予定時間 (ETD) と到着予定時間 (ETA) が計算されます。

道路セグメント

出荷のセグメントが道路セグメントである場合、つまりtransportModecarまたはtruckが含まれている場合、セグメントのcalculatedEtaはそのセグメントの横断にかかる時間を予測して計算されます。状況によっては、過去のトレース状況、次の経由地への予定ルート、ライブの交通状況、地域での休憩時間規制、学習した運転パターン、その他の要因に基づいて予測されます。 進行中のセグメントにおける残りのセグメントの所要時間は、セグメントのトラッカーからの取り込みによって計算がトリガーされた場合、セグメントのトラッカーの最新の位置からセグメントの目的地点までが計算されます。後続の保留中のセグメントについては、セグメントの出発地からセグメントの目的地までの所要時間を計算することによって予測が更新されます。

以前に完了したセグメントの所要時間

道路セグメント以外のセグメントの場合、セグメントの推定所要時間は、予測するセグメントと同じtransportMode、出発地点および目的地点を使用して、以前に完了したセグメントから取得されます。