ラストワンマイルのフリートソリューションは現在、一部のお客様のみご利用いただけます。詳しくは、営業担当者までお問い合わせください。

このページは Cloud Translation API によって翻訳されました。

配送追跡のための Fleet Engine のスタートガイド

配送の最初と最後のワンマイルにおけるフリートの活動をモデル化 Fleet Engine Deliveries API です。この API を使用するには、Android 用 Driver SDK を使用します。 HTTP REST や gRPC 呼び出しを使用して直接呼び出すこともできます。

初期設定

Google Cloud コンソールで Fleet Engine Deliveries API を構成します。

コンソールで行う手順と作成方法については、認証用の JSON Web Token については、以下をご覧ください。認証と認可。
コンソールの使用方法について詳しくは、 Google Cloud Console のドキュメント

設定を確認する

サービスアカウントを作成したら、設定が完了していることを確認する配達車両を作成できます設定をすぐに確認認証に関する一般的な問題については、説明します。設定を確認するには、次の 2 つの方法があります。

設定の主な 2 つの部分（認証トークンの署名とトライアル配信）をテストする車両の作成、 gcloud コマンドラインユーティリティ。対象詳しくは、設定の確認をご覧ください。ご覧ください
Fleet Engine Auth のサンプルスクリプト。

クライアントライブラリ

未加工の gRPC や REST よりも優れたデベロッパーエクスペリエンスのために、クライアントライブラリをいくつかの一般的なプログラミング言語で記述しています。対象サーバーアプリケーション用のクライアントライブラリを入手する方法については、クライアントライブラリ。

このドキュメントの Java の例は、gRPC に精通していることを前提としています。

データ構造

Fleet Engine Deliveries API は 2 つのデータ構造を使用して受け取りと配達をモデル化の配送数:

荷物の輸送に使用された配送車両。
荷物の集荷と配達のタスク。

また、タスクを使用してドライバーの休憩や所定の停留所のモデルを作成します。 1 日中。

配達車両

配達車両は、倉庫から配達場所に荷物を輸送する。出発点までだと考えました。場合によっては受け取り場所から配達先に直接荷物を輸送する。

Driver SDK を使用して Fleet Engine に DeliveryVehicle オブジェクトを作成する最新の位置情報を送信して、配送状況を追跡したり、追跡したりできます。

タスク

車両が日中に行うアクションについては、アクションのタイプ:

受け取りと配送の場合は、配送タスクを割り当てます。
休憩時間など、ドライバーが都合がつかない時間帯には、 利用不能のタスクを割り当てます。
配達先や顧客の所在地での運転以外のタスクについては、 スケジュール設定された停止タスク。

タスクごとに固有のタスク ID を割り当てる必要がありますが、タスクは同じ ID で共有できますトラッキング ID です。Fleet Engine が到着予定時刻を計算するときすべてのタスクが使用され、実行されている順序が予測を行いますタスク ID の詳細については、以下をご覧ください。タスク ID のガイドライン

Fleet Engine でタスクを作成するには、Driver SDK タスクマネージャーを使用します。

配送タスク

荷物の集荷と配達の両方を行う配送タスクを作成する以下の情報を含めてください。

受け取りまたは宅配を行う場所。
荷物追跡番号または ID。
セキュリティ侵害の発生から検知までに要した日数は、タスク完了の駐車場に行くか、ハンドオフの場所まで歩いて行きます。
一意のタスク ID。タスク ID のガイドラインをご覧ください。

詳細については次のトピックをご覧ください。

Android

iOS

利用できないタスク

利用できないタスクは、車両が利用できない時間帯を含むピックアップまたは配達（車両またはドライバーに給油するための休憩など）休憩できます。

次の情報を使用して、利用不可のタスクを作成します。

休憩時間。
（省略可）休憩の位置。機密情報をそうすることで、より正確な到着予定時刻を 1 日中。

で確認できます。

詳細については次のトピックをご覧ください。

Android

スケジュール設定された利用停止

iOS

スケジュール設定された停止タスク

スケジュール設定された停止タスクを作成して、配達車両に必要な停車地をモデル化あります。たとえば、毎日スケジュールされた停止タスクを作成して、他の配送とは無関係に、特定の場所での集荷所の場所同じ場所での乗車はできませんスケジュールに基づいて停止するタスクも集荷やモデルのフィーダーと車両の乗り換えに対応サービスセンターやサービスポイントに停車するようなものです

詳細については次のトピックをご覧ください。

Android

予定されている停車地

iOS

タスク ID のガイドライン

タスク ID を作成する際は、内容と形式に関する次のガイドラインに従ってください。

一意のタスク ID を作成する
個人を特定できる情報（PII）や暗号化されます。
有効な Unicode 文字列を使用してください。
64 文字以下で入力してください。
ASCII 文字「/」、「":"」、「「\"」、「?」、「#」
Unicode 正規化フォーム C に従って正規化します。

で確認できます。

適切なタスク ID の例を次に示します。

566c33d9-2a31-4b6a-9cd4-80ba1a0c643b
e4708eabcfa39bf2767c9546c9273f747b4626e8cc44e9630d50f6d129013d38
NTA1YTliYWNkYmViMTI0ZmMzMWFmOWY2NzNkM2Jk

次の表に、サポートされていないタスク ID の例を示します。

サポートされていないタスク ID	理由
8/31/2019-20:48-46.70746,-130.10807,-85.17909,61.33680	個人情報（PII）および文字の要件（カンマ、ピリオド、コロン、スラッシュ）に違反する。
JohnDoe-577b484da26f-Cupertino-SantaCruz	個人情報（PII）に関する要件に違反しています。
4R0oXLToF"112 Summer Dr. East Hartford、CT06118"577b484da26f8a	個人情報（PII）と文字の要件（空白文字、カンマ、引用符）に違反する。64 文字を超える。

その他のリソース

各データに含まれる特定のフィールドを確認するには構造については、API リファレンスドキュメントで DeliveryVehicle をご覧ください。（gRPC、REST） Task（gRPC、REST）があります。

自動車の寿命

DeliveryVehicle オブジェクトは、ファーストワンマイルまたはラストワンマイルの配達車両を表します。以下を使用して DeliveryVehicle オブジェクトを作成します。

サービスアカウントを含む Google Cloud プロジェクトのプロジェクト ID Fleet Engine API の呼び出しに使用しないでください。
顧客所有の車両 ID。

車両ごとに一意の車両 ID を使用してください。車両 ID を再利用しないでください（元の車両にアクティブなタスクがない場合を除く）

Fleet Engine は、削除されていない DeliveryVehicle オブジェクトを自動的に削除します。 7 日後に UpdateDeliveryVehicle を使用して更新されました。推奨される Fleet Engine で車両を利用できるようにするには、位置情報を更新することが定期的に更新することもできます。DeliveryVehicle 内の他のほとんどのフィールドの更新新しいフィールド値が異なる場合は、そのエンティティの有効期間も延長されます。必要があります

車両が存在するかどうかを確認するには:

UpdateDeliveryVehicle に発信します。
NOT_FOUND エラーが発生した場合は、CreateDeliveryVehicle を呼び出します。車を再現します 通話から車両が返された場合は、引き続き更新が可能です。

で確認できます。

車種

VehicleType エンティティには、オプションフィールド VehicleType が含まれます。このフィールドには、 Category 列挙型。AUTO、TWO_WHEELER、BICYCLE、または PEDESTRIAN。このフィールドを設定しない場合、デフォルトの AUTO が使用されます。

車両のすべての経路選択では、対応する RouteTravelMode を使用指定する必要があります

車両属性

DeliveryVehicle エンティティには、次の繰り返しフィールドが含まれています。 DeliveryVehicleAttribute。ListDeliveryVehicles API には filter が含まれています。返される DeliveryVehicle エンティティを、名前を持つエンティティに制限できます。表します。DeliveryVehicleAttribute は Fleet Engine に影響しませんルーティング動作を変更できます。

個人を特定できる情報（PII）や機密情報は含めないでくださいこのフィールドがユーザーに表示される可能性があるため、属性には使用しないでください。

タスクのライフサイクル

Fleet Engine では、次のコマンドを使用して、タスクの作成、更新、クエリを行うことができます。 Deliveries API gRPC または REST インターフェースを使用できます

Task オブジェクトには、進行状況を追跡する状態フィールドがあります。あります。値は OPEN から CLOSED に進みます。新しいタスクが作成されますこれは、次のいずれかを意味します。

タスクはまだ配達車両に割り当てられていません。
配達車両が、タスクに割り当てられている車両停留所をまだ通過していない。

タスクのガイドライン

タスクは、OPEN 状態の車両にのみ割り当てることができます。

車両の停車地のリストからタスクを削除すると、キャンセルできます。これにより、タスクのスケジュールが設定されます。自動的に CLOSED に変更できます。

タスクの車両がタスクの車両停止を完了した場合:

タスクの結果フィールドを SUCCEEDED または FAILED に更新します。

注: タスクの結果は、タスクの完了前後を問わず設定できるのは 1 回だけです。
イベントのタイムスタンプを指定します。

JavaScript Shipment Tracking ライブラリはタスクの結果を示し、タスクのステータスは自動的に CLOSED に設定されます。詳細については、次をご覧ください: JavaScript 配送トラッキングライブラリを使用して配送状況を追跡する。

車両の場合と同様に、Fleet Engine は 7 日以内に完了する必要があります。また、既存の ID でタスクを作成しようとすると、エラーが返されます。

注: Fleet Engine では、タスクの明示的な削除はサポートされていません。サービスタスクは、更新が行われない状態で 7 日後に自動的に削除されます。 7 日間よりも長くタスクデータを保持する場合は自分で実装する必要があります

タスクの属性

Task エンティティには、次の繰り返しフィールドが含まれています。 TaskAttribute。文字列、数値の 3 つの型のいずれかの値を取ることができます。 bool 型を指定します。ListTasks API には、返される範囲を制限できる filter フィールドが含まれています。 Task エンティティを、指定された属性を持つエンティティに変換します。タスク属性は Fleet Engine ルーティング動作に影響します。

個人を特定できる情報（PII）やその他の機密情報は含めないでください。情報を属性に含めます。これらの属性はユーザーに表示される可能性があるためです。

車両とタスクのライフサイクルの管理

注意: 内部システムは、データが処理されているデータの信頼できるソース Fleet Engine Deliveries API がお客様に代わって強化します。

システムで車両とタスクのライフサイクルを管理するには、Fleet Engine Deliveries API を使用しますを使用して車両とそれに関連するタスクを作成、更新、追跡できます。

同時に、ドライバアプリケーションは Fleet Engine に直接通信します。デバイスの位置情報とルート情報を更新します。このモデルにより Fleet Engine は効率的に管理できます。その場所が直接トラッキングライブラリがあります。このライブラリを使用して、利用者のステータスに関する最新情報を確認できます

たとえば、次のシナリオについて考えてみましょう。

ドライバーが配達所に近づいた。ドライバーアプリが位置情報を Fleet Engine
Fleet Engine はデバイスの位置情報をトラッキングライブラリです。これは、コンシューマアプリケーションがコンシューマにアラートを送信する際に使用します。荷物の近くに置いてください。
ドライバーが配送を完了した後、[Shipment delivered]（配送配送済み）をクリックします。 ] ボタンを押します。
[Shipment delivered]（配送配送済み）アクションが情報をバックエンドシステムに送信し、必要なビジネスの検証と検証の手順が実行されます。
システムはタスクが SUCCEEDED と確認され、 Deliveries API。

次の図は、これらのプロセスを一般的なレベルで示しています。また、システム、クライアント、サービス間の標準的な関係を Fleet Engine です

Deliveries API の使用

クライアントトークンを管理する

ドライバーアプリケーションから送信される位置情報の更新データ。認証トークンが必要です。おすすめの方法は次のとおりですクライアントから Fleet Engine への更新を処理します。

Fleet Engine Delivery の信頼されていないドライバユーザーを使用してトークンを生成するサービスアカウントロールを付与します
範囲が制限されたトークンをドライバアプリケーションに提供する。このスコープ Fleet Engine でのデバイスの位置情報の更新のみを許可します。

このアプローチにより、モバイルデバイスから発信された通話はコンプライアンスの原則に準拠し、最小権限の原則に従います。

他のサービスアカウントのロール

代わりに、ドライバアプリケーションがダイレクトレスポンスを Fleet Engine による更新は、信頼されていないドライバーのロールに制限されているものには適用されません。特定のタスクの更新を行う場合などには、信頼できるドライバのロールを使用できます。対象「信頼されたドライバ」ロールを使用するモデルの詳細については、以下をご覧ください。信頼できるドライバモデル。

信頼できないドライバロールの使用について詳しくは、以下をご覧ください。 Cloud プロジェクトの設定。

勤務日のモデルを作成する

次の表は、ファーストワンマイルまたはラストワンマイルのドライバーの勤務日を示しています。配送/物流会社の例ですあなたの会社は詳細は異なりますが、勤務日をどのようにモデル化すればよいかがわかります。

時間	アクティビティ	モデリング
1 日の始まりから 24 時間以内	配車担当者は、荷物を配達する車両または経路に割り当てます。	荷物の配達、集荷、休憩、配達のタスクを作成できます。 Fleet Engine で他の VM インスタンスに事前に移行する必要がありますたとえば、 shipment pickup task shipment delivery task、利用できなくなる予定所定の停留所。配達パッケージのセットが完了したら、車両にタスクを割り当てます配信順序が決定されます
1 日の始まり	ドライバーはドライバーアプリにログインして、車両センターで一日をスタートします。	Delivery Driver API を初期化します。必要に応じて Fleet Engine で配達車両を作成します。
	ドライバーが配達車両に荷物を積み込み、荷物をスキャンします。	配送タスクを事前に作成していない場合は配送タスクを作成するスキャン時に発生します
	ドライバーがタスクの実行順序を確認します。	事前に作成していない場合は配送集荷タスク利用できなくなる予定所定の停留所。
	ドライバーはデポを退出し、次のタスク数にコミット完了していません。	すべてのタスクを割り当てるか、タスクのサブセットを割り当てる車両に送ります
	ドライバーが荷物を配達する。	配送用停車地に到着したら、関連するアクションを実行する停車地に到着した車両まで通知する。配送が完了したら、提供タスク店舗の配送ステータスとその他のメタ情報。停車地と停留所の前ですべてのタスクを完了したあと、次の停車地までの運転を開始して、目的地に関連するアクションをや、次の停車地に向かっている車両などが表示されます。
	ドライバーがフィーダー車両に合流して、追加の荷物を配送車両に引き継ぐ。	配車車と配達車両間の乗り換えの待ち合わせ場所所定の停留所としてモデル化する必要がある。配送の転送とスキャンが完了したら、配送タスクを作成します。まだ作成されていない場合です。次に、タスクの完了を更新します。タスクを車両に割り当てて並べ替えるタスクの順序の更新などです。
	ドライバーが集荷リクエストの通知を受け取ります。	集荷リクエストを承認すると集荷タスクを作成します。次に、タスクの実行を更新します。タスクを車両に割り当てて並べ替えるタスクの順序の更新などです。
正午	ドライバーは昼休み。	ロケーションが利用不可タスクに関連付けられている場合は、次のように扱います。できます。車両に関連する操作を行う停車地に到着したとき車両が停車を完了や、次の停車地までのルート。それ以外の場合は、休憩が終了するまでこれ以上のアクションは必要ありません。次のタスクと残りのタスクを確認してタスクを削除するタスクの順序を更新することもできます。
	ドライバーが荷物を引き取る。	これは配送停止と同様にモデル化されます。関連するアクションの実行停車地に到着した車両までタスクを閉じます、必要に応じて配送ステータスとその他のメタ情報の保存。停車地ですべてのタスクを完了した後、運転開始前次の停車地まで、車両が停車を完了に関連するアクションを実行するや、次の停車地に向かっている車両などが表示されます。注: 請求が正しく行われるよう、すべての受け取りに、対応する提供します。集荷を配送予定日の別の場所に配送する場合その配達タスクを日常的にルート上にある他の配送タスクも確認できますドライバーが乗車する場合デポに戻るには、デポで配達タスクを作成することをおすすめします。あります。
	ドライバーが所定のスケジュールを設定して、ドロップボックスから荷物を受け取る。	他の乗車場所と同じようにモデル化されます。関連するアクションの実行停車地に到着した車両までタスクを閉じます。修了後次の停車地までの運転を開始する場合車両が停車を完了に関連するアクションを実行するや、次の停車地に向かっている車両などが表示されます。
	別の場所に配送されるという通知がドライバーに届きます。	元の配送タスクのステータスを「COMPLETED」に設定し、新しい新しい配送先に配送タスクを作成します。詳しくは配送先を変更するを参照してください。
	ドライバーが荷物を配達しようとしましたが、できませんでした。	これは配送停止の成功と同様にモデル化され、完了とみなされます。以下に関連する操作を行う停車地に到着した車両。変更後配送できなかった、タスクを閉じます。必要に応じて、店舗の配送ステータスとその他のメタ情報。停車地ですべてのタスクを完了した後、運転開始前次の停車地まで、車両が停車を完了に関連するアクションを実行するや、次の停車地に向かっている車両などが表示されます。
	荷物を留め置きする（配送しない）ようにドライバーに通知されました。	通知を受信して確認したら、タスクのステータスを COMPLETED に設定します。
	ドライバーは、コミットされた配達注文を変更して、次に特定の配送を配達するよう通知されました。	タスクの順序を更新する。
	ドライバーが注文品から配送することを選択しました。	タスクの順序を更新してから、通常どおり進めます
	ドライバーが 1 か所に複数の荷物を配達する。	これは、単一の配送中止と同様にモデル化されます。停車地に到着したら、その停車地に関連するアクションを停車地に到着する車両。配送ごとに、各タスクを閉じますおよび必要に応じて店舗の配送ステータスとその他のメタ情報を指定します。停車地ですべてのタスクを完了した後、運転開始前次の停車地まで、車両が停車を完了に関連するアクションを実行するや、次の停車地に向かっている車両などが表示されます。
1 日の終わり	ドライバーが車両庫に戻る。	配送中にドライバーが荷物を回収してデポに戻った場合各パッケージを配信タスクとして作成してクローズし、請求が正しく行われるようにしますそのためには、他のプラットフォームと同様に配送中止です配送拠点を配送の停車地として使用していない場合でも、所定の停留所としてデポをモデル化します。停車地をモデル化することで、ドライバーは停車地の状況を基地までのルートを計算し、推定所要時間を可視化表示されます。

位置情報の更新の仕組み

Fleet Engine で最高のパフォーマンスを得るには、車両の流れを提供します位置情報の更新これらの更新を提供するには、次のいずれかの方法を使用します。

Driver SDK を使用する - Android、 iOS -- 最もシンプルなオプションです。
カスタムコードを使用します。中継に使用されるか、Android または iOS 以外のデバイスを iOS。

車両の位置情報の更新を提供する方法にかかわらず、バックエンドは Fleet Engine は、配達車両の運航状況が停車地へのルート（車両基地を含む）と、ユーザーが停車地に到着したとき。Fleet Engine はこれらのイベントを検出しない自動的に適用されます。

車両の停車地と配達場所

車両停止とは、配達車両が出荷タスクを完了する場所です。できます。ローディングホルダーなどのアクセスポイント、またはスナップされた場所。

配送先とは、荷物が配送される場所のことです。選択します配達先までの移動には徒歩が必要になる場合があります通知を受け取れます。

たとえばドライバーがショッピングモール内の店舗に荷物を配達する場合配達車両が、ショッピングモールの近くの駐車場に停車します。店舗に最も近いエントランス。これが車両の停留所です。ドライバーそして停車地からショッピングモール内の場所まで表示されます。配送先です。

配送状況を追跡できるように、配送タスクは車両の停車地に割り当てられます。また、配送タスクのための残りの車両停車地がユーザーに報告され、配送の進行状況を確認できます。

たとえばドライバーが 1 つのオフィスビルに多数の荷物を配達する場合すべての配達タスクを 1 つの車両停車地に割り当てることを検討してください。条件各配送タスクはそれぞれの停車地に割り当てられますユーザーの役に立ちません制限時間内に停車するまでの間に進んだ場合に利用可能あります。短時間に何度も停車を完了しても、ユーザーが配信の進捗状況を追跡するのに十分な時間を要することになるからです。

モバイル SDK を使用する

Driver SDK を呼び出す前に、必ず初期化してください。

Delivery Driver API を初期化する

Driver SDK で Delivery Driver API を初期化する前に、 Navigation SDK を初期化します。次の例のように Delivery Driver API を初期化します。

static final String PROVIDER_ID = "provider-1234";
static final String VEHICLE_ID = "vehicle-8241890";

NavigationApi.getNavigator(
   this, // Activity.
   new NavigatorListener() {
     @Override
     public void onNavigatorReady(Navigator navigator) {
       DeliveryDriverApi.createInstance(DriverContext.builder(getApplication())
         .setNavigator(navigator)
         .setProviderId(PROVIDER_ID)
         .setVehicleId(VEHICLE_ID)
         .setAuthTokenFactory((context) -> "JWT") // AuthTokenFactory returns JWT for call context.
         .setRoadSnappedLocationProvider(NavigationApi.getRoadSnappedLocationProvider(getApplication()))
         .setNavigationTransactionRecorder(NavigationApi.getNavigationTransactionRecorder(getApplication()))
         .setStatusListener((statusLevel,statusCode,statusMsg) -> // Optional, surfaces polling errors.
             Log.d("TAG", String.format("New status update. %s, %s, %s", statusLevel, statusCode, statusMsg)))
         .build));
     }
     @Override
     public void onError(int errorCode) {
       Log.e("TAG", String.format("Error loading Navigator instance: %s", errorCode));
     }
   });

ユースケース

このセクションでは、Deliveries API を使用して一般的なユースケースをモデル化する方法について説明します。

エンティティの固有識別子

REST 呼び出しで使用される一意の識別子の形式と値は次のとおりです。 Fleet Engine には不透明です。ID の自動インクリメントは使用せず、識別子に個人情報（PII）が含まれていない。電話番号などの個人情報を取得できます

車両を作成する

車両を作成するには、 Driver SDK を使用することも、gRPC や REST を使用してサーバー環境から読み込むこともできます。

gRPC

新しい車両を作成するには、Fleet Engine に対して CreateDeliveryVehicle 呼び出しを行います。 CreateDeliveryVehicleRequest オブジェクトを使用して、提供しますName フィールドに指定された値はすべてユーザー指定の ID に関する API ガイダンスに従って無視されます。 DeliveryVehicleId フィールドを使用して車両の ID を設定する必要があります。

DeliveryVehicle を作成するときに、必要に応じて次のフィールドを指定できます。

属性
LastLocation
タイプ

他のフィールドは設定しないでください。そのようにした場合、Fleet Engine はエラーを返します。これらのフィールドは読み取り専用であるか、 UpdateDeliveryVehicle。

オプションフィールドを設定せずに車両を作成するには、 CreateDeliveryVehicleRequest で DeliveryVehicle フィールドの設定が解除されました。

次の例は、BigQuery の Java gRPC ライブラリ車両を作成するには:

    static final String PROJECT_ID = "my-delivery-co-gcp-project";
    static final String VEHICLE_ID = "vehicle-8241890"; // Avoid auto-incrementing IDs.

    DeliveryServiceBlockingStub deliveryService =
      DeliveryServiceGrpc.newBlockingStub(channel);

    // Vehicle settings
    String parent = "providers/" + PROJECT_ID;
    DeliveryVehicle vehicle = DeliveryVehicle.newBuilder()
      .addAttributes(DeliveryVehicleAttribute.newBuilder()
        .setKey("route_number").setValue("1"))  // Opaque to the Fleet Engine
      .build();

    // Vehicle request
    CreateDeliveryVehicleRequest createVehicleRequest =
      CreateDeliveryVehicleRequest.newBuilder()  // No need for the header
          .setParent(parent)
          .setDeliveryVehicleId(VEHICLE_ID)     // Vehicle ID assigned by the Provider
          .setDeliveryVehicle(vehicle)
          .build();

    // Error handling
    // If Fleet Engine does not have vehicle with that ID and the credentials of the
    // requestor pass, the service creates the vehicle successfully.

    try {
      DeliveryVehicle createdVehicle =
        deliveryService.createDeliveryVehicle(createVehicleRequest);
    } catch (StatusRuntimeException e) {
      Status s = e.getStatus();
      switch (s.getCode()) {
         case ALREADY_EXISTS:
           break;
         case PERMISSION_DENIED:
           break;
      }
      return;
    }

REST

サーバー環境から車両を作成するには、HTTP REST 呼び出しを行います CreateDeliveryVehicle に変更:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles?deliveryVehicleId=<id>

<id> は、フリート内の配送車両の一意の識別子です。

リクエストヘッダーには、次の値を含む Authorization フィールドが含まれている必要があります。 Bearer <token>: ここで、<token> は Fleet Engine トークンファクトリによって発行されたトークンです。

POST 本文は、作成される DeliveryVehicle エンティティを表します。このように次のオプションフィールドを使用できます。

属性
lastLocation
type

curl コマンドの例:

# Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
--data-binary @- << EOM
{
  "attributes": [{"key": "model", "value": "sedan"}],
  "lastLocation": {"location": {"latitude": 12.1, "longitude": 14.5}}
}
EOM

Fleet Engine は、ユーザー指定の ID に関する API ガイダンスに従って DeliveryVehicle エンティティの name フィールドを無視します。他のフィールドは設定しないでください。そのようにした場合、Fleet Engine はエラーを返します。これらのフィールドは読み取り専用であるか、 UpdateDeliveryVehicle。

フィールドを設定せずに車両を作成するには、POST の本文を残します。リクエストが空です。次に、新しく作成された車両が車両 ID を POST URL の deliveryVehicleId パラメータ

curl コマンドの例:

# Set $JWT, $PROJECT_ID, and $VEHICLE_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?deliveryVehicleId=${VEHICLE_ID}" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}"

配送集荷タスクを作成する

集荷タスクは、Google Cloud コンソールまたは Driver SDK サーバー環境から gRPC や REST を使用して

gRPC

次の例は、BigQuery の Java gRPC ライブラリ集荷タスクを作成するには:

static final String PROJECT_ID = "my-delivery-co-gcp-project";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Task settings
String parent = "providers/" + PROJECT_ID;
Task task = Task.newBuilder()
  .setType(Task.Type.PICKUP)
  .setState(Task.State.OPEN)
  .setTrackingId("my-tracking-id")
  .setPlannedLocation(               // Grand Indonesia East Mall
    LocationInfo.newBuilder().setPoint(
      LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
  .setTaskDuration(
    Duration.newBuilder().setSeconds(2 * 60))
  .setTargetTimeWindow(
    TimeWindow.newBuilder()
      .setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
      .setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
  .addAttributes(TaskAttribute.newBuilder().setKey("foo").setStringValue("value"))
  .addAttributes(TaskAttribute.newBuilder().setKey("bar").setNumberValue(10))
  .addAttributes(TaskAttribute.newBuilder().setKey("baz").setBoolValue(false))
  .build();

// Task request
CreateTaskRequest createTaskRequest =
  CreateTaskRequest.newBuilder()  // No need for the header
      .setParent(parent)          // Avoid using auto-incrementing IDs for the taskId
      .setTaskId("task-8241890")  // Task ID assigned by the Provider
      .setTask(task)              // Initial state
      .build();

// Error handling
// If Fleet Engine does not have a task with that ID and the credentials of the
// requestor pass, the service creates the task successfully.

try {
  Task createdTask = deliveryService.createTask(createTaskRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case ALREADY_EXISTS:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境からの配送集荷タスクを作成するには、HTTP REST 呼び出しを行います。 CreateTask に変更:

`POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>`

<id> は、タスクの一意の識別子です。荷物追跡番号は使用できません。提供します。システムにタスク ID がない場合、 UUID（Universally Unique Identifier）などがあります

リクエストの本文には Task エンティティを含める必要があります。

必須フィールド:

項目	値
type	Type.PICKUP
state	State.OPEN
trackingId	配送の追跡に使用する番号または ID。
plannedLocation	タスクを実施する場所。この場合は、配送の集荷場所。
taskDuration	荷物の集荷にかかる予想時間（秒）受け取り場所にします

省略可能項目:

項目	値
targetTimeWindow	タスクを完了する時間枠。ただし、ルーティング動作に影響します
属性	カスタムタスク属性のリスト。各属性には一意のキーが必要です。

エンティティのその他のフィールドはすべて、作成の際に無視されます。フリートエンジンのスローリクエストに deliveryVehicleId が割り当てられている場合は例外。ユーザーが UpdateDeliveryVehicleRequest を使用してタスクを処理できます。詳細については、次をご覧ください: タスクを車両に割り当て、UpdateDeliveryVehicleRequest。

curl コマンドの例:

# Set $JWT, $PROJECT_ID, $TRACKING_ID, and $TASK_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "type": "PICKUP",
  "state": "OPEN",
  "trackingId": "${TRACKING_ID}",
  "plannedLocation": {
     "point": {
        "latitude": -6.195139,
        "longitude": 106.820826
     }
  },
  "taskDuration": "90s",
  "targetTimeWindow": {
    "startTime": "2023-03-29T21:00:00Z",
    "endTime": "2023-03-29T23:00:00Z"
  }
}
EOM

配送タスクを作成する

配送タスクを作成するには、 Driver SDK サーバー環境から gRPC や REST を使用して

gRPC

次の例は、BigQuery の Java gRPC ライブラリ配送タスクを作成するには:

static final String PROJECT_ID = "my-delivery-co-gcp-project";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Task settings
String parent = "providers/" + PROJECT_ID;
Task task = Task.newBuilder()
  .setType(Task.Type.DELIVERY)
  .setState(Task.State.OPEN)
  .setTrackingId("my-tracking-id")
  .setPlannedLocation(               // Grand Indonesia East Mall
    LocationInfo.newBuilder().setPoint(
      LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
  .setTaskDuration(
    Duration.newBuilder().setSeconds(2 * 60))
  .setTargetTimeWindow(
    TimeWindow.newBuilder()
      .setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
      .setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
  .addAttributes(TaskAttribute.newBuilder().setKey("foo").setStringValue("value"))
  .addAttributes(TaskAttribute.newBuilder().setKey("bar").setNumberValue(10))
  .addAttributes(TaskAttribute.newBuilder().setKey("baz").setBoolValue(false))
  .build();

// Task request
CreateTaskRequest createTaskRequest =
  CreateTaskRequest.newBuilder()  // No need for the header
      .setParent(parent)          // Avoid using auto-incrementing IDs for the taskId
      .setTaskId("task-8241890")  // Task ID assigned by the Provider
      .setTask(task)              // Initial state
      .build();

// Error handling
// If Fleet Engine does not have task with that ID and the credentials of the
// requestor pass, the service creates the task successfully.

try {
  Task createdTask = deliveryService.createTask(createTaskRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case ALREADY_EXISTS:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

gRPC または REST を使用してサーバー環境から配送タスクを作成するには、HTTP REST 呼び出しを行います。 CreateTask に変更:

`POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>`

リクエストの本文には Task エンティティを含める必要があります。

必須フィールド:

項目	値
type	Type.DELIVERY
state	State.OPEN
trackingId	配送の追跡に使用する番号または ID。
plannedLocation	タスクを実施する場所。この場合は、配送先の場所を指定します
taskDuration	配送予定日（秒）受け取ります

省略可能項目:

項目	値
targetTimeWindow	タスクを完了する時間枠。ただし、ルーティング動作に影響します
属性	カスタムタスク属性のリスト。各属性には一意のキーが必要です。

エンティティのその他のフィールドはすべて、作成の際に無視されます。フリートエンジンのスロー割り当てられた deliveryVehicleId がリクエストに含まれている場合は例外。ユーザーが UpdateDeliveryVehicleRequest を使用してタスクを処理できます。詳細については、次をご覧ください: タスクを車両に割り当て、UpdateDeliveryVehicleRequest。

curl コマンドの例:

# Set $JWT, $PROJECT_ID, $TRACKING_ID, and $TASK_ID in the local
# environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "type": "DELIVERY",
  "state": "OPEN",
  "trackingId": "${TRACKING_ID}",
  "plannedLocation": {
     "point": {
        "latitude": -6.195139,
        "longitude": 106.820826
     }
  },
  "taskDuration": "90s",
  "targetTimeWindow": {
    "startTime": "2023-03-29T21:00:00Z",
    "endTime": "2023-03-29T23:00:00Z"
  }
}
EOM

タスクのバッチ作成

gRPC または REST を使用して、サーバー環境からタスクのバッチを作成できます。

gRPC

次の例は、BigQuery の Java gRPC ライブラリ配達と受け取りの 2 つのタスクを作成する location:

static final String PROJECT_ID = "my-delivery-co-gcp-project";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Delivery Task settings
Task deliveryTask = Task.newBuilder()
  .setType(Task.Type.DELIVERY)
  .setState(Task.State.OPEN)
  .setTrackingId("delivery-tracking-id")
  .setPlannedLocation(               // Grand Indonesia East Mall
    LocationInfo.newBuilder().setPoint(
      LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
  .setTaskDuration(
    Duration.newBuilder().setSeconds(2 * 60))
  .build();

// Delivery Task request
CreateTaskRequest createDeliveryTaskRequest =
  CreateTaskRequest.newBuilder()  // No need for the header or parent fields
      .setTaskId("task-8312508")  // Task ID assigned by the Provider
      .setTask(deliveryTask)      // Initial state
      .build();

// Pickup Task settings
Task pickupTask = Task.newBuilder()
  .setType(Task.Type.PICKUP)
  .setState(Task.State.OPEN)
  .setTrackingId("pickup-tracking-id")
  .setPlannedLocation(               // Grand Indonesia East Mall
    LocationInfo.newBuilder().setPoint(
      LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
  .setTaskDuration(
    Duration.newBuilder().setSeconds(2 * 60))
  .build();

// Pickup Task request
CreateTaskRequest createPickupTaskRequest =
  CreateTaskRequest.newBuilder()  // No need for the header or parent fields
      .setTaskId("task-8241890")  // Task ID assigned by the Provider
      .setTask(pickupTask)        // Initial state
      .build();

// Batch Create Tasks settings
String parent = "providers/" + PROJECT_ID;

// Batch Create Tasks request
BatchCreateTasksRequest batchCreateTasksRequest =
  BatchCreateTasksRequest.newBuilder()
      .setParent(parent)
      .addRequests(createDeliveryTaskRequest)
      .addRequests(createPickupTaskRequest)
      .build();

// Error handling
// If Fleet Engine does not have any task(s) with these task ID(s) and the
// credentials of the requestor pass, the service creates the task(s)
// successfully.

try {
  BatchCreateTasksResponse createdTasks = deliveryService.batchCreateTasks(
    batchCreateTasksRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case ALREADY_EXISTS:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境から配達と受け取りのタスクを作成するには、 BatchCreateTasks への HTTP REST 呼び出し:

POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks:batchCreate

リクエストヘッダーには、フィールド Authorization が含まれ、値は Bearer <token>（<token> は Fleet Engine トークンファクトリによって発行されたトークン。

リクエストの本文には BatchCreateTasksRequest エンティティを含める必要があります。

必須フィールド:

項目値

リクエスト配列<CreateTasksRequest>
省略可能フィールド:

項目値

header `DeliveryRequestHeader`

項目	値
リクエスト	配列<`CreateTasksRequest`>

項目	値
header	`DeliveryRequestHeader`

requests 内の各 CreateTasksRequest 要素は同じ検証に合格する必要がありますルールがCreateTaskリクエストとして認識されます。ただし、parent header フィールドは省略可能です。設定する場合は、最上位の BatchCreateTasksRequest でそれぞれのフィールドを参照します。詳しくは、集荷タスクを作成し、配送タスクを作成するをご覧ください。

詳細については、BatchCreateTasks の API リファレンスドキュメントをご覧ください。（gRPC、REST）。

curl コマンドの例:

# Set $JWT, $PROJECT_ID, $DELIVERY_TRACKING_ID, $DELIVERY_TASK_ID,
# $PICKUP_TRACKING_ID, and $PICKUP_TASK_ID in the local environment
curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks:batchCreate" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "requests" : [
    {
      "taskId": "${DELIVERY_TASK_ID}",
      "task" : {
        "type": "DELIVERY",
        "state": "OPEN",
        "trackingId": "${DELIVERY_TRACKING_ID}",
        "plannedLocation": {
          "point": {
              "latitude": -6.195139,
              "longitude": 106.820826
          }
        },
        "taskDuration": "90s"
      }
    },
    {
      "taskId": "${PICKUP_TASK_ID}",
      "task" : {
        "type": "PICKUP",
        "state": "OPEN",
        "trackingId": "${PICKUP_TRACKING_ID}",
        "plannedLocation": {
          "point": {
              "latitude": -6.195139,
              "longitude": 106.820826
          }
        },
        "taskDuration": "90s"
      }
    }
  ]
}
EOM

スケジュール設定された利用停止

使用不能であることを示すタスクを作成できます（例: ドライバ給油、給油など）や、 Driver SDK サーバー環境から gRPC や REST を使用してスケジュール設定された利用不能なタスクには、次の内容を含めることはできませんトラッキング ID必要に応じて場所を指定できます。

gRPC

次の例は、BigQuery の Java gRPC ライブラリ次のように使用します。

    static final String PROJECT_ID = "my-delivery-co-gcp-project";

    DeliveryServiceBlockingStub deliveryService =
      DeliveryServiceGrpc.newBlockingStub(channel);

    // Task settings
    String parent = "providers/" + PROJECT_ID;
    Task task = Task.newBuilder()
      .setType(Task.Type.UNAVAILABLE)
      .setState(Task.State.OPEN)
      .setTaskDuration(
        Duration.newBuilder().setSeconds(60 * 60))  // 1hr break
      .build();

    // Task request
    CreateTaskRequest createTaskRequest =
      CreateTaskRequest.newBuilder()  // No need for the header
          .setParent(parent)          // Avoid using auto-incrementing IDs for the taskId
          .setTaskId("task-8241890")  // Task ID assigned by the Provider
          .setTask(task)              // Initial state
          .build();

    // Error handling
    // If Fleet Engine does not have task with that ID and the credentials of the
    // requestor pass, the service creates the task successfully.

    try {
      Task createdTask = deliveryService.createTask(createTaskRequest);
    } catch (StatusRuntimeException e) {
      Status s = e.getStatus();
      switch (s.getCode()) {
         case ALREADY_EXISTS:
           break;
         case PERMISSION_DENIED:
           break;
      }
      return;
    }

REST

サーバー環境から利用不可タスクを作成するには、HTTP REST 呼び出しを行います CreateTask に変更:

`POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>`

<id> は、タスクの一意の識別子です。この操作をタスク ID がある場合、ユニバーサルな一意の ID をあります。

リクエストの本文には Task エンティティを含める必要があります。

必須フィールド:

項目値

type Type.UNAVAILABLE

state State.OPEN

taskDuration 休憩時間（秒）。
省略可能項目:

項目値

plannedLocation 特定の場所で撮影する必要がある場合、休憩の場所。

項目	値
type	Type.UNAVAILABLE
state	State.OPEN
taskDuration	休憩時間（秒）。

項目	値
plannedLocation	特定の場所で撮影する必要がある場合、休憩の場所。

curl コマンドの例:

    # Set $JWT, $PROJECT_ID, and $TASK_ID in the local environment
    curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
      -H "Content-type: application/json" \
      -H "Authorization: Bearer ${JWT}" \
      --data-binary @- << EOM
    {
      "type": "UNAVAILABLE",
      "state": "OPEN",
      "plannedLocation": {
         "point": {
            "latitude": -6.195139,
            "longitude": 106.820826
         }
      },
      "taskDuration": "300s"
    }
    EOM

スケジュール設定された停車地

スケジュール設定された停止タスクは、 Driver SDK サーバー環境から gRPC や REST を使用してスケジュール設定された停止タスクには、あります。

gRPC

次の例は、BigQuery の Java gRPC ライブラリスケジュール設定された停止タスクを作成するには:

static final String PROJECT_ID = "my-delivery-co-gcp-project";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Task settings
String parent = "providers/" + PROJECT_ID;
Task task = Task.newBuilder()
  .setType(Task.Type.SCHEDULED_STOP)
  .setState(Task.State.OPEN)
  .setPlannedLocation(               // Grand Indonesia East Mall
    LocationInfo.newBuilder().setPoint(
      LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
  .setTaskDuration(
    Duration.newBuilder().setSeconds(2 * 60))
  .build();

// Task request
CreateTaskRequest createTaskRequest =
  CreateTaskRequest.newBuilder()  // No need for the header
      .setParent(parent)
      .setTaskId("task-8241890")  // Task ID assigned by the Provider
      .setTrip(task)              // Initial state
      .build();

// Error handling
// If Fleet Engine does not have task with that ID and the credentials of the
// requestor pass, the service creates the task successfully.

try {
  Task createdTask = deliveryService.createTask(createTaskRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case ALREADY_EXISTS:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境からスケジュール設定された停止タスクを作成するには、HTTP REST 呼び出しを行います。 CreateTask に変更:

`POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id>`

<id> は、タスクの一意の識別子です。まだ設定していない場合は特定のタスク ID のみを生成する場合、 UUID（Universally Unique Identifier）などがあります

リクエストの本文には Task エンティティを含める必要があります。

必須フィールド:

項目値

type Type.SCHEDULED_STOP

state State.OPEN

plannedLocation 停車地の場所。

taskDuration 予測される停車地の所要時間（秒単位）。
省略可能フィールド:
- なし

項目	値
type	Type.SCHEDULED_STOP
state	State.OPEN
plannedLocation	停車地の場所。
taskDuration	予測される停車地の所要時間（秒単位）。

curl コマンドの例:

    # Set $JWT, $PROJECT_ID, and $TASK_ID in the local environment
    curl -X POST "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?taskId=${TASK_ID}" \
      -H "Content-type: application/json" \
      -H "Authorization: Bearer ${JWT}" \
      --data-binary @- << EOM
    {
      "type": "SCHEDULED_STOP",
      "state": "OPEN",
      "plannedLocation": {
         "point": {
            "latitude": -6.195139,
            "longitude": 106.820826
         }
      },
      "taskDuration": "600s"
    }
    EOM

ターゲット時間枠の設定

ターゲット時間枠は TimeWindow その間にタスクを完了する必要があります。たとえば、タスクのターゲット時間を使用して、時間枠をキャプチャしてアラートの生成や移動後の分析を行うパフォーマンス指標です。

ターゲット時間枠は開始時刻と終了時刻で構成され、どのタイプのタスクにも適用できます。ターゲット時間枠はルーティングに影響しない確認します。

gRPC

次の例は、BigQuery の Java gRPC ライブラリタスクの時間枠を設定するには:

    static final String PROJECT_ID = "my-delivery-co-gcp-project";
    static final String TASK_ID = "task-8241890";

    DeliveryServiceBlockingStub deliveryService =
      DeliveryServiceGrpc.newBlockingStub(channel);

    // Task settings
    String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
    Task task = Task.newBuilder()
      .setName(taskName)
      .setTargetTimeWindow(
        TimeWindow.newBuilder()
          .setStartTime(Timestamp.newBuilder().setSeconds(1680123600))
          .setEndTime(Timestamp.newBuilder().setSeconds(1680130800)))
      .build();

    // Task request
    UpdateTaskRequest updateTaskRequest =
      UpdateTaskRequest.newBuilder()  // No need for the header
          .setTask(task)
          .setUpdateMask(FieldMask.newBuilder().addPaths("targetTimeWindow"))
          .build();

    try {
      Task updatedTask = deliveryService.updateTask(updateTaskRequest);
    } catch (StatusRuntimeException e) {
      Status s = e.getStatus();
      switch (s.getCode()) {
         case NOT_FOUND:
           break;
         case PERMISSION_DENIED:
           break;
      }
      return;
    }

REST

HTTP を使用してタスクの時間枠を設定するには、UpdateTask を呼び出します。

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=targetTimeWindow`

<id> は、タスクの一意の識別子です。

リクエストの本文には Task エンティティを含める必要があります。

必須フィールド:

項目値

targetTimeWindow タスクを完了する時間枠。この設定ルーティング動作に影響しない
省略可能フィールド:
- なし

項目	値
targetTimeWindow	タスクを完了する時間枠。この設定ルーティング動作に影響しない

エンティティに含まれる他のフィールドはすべて更新時に無視されます。

curl コマンドの例:

# Set JWT, PROJECT_ID, and TASK_ID in the local environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=targetTimeWindow" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "targetTimeWindow": {
    "startTime": "2023-03-29T21:00:00Z",
    "endTime": "2023-03-29T23:00:00Z"
  }
}
EOM

タスクトラッキングの公開設定を設定する

配送追跡ライブラリ内のデータとそのデータの可視性 GetTaskTrackingInfo の呼び出しから返される値をタスクごとに制御できるアラートポリシーを設定するか TaskTrackingViewConfig できます。詳しくは、アクティブな車両タスクをご覧ください。これは、テンプレートの作成時または更新時にタスクを実行します。この構成を使用してタスクを更新する例を次に示します。

gRPC

次の例は、BigQuery の Java gRPC ライブラリタスクトラッキングビュー構成を設定します。

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Task settings
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
Task task = Task.newBuilder()
  .setName(taskName)
  .setTaskTrackingViewConfig(
    TaskTrackingViewConfig.newBuilder()
      .setRoutePolylinePointsVisibility(
        VisibilityOption.newBuilder().setRemainingStopCountThreshold(3))
      .setEstimatedArrivalTimeVisibility(
        VisibilityOption.newBuilder().remainingDrivingDistanceMetersThreshold(5000))
      .setRemainingStopCountVisibility(
        VisibilityOption.newBuilder().setNever(true)))
  .build();

// Task request
UpdateTaskRequest updateTaskRequest =
  UpdateTaskRequest.newBuilder()  // No need for the header
      .setTask(task)
      .setUpdateMask(FieldMask.newBuilder().addPaths("taskTrackingViewConfig"))
      .build();

try {
  Task updatedTask = deliveryService.updateTask(updateTaskRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
      case NOT_FOUND:
        break;
      case PERMISSION_DENIED:
        break;
  }
  return;
}

REST

HTTP を使用してタスクトラッキングビュー構成ウィンドウを設定するには、UpdateTask を呼び出します。

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=taskTrackingViewConfig`

<id> は、タスクの一意の識別子です。

リクエストの本文には Task エンティティを含める必要があります。

必須フィールド:

項目	値
taskTrackingViewConfig	タスクトラッキング用の構成で、どのデータ要素を指定するかエンドユーザーがどのような状況で表示できるかを確認する

省略可能フィールド:
- なし

エンティティに含まれる他のフィールドはすべて更新時に無視されます。

curl コマンドの例:

# Set JWT, PROJECT_ID, and TASK_ID in the local environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=taskTrackingViewConfig" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "estimatedArrivalTimeVisibility": {
      "remainingDrivingDistanceMetersThreshold": 5000
    },
    "remainingStopCountVisibility": {
      "never": true
    }
  }
}
EOM

車両にタスクを割り当てる

タスクの順序を更新して、配達車両にタスクを割り当てる指定します。車両のタスクの順序はリストによって決まります。車両の停車地の数と、1 つ以上のタスクを割り当てることができる各停車地に到着します詳しくは、タスクの順序を更新する。

配送を別の車両に変更するには、元のタスクを閉じます新しい車両に割り当てる前に再作成する必要がありますタスクを更新した場合すでに割り当てられているタスクの順序を別の車両に接続すると、エラーが発生します。

タスクの順序を更新

車両に割り当てられた注文タスクは、次のいずれかの方法で更新できます。 Driver SDK 重要な役割を果たします。これを回避するには、両方の方法を使用しないでください。競合状態を回避し、信頼できる唯一の情報源を維持できます。

車両のタスクの順序を更新すると、次の処理も行われます。

車両に新しいタスクを割り当てます。
以前に車両に割り当てられていたが、割り当てられていないタスクをすべて終了する表します。

ある車両から別の車両に配送を変更する手順は次のとおりです。元のタスクを閉じます新しい車両に割り当てる前に再作成する必要がありますタスクを更新した場合すでに割り当てられているタスクの順序を別の車両に接続すると、エラーが発生します。

タスクの順序はいつでも変更できます。

gRPC

次の例は、BigQuery の Java gRPC ライブラリ車両のタスクの順序を更新するには、次のようにします。

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";
static final String TASK1_ID = "task-756390";
static final String TASK2_ID = "task-849263";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
    .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // 1st stop
       .setStop(VehicleStop.newBuilder()
           .setPlannedLocation(LocationInfo.newBuilder()
               .setPoint(LatLng.newBuilder()
                   .setLatitude(37.7749)
                   .setLongitude(122.4194)))
           .addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
           .setState(VehicleStop.State.NEW)))
    .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // 2nd stop
       .setStop(VehicleStop.newBuilder()
           .setPlannedLocation(LocationInfo.newBuilder()
               .setPoint(LatLng.newBuilder()
                   .setLatitude(37.3382)
                   .setLongitude(121.8863)))
           .addTasks(TaskInfo.newBuilder().setTaskId(TASK2_ID))
           .setState(VehicleStop.State.NEW)))
    .build();

// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryRequest =
  UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
      .setName(vehicleName)
      .setDeliveryVehicle(deliveryVehicle)
      .setUpdateMask(FieldMask.newBuilder().addPaths("remaining_vehicle_journey_segments"))
      .build();

try {
  DeliveryVehicle updatedDeliveryVehicle =
      deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境から車両のタスクの順序を更新するには、HTTP REST 呼び出しを行います UpdateDeliveryVehicle に変更:

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=remainingVehicleJourneySegments`

<id> は、フリート内の配送車両の一意の識別子です。タスクの順序を更新する対象となるプロダクトです。これは Chronicle SOAR が必要があります。

リクエストの本文には DeliveryVehicle エンティティを含める必要があります。

必須フィールド:

項目	値
remainingVehicleJourneySegments	タスクの実行過程のセグメントのリスト。リスト内の最初のタスクが最初に実行されます。
remainingVehicleJourneySegments[i].stop	リスト内のタスク i の停止。
remainingVehicleJourneySegments[i].stop.plannedLocation	停車地の計画されている場所。
remainingVehicleJourneySegments[i].stop.tasks	この停車地で実行されるタスクのリスト。
remainingVehicleJourneySegments[i].stop.state	State.NEW

省略可能フィールド:
- なし

エンティティに含まれる他のフィールドはすべて更新時に無視されます。

curl コマンドの例:

# Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
# environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "remainingVehicleJourneySegments": [
    {
      "stop": {
        "state": "NEW",
        "plannedLocation": {
          "point": {
            "latitude": 37.7749,
            "longitude": -122.084061
          }
        },
        "tasks": [
          {
            "taskId": "${TASK1_ID}"
          }
        ]
      }
    },
    {
      "stop": {
        "state": "NEW",
        "plannedLocation": {
          "point": {
            "latitude": 37.3382,
            "longitude": 121.8863
          }
        },
        "tasks": [
          {
            "taskId": "${TASK2_ID}"
          }
        ]
      }
    }
  ]
}
EOM

車両は次の駅に向かっています

Fleet Engine は、車両が停車地から出発するか始動したときに通知する必要があります。ナビゲーションです。Fleet Engine は、サービスアカウントまたは Driver SDK サーバー環境から gRPC や REST を使用して競合を避けるため、両方の方法を使用しない信頼できる唯一の情報源を維持する必要があります。

gRPC

次の例は、BigQuery の Java gRPC ライブラリ車両が次の停車地に向かっていることを Fleet Engine に通知する

    static final String PROJECT_ID = "my-delivery-co-gcp-project";
    static final String VEHICLE_ID = "vehicle-8241890";

    DeliveryServiceBlockingStub deliveryService =
      DeliveryServiceGrpc.newBlockingStub(channel);

    // Vehicle settings
    DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
        // Next stop marked as ENROUTE
        .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // 1st stop
           .setStop(VehicleStop.newBuilder()
               .setPlannedLocation(LocationInfo.newBuilder()
                   .setPoint(LatLng.newBuilder()
                       .setLatitude(37.7749)
                       .setLongitude(122.4194)))
               .addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
               .setState(VehicleStop.State.ENROUTE)))
        // All other stops marked as NEW
        .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // 2nd stop
           .setStop(VehicleStop.newBuilder()
               .setPlannedLocation(LocationInfo.newBuilder()
                   .setPoint(LatLng.newBuilder()
                       .setLatitude(37.3382)
                       .setLongitude(121.8863)))
               .addTasks(TaskInfo.newBuilder().setTaskId(TASK2_ID))
               .setState(VehicleStop.State.NEW)))
        .build();

    // DeliveryVehicle request
    UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
      UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
          .setName(vehicleName)
          .setDeliveryVehicle(deliveryVehicle)
          .setUpdateMask(FieldMask.newBuilder().addPaths("remaining_vehicle_journey_segments"))
          .build();

    try {
      DeliveryVehicle updatedDeliveryVehicle =
          deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
    } catch (StatusRuntimeException e) {
      Status s = e.getStatus();
      switch (s.getCode()) {
         case NOT_FOUND:
           break;
         case PERMISSION_DENIED:
           break;
      }
      return;
    }

REST

車両が目的地から次の停車地に向かっていることを Fleet Engine に通知するには、 UpdateDeliveryVehicle に対して HTTP REST 呼び出しを行います。

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=remainingVehicleJourneySegments`

<id> は、フリート内の配送車両の一意の識別子です。タスクの順序を更新する対象となるプロダクトです。これは Chronicle SOAR が必要があります。

リクエストの本文には DeliveryVehicle エンティティを含める必要があります。

必須フィールド:

項目	値
remainingVehicleJourneySegments	状態が State.NEW とマークされた残りの車両停車地のリスト。リストの最初の停車地は、State.ENROUTE とマークする必要があります。

省略可能フィールド:
- なし

エンティティの他のフィールドはすべて、通知では無視されます。

curl コマンドの例:

# Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
# environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "remainingVehicleJourneySegments": [
    {
      "stop": {
        "state": "ENROUTE",
        "plannedLocation": {
          "point": {
            "latitude": 37.7749,
            "longitude": -122.084061
          }
        },
        "tasks": [
          {
            "taskId": "${TASK1_ID}"
          }
        ]
      }
    },
    {
      "stop": {
        "state": "NEW",
        "plannedLocation": {
          "point": {
            "latitude": 37.3382,
            "longitude": 121.8863
          }
        },
        "tasks": [
          {
            "taskId": "${TASK2_ID}"
          }
        ]
      }
    }
  ]
}
EOM

車両の位置情報の更新

車両の位置情報の更新に Driver SDK を使用しない場合は、車両の位置情報とともに Fleet Engine に直接呼び出します。アクティブな車両の場合 Fleet Engine は、少なくとも 1 分に 1 回、最大で位置情報の更新を要求する更新頻度は 5 秒に 1 回です

gRPC

次の例は、BigQuery の Java gRPC ライブラリ Fleet Engine で車両の位置情報を更新するには:

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle myDeliveryVehicle = DeliveryVehicle.newBuilder()
    .setLastLocation(DeliveryVehicleLocation.newBuilder()
        .setSupplementalLocation(LatLng.newBuilder()
            .setLatitude(37.3382)
            .setLongitude(121.8863))
        .setSupplementalLocationTime(now())
        .setSupplementalLocationSensor(DeliveryVehicleLocationSensor.CUSTOMER_SUPPLIED_LOCATION)
        .setSupplementalLocationAccuracy(DoubleValue.of(15.0)))  // Optional
    .build();

// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
  UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
      .setName(vehicleName)
      .setDeliveryVehicle(myDeliveryVehicle)
      .setUpdateMask(FieldMask.newBuilder()
          .addPaths("last_location"))
      .build();

try {
  DeliveryVehicle updatedDeliveryVehicle =
      deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

HTTP REST を使用して Fleet Engine で車両の位置情報を更新するには、次の呼び出しを行います: UpdateDeliveryVehicle:

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=last_location`

<id> は配送車両の一意の識別子です。選択します。これは Chronicle SOAR が必要があります。

リクエストの本文には DeliveryVehicle エンティティを含める必要があります。

必須フィールド:

項目	値
lastLocation.supplementalLocation	車両の位置。
lastLocation.supplementalLocationTime	車両がこの場所にいたことが最後に判明したタイムスタンプ。
lastLocation.supplementalLocationSensor	CUSTOMER_SUPPLIED_LOCATION を入力する必要があります。

省略可能項目:

項目値

lastLocation.supplementalLocationAccuracy 指定した場所の精度（メートル単位）。

項目	値
lastLocation.supplementalLocationAccuracy	指定した場所の精度（メートル単位）。

curl コマンドの例:

# Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
# environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "lastLocation": {
    "supplementalLocation": {"latitude": 12.1, "longitude": 14.5},
    "supplementalLocationTime": "$(date -u --iso-8601=seconds)",
    "supplementalLocationSensor": "CUSTOMER_SUPPLIED_LOCATION",
    "supplementalLocationAccuracy": 15
  }
}
EOM

車両が停車地に到着する

車両が停車地に到着したときに Fleet Engine に通知する必要があります。通知機能 Fleet Engine は Driver SDK サーバー環境から gRPC や REST を使用して競合を避けるため、両方の方法を使用しない信頼できる唯一の情報源を維持する必要があります。

gRPC

次の例は、BigQuery の Java gRPC ライブラリ車両が停車地に到着したことを Fleet Engine に通知する場合:

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
    // Marking the arrival at stop.
    .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()
       .setStop(VehicleStop.newBuilder()
           .setPlannedLocation(LocationInfo.newBuilder()
               .setPoint(LatLng.newBuilder()
                   .setLatitude(37.7749)
                   .setLongitude(122.4194)))
           .addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
           .setState(VehicleStop.State.ARRIVED)))
    // All other remaining stops marked as NEW.
    .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // 2nd stop
       .setStop(VehicleStop.newBuilder()
           .setPlannedLocation(LocationInfo.newBuilder()
               .setPoint(LatLng.newBuilder()
                   .setLatitude(37.3382)
                   .setLongitude(121.8863)))
           .addTasks(TaskInfo.newBuilder().setTaskId(TASK2_ID))
           .setState(VehicleStop.State.NEW))) // Remaining stops must be NEW.
    .build();

// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
  UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
      .setName(vehicleName)
      .setDeliveryVehicle(deliveryVehicle)
      .setUpdateMask(FieldMask.newBuilder()
          .addPaths("remaining_vehicle_journey_segments"))
      .build();

try {
  DeliveryVehicle updatedDeliveryVehicle =
      deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境から停車地に到着した車両を Fleet Engine に通知するには、 UpdateDeliveryVehicle に対して HTTP REST 呼び出しを行います。

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=remainingVehicleJourneySegments`

<id> は、フリート内の配送車両の一意の識別子です。タスクの順序を更新する対象となるプロダクトです。これは Chronicle SOAR が必要があります。

リクエストの本文には DeliveryVehicle エンティティを含める必要があります。

必須フィールド:

項目	値
remainingVehicleJourneySegments	状態が State.ARRIVED に設定された到着した停車地。その後に、残りの車両停留所のリストと、その状態が State.NEW とマークされます。

省略可能フィールド:
- なし

エンティティに含まれる他のフィールドはすべて更新時に無視されます。

curl コマンドの例:

# Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
# environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "remainingVehicleJourneySegments": [
    {
      "stop": {
        "state": "ARRIVED",
        "plannedLocation": {
          "point": {
            "latitude": 37.7749,
            "longitude": -122.084061
          }
        },
        "tasks": [
          {
            "taskId": "${TASK1_ID}"
          }
        ]
      }
    },
    {
      "stop": {
        "state": "NEW",
        "plannedLocation": {
          "point": {
            "latitude": 37.3382,
            "longitude": 121.8863
          }
        },
        "tasks": [
          {
            "taskId": "${TASK2_ID}"
          }
        ]
      }
    }
  ]
}
EOM

車両が停車を完了

車両が停止を完了したときに Fleet Engine に通知する必要があります。これによってその停止に関連付けられているすべてのタスクが CLOSED 状態に設定される。Google Chat では Fleet Engine に Driver SDK サーバー環境から gRPC や REST を使用して競合状態を回避し、信頼できる唯一の情報源を維持するために、両方の方法を使用しないでください。

gRPC

次の例は、BigQuery の Java gRPC ライブラリ車両の停止が完了したことを Fleet Engine に通知します。

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Vehicle settings
String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
DeliveryVehicle deliveryVehicle = DeliveryVehicle.newBuilder()
    // This stop has been completed and is commented out to indicate it
    // should be removed from the list of vehicle journey segments.
    // .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()
    //    .setStop(VehicleStop.newBuilder()
    //        .setPlannedLocation(LocationInfo.newBuilder()
    //            .setPoint(LatLng.newBuilder()
    //                .setLatitude(37.7749)
    //                .setLongitude(122.4194)))
    //        .addTasks(TaskInfo.newBuilder().setTaskId(TASK1_ID))
    //        .setState(VehicleStop.State.ARRIVED)))
    // All other remaining stops marked as NEW.
    // The next stop could be marked as ENROUTE if the vehicle has begun
    // its journey to the next stop.
    .addRemainingVehicleJourneySegments(VehicleJourneySegment.newBuilder()  // Next stop
       .setStop(VehicleStop.newBuilder()
           .setPlannedLocation(LocationInfo.newBuilder()
               .setPoint(LatLng.newBuilder()
                   .setLatitude(37.3382)
                   .setLongitude(121.8863)))
           .addTasks(TaskInfo.newBuilder().setTaskId(TASK2_ID))
           .setState(VehicleStop.State.NEW)))
    .build();

// DeliveryVehicle request
UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
  UpdateDeliveryVehicleRequest.newBuilder()  // no need for the header
      .setName(vehicleName)
      .setDeliveryVehicle(deliveryVehicle)
      .setUpdateMask(FieldMask.newBuilder()
          .addPaths("remaining_vehicle_journey_segments"))
      .build();

try {
  DeliveryVehicle updatedDeliveryVehicle =
      deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境からの停止の完了を Fleet Engine に通知するには、 UpdateDeliveryVehicle に対して HTTP REST 呼び出しを行います。

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=remaining_vehicle_journey_segments`

<id> は、フリート内の配送車両の一意の識別子です。タスクの順序を更新する対象となるプロダクトです。これは Chronicle SOAR が必要があります。

リクエストの本文には DeliveryVehicle エンティティを含める必要があります。

必須フィールド:

項目値

remaining_vehicle_journey_segments 完了した経由地はリストには表示されなくなります。残りの車両停留所があります。
省略可能フィールド:
- なし

項目	値
remaining_vehicle_journey_segments	完了した経由地はリストには表示されなくなります。残りの車両停留所があります。

エンティティに含まれる他のフィールドはすべて更新時に無視されます。

curl コマンドの例:

    # Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
    # environment
    curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
      -H "Content-type: application/json" \
      -H "Authorization: Bearer ${JWT}" \
      --data-binary @- << EOM
    {
      "remainingVehicleJourneySegments": [
        {
          "stop": {
            "state": "NEW",
            "plannedLocation": {
              "point": {
                "latitude": 37.3382,
                "longitude": 121.8863
              }
            },
            "tasks": [
              {
                "taskId": "${TASK2_ID}"
              }
            ]
          }
        }
      ]
    }
    EOM

タスクを更新する

ほとんどのタスクフィールドは変更できません。ただし、状態は変更でき、タスクの結果、タスクの結果の時間、タスクの結果の場所、属性を直接更新しています。たとえば、タスクにまだ割り当てられていないタスクを閉じるには、直接渡されます。

gRPC

これは、gRPC を使用してタスクを更新する例です。

REST

これは、REST でタスクを更新する例です。

タスクを閉じる

車両に割り当てられているタスクを閉じるには、Fleet Engine タスクが行われる場所の停車地を完了したことを示すまたは停車地のリストから削除することもできます。それには、ルールのリストをタスクの順序を更新するときと同様に、残りの車両は停止します。です。

まだ車両が割り当てられていないタスクを終了する必要がある場合は、タスクを更新します。閉じることができます。ただし、CLOSED タスクは再度開くことはできません。

タスクの終了は、成功または失敗を意味するものではありません。これは、タスクは進行中とは見なされなくなります。配送状況を追跡するには、タスクの実際の結果を示すことが重要であり、示します。

gRPC

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Task settings
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
Task task = Task.newBuilder()
  .setName(taskName)
  .setState(Task.State.CLOSED) // You can only directly CLOSE a
  .build();                    // task that is NOT assigned to a vehicle.

// Task request
UpdateTaskRequest updateTaskRequest =
  UpdateTaskRequest.newBuilder()  // No need for the header
      .setTask(task)
      .setUpdateMask(FieldMask.newBuilder().addPaths("state"))
      .build();

try {
  Task updatedTask = deliveryService.updateTask(updateTaskRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境からタスクをクローズ済みとしてマークするには、HTTP REST 呼び出しを UpdateTask:

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=state`

<id> は、タスクの一意の識別子です。

リクエストヘッダーには、次の値を含む Authorization フィールドを含める必要があります。 Bearer <token>: ここで、<token> は Fleet Engine トークンファクトリによって発行されたトークンです。

リクエスト本文に Task エンティティを含める必要があります。

必須フィールド:

項目値

state State.CLOSED

項目	値
state	State.CLOSED

省略可能項目:

項目	値
taskOutcome	Outcome.SUCCEEDED または Outcome.FAILED
taskOutcomeTime	タスクが完了した時刻。
taskOutcomeLocation	タスクが完了したロケーション。Fleet Engine はデフォルトで最後の車両位置情報に保持されます。

エンティティに含まれる他のフィールドはすべて更新時に無視されます。

curl コマンドの例:

    # Set JWT, PROJECT_ID, and TASK_ID in the local environment
    curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=state,taskOutcome,taskOutcomeTime" \
      -H "Content-type: application/json" \
      -H "Authorization: Bearer ${JWT}" \
      --data-binary @- << EOM
    {
      "state": "CLOSED",
      "taskOutcome": "SUCCEEDED",
      "taskOutcomeTime": "$(date -u --iso-8601=seconds)"
    }
    EOM

タスクの結果と結果のロケーションを設定する

タスクの終了は、成功または失敗を示すものではなく、タスクは進行中とは見なされなくなります。配送状況を追跡するには、タスクの実際の結果を示すことがサービスに対する適切な請求が行われている。一度設定したタスクの結果は変更できません。ただし、タスクの結果時刻とタスクの結果の場所が、設定された後のタスクの結果の場所によって生成されます。

「終了」状態のタスクでは、結果を次のいずれかに設定できます。 SUCCEEDED または FAILED です。Fleet Engine は、ステータスが成功。

タスクの結果をマークすると、Fleet Engine は最後に認識された車両の位置情報を使用して、タスクの結果の場所を指定します。Google Chat ではオーバーライドできます

gRPC

タスクの結果のロケーションは、できます。ロケーションを設定すると、Fleet Engine はロケーションを設定できません最後の車の位置情報。Fleet Engine のタスク結果のロケーションを上書きすることもできます。後で変更できますFleet Engine がタスクの結果の場所を上書きすることはありません指定することもできます。タスクにタスク結果のロケーションを設定することはできませんタスクの結果セットがありません両方のタスクの結果を設定できます。 1 つのリクエスト内で

次の例は、BigQuery の Java gRPC ライブラリタスクの結果を [SUCCEEDED] に設定し、タスクの完了:

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8241890";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Task settings
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
Task task = Task.newBuilder()
  .setName(taskName)
  .setTaskOutcome(TaskOutcome.SUCCEEDED)
  .setTaskOutcomeTime(now())
  .setTaskOutcomeLocation(               // Grand Indonesia East Mall
    LocationInfo.newBuilder().setPoint(
      LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
  .build();

// Task request
UpdateTaskRequest updateTaskRequest =
  UpdateTaskRequest.newBuilder()  // No need for the header
      .setTask(task)
      .setUpdateMask(FieldMask.newBuilder().addPaths("task_outcome", "task_outcome_time", "task_outcome_location"))
      .build();

try {
  Task updatedTask = deliveryService.updateTask(updateTaskRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境からタスクを完了としてマークするには、 UpdateTask に対して HTTP REST 呼び出しを行います。

`PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=taskOutcome,taskOutcomeTime,taskOutcomeLocation`

<id> は、タスクの一意の識別子です。

リクエストの本文には Task エンティティを含める必要があります。

必須フィールド:

項目値

taskOutcome Outcome.SUCCEEDED または Outcome.FAILED

省略可能項目:

項目	値
taskOutcomeLocation	タスクが完了したロケーション。設定しない場合、Fleet Engine デフォルトは最後の車両の位置情報です。
taskOutcomeTime	タスク完了時のタイムスタンプ。

エンティティに含まれる他のフィールドはすべて更新時に無視されます。

curl コマンドの例:

# Set JWT, PROJECT_ID, and TASK_ID in the local environment
curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=taskOutcome,taskOutcomeTime,taskOutcomeLocation" \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer ${JWT}" \
  --data-binary @- << EOM
{
  "taskOutcome": "SUCCEEDED",
  "taskOutcomeTime": "$(date -u --iso-8601=seconds)",
  "taskOutcomeLocation": {
    "point": {
      "latitude": -6.195139,
      "longitude": 106.820826
    }
  }
}
EOM

配送先を変更する

発送タスクを作成した後で、予定する場所を変更することはできません。配送先を変更するには、設定せずに配送タスクを閉じます新しいタスクを作成できます。新しいタスクを作成したら、そのタスクを同じ車両に割り当てます。詳細情報詳しくは、配送タスクを閉じるをご覧ください。タスクを割り当てます。

フィーダーと配達用の車両を使用する

荷物を配達車両に運ぶためにフィーダーカーを使用する場合スケジュール設定された停止タスクとして出荷の転送をモデル化し、提供します正確な位置追跡ができるように、移管された荷物がネットワークに読み込まれた後、その荷物の配達タスク提供します詳しくは、臨時停留所をご覧ください。

ストアの配送ステータスとその他のメタ情報

出荷タスクが完了すると、タスクの状態と結果が記録されるタスクに追加します。ただし、他のメタ情報の更新が必要になる場合もあります。配送に固有の情報です組織内に保存可能な他のメタ情報を保存するには、 Fleet Engine サービス外の参照については、関連付けられた外部テーブルのキーとしてタスクが設定されます。

詳細については、タスクのライフサイクルをご覧ください。

車両を検索する

車両は、 Driver SDK サーバー環境から gRPC や REST を使用して

gRPC

次の例は、BigQuery の Java gRPC ライブラリ車両を検索するには:

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String VEHICLE_ID = "vehicle-8241890";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Vehicle request
String name = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
GetDeliveryVehicleRequest getVehicleRequest = GetDeliveryVehicleRequest.newBuilder()  // No need for the header
    .setName(name)
    .build();

try {
  DeliveryVehicle vehicle = deliveryService.getDeliveryVehicle(getVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;
     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境から車両を検索するには、 GetVehicle に対して HTTP REST 呼び出しを行います。

`GET https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<vehicleId>`

<id> は、タスクの一意の識別子です。

<vehicleId> は、検索する車両の ID です。

リクエストの本文は空にする必要があります。

ルックアップが成功した場合、レスポンスの本文には車両エンティティが含まれます。

curl コマンドの例:

# Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
  "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}"

タスクを検索する

gRPC または REST を使用して、サーバー環境からタスクを検索できます。Driver SDK は、タスクの検索もサポートします。

gRPC

次の例は、BigQuery の Java gRPC ライブラリタスクを検索するには:

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TASK_ID = "task-8597549";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Task request
String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
GetTaskRequest getTaskRequest = GetTaskRequest.newBuilder()  // No need for the header
    .setName(taskName)
    .build();

try {
  Task task = deliveryService.getTask(getTaskRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;

     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

サーバー環境からタスクを検索するには、 GetTask に対して HTTP REST 呼び出しを行います。

`GET https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<taskId>`

<id> は、タスクの一意の識別子です。

<taskId> は、検索するタスクの ID です。

リクエストの本文は空にする必要があります。

ルックアップが成功した場合、レスポンスの本文にはタスクエンティティが含まれます。

curl コマンドの例:

    # Set JWT, PROJECT_ID, and TASK_ID in the local environment
    curl -H "Authorization: Bearer ${JWT}" \
      "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}"

トラッキング ID で配送タスクの情報を検索する

配送タスクの情報は次の方法で検索できます。それぞれに異なる目的があります。

タスク ID: タスク ID を持つフリートオペレーターなどのユーザーが使用タスクデータのすべてを確認できます。
トラッキング ID を使用: クライアントソフトウェアで、制限付きの荷物が自宅に到着するタイミングなど、エンドユーザーにその情報を伝えることができます。

このセクションでは、トラッキング ID を使用してタスク情報を検索する方法について説明します。目標タスク ID でタスクを検索するには、タスクを検索するをご覧ください。

トラッキング ID で情報を検索するには、次のいずれかを使用できます。

gRPC を使用した Java によるルックアップ
HTTP を使用したルックアップ

検索の要件

トラッキング ID から提供された配送情報が公開設定のルールに準拠している記載追跡中の場所の公開設定を管理します。
Fleet Engine を使用して、荷物追跡 ID で配送情報を検索します。ドライバー SDK はトラッキング ID による情報検索をサポートしていません。フリートでこれを行うサーバー環境またはブラウザ環境を使用します。
可能な限り範囲の狭いトークンを使用して、セキュリティリスクを制限します。たとえば、使用すると、すべての Fleet Engine Deliveries API 呼び出しがそのエンドユーザーに関連する情報のみを表示します。荷物を受け取れます。レスポンス内のその他の情報はすべて削除されます。トークンの詳細については、このモジュールの認可用の JSON Web Token（JWT）を作成する。

gRPC を使用した Java によるルックアップ

次の例は、BigQuery の Java gRPC ライブラリトラッキング ID で配送タスクに関する情報を検索できます。

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TRACKING_ID = "TID-7449w087464x5";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Tasks request
String parent = "providers/" + PROJECT_ID;
GetTaskTrackingInfoRequest getTaskTrackingInfoRequest = GetTaskTrackingInfoRequest.newBuilder()  // No need for the header
    .setParent(parent)
    .setTrackingId(TRACKING_ID)
    .build();

try {
  TaskTrackingInfo taskTrackingInfo = deliveryService.getTaskTrackingInfo(getTaskTrackingInfoRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;

     case PERMISSION_DENIED:
       break;
  }
  return;
}

HTTP を使用したルックアップ

ブラウザから出荷タスクを検索するには、 GetTaskTrackingInfo:

`GET https://fleetengine.googleapis.com/v1/providers/<project_id>/taskTrackingInfo/<tracking_id>`

<tracking_id> は、タスクに関連付けられたトラッキング ID です。

リクエストヘッダーには、次の値を含む Authorization フィールドが含まれている必要があります。 Bearer <token>（<token> は Fleet Engine トークンファクトリによって発行されたトークン。

ルックアップが成功した場合、レスポンスの本文には taskTrackingInfo エンティティです。

curl コマンドの例:

# Set JWT, PROJECT_ID, and TRACKING_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
  "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/taskTrackingInfo/${TRACKING_ID}"

タスクの一覧表示

サーバーまたはブラウザ環境からのタスクを一覧表示できます。Driver SDK は、タスクの一覧表示をサポートしています。

タスクを一覧表示するには、タスクへの幅広いアクセス権をリクエストします。タスクの一覧表示は、できます。デリバリーフリートリーダーまたはデリバリースーパーユーザー認証を使用するタスクの一覧表示リクエストを行う際のトークン。

一覧表示されたタスクの次のフィールドが削除されます。

VehicleStop.planned_location
VehicleStop.state
VehicleStop.TaskInfo.taskId

リストされたタスクは、ほとんどのタスクプロパティでフィルタできます。フィルタクエリの構文については AIP-160 をご覧ください。次のリストは、有効なタスクを示しています。次のプロパティをフィルタリングに使用できます。

属性
delivery_vehicle_id
state
planned_location
task_duration
task_outcome
task_outcome_location
task_outcome_location_source
task_outcome_time
tracking_id
type

Google API 改善案に基づいて、次のフィールド形式を使用します。

フィールドタイプ	形式	例
タイムスタンプ	RFC-3339	`task_outcome_time = 2022-03-01T11:30:00-08:00`
所要時間	後に `s` が続く秒数	`task_duration = 120s`
列挙型	文字列	`state = CLOSED AND type = PICKUP`
場所	`point.latitude`、`point.longitude`	`planned_location.point.latitude > 36.1 AND planned_location.point.longitude < -122.0`

フィルタクエリの完全なリストについては、AIP-160 をご覧ください。あります。

フィルタクエリが指定されていない場合は、すべてのタスクが一覧表示されます。

タスクリストはページ分けされています。ページサイズは、タスクの一覧表示リクエストで指定できます。ページサイズが指定されている場合、返されるタスクの数は次の値以下になりますサイズを超えることはありません。ページサイズが存在しない場合は、妥当なデフォルト使用されます。リクエストされたページサイズが内部最大値を超えている場合、内部の最大値が使用されます

タスクリストには、結果の次のページを読み取るためのトークンを含めることができます。前のリクエストとまったく同じリクエストでページトークンを使用する次のページのタスクを取得します。返されたページトークンがが空の場合、取得できるタスクはこれ以上ありません。

gRPC

次の例は、BigQuery の Java gRPC ライブラリ deliveryVehicleId と task 属性のタスクのリストです。成功したレスポンスは空にすることもできます。空のレスポンスは、存在しないタスクが指定された deliveryVehicleId を関連付けます。

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TRACKING_ID = "TID-7449w087464x5";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Tasks request
String parent = "providers/" + PROJECT_ID;
ListTasksRequest listTasksRequest = ListTasksRequest.newBuilder()  // No need for the header
    .setParent(parent)
    .setFilter("delivery_vehicle_id = 123 AND attributes.foo = true")
    .build();

try {
  ListTasksResponse listTasksResponse = deliveryService.listTasks(listTasksRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;

     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

ブラウザからタスクを一覧表示するには、ListTasks に対する HTTP REST 呼び出しを行います。

`GET https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks`

リストされたタスクにフィルタを適用するには、「フィルタ」を含めます。値として URL エスケープされたフィルタクエリを含む URL パラメータ。

ルックアップが成功すると、レスポンスの本文には次の構造のデータが含まれます。

    // JSON representation
    {
      "tasks": [
        {
          object (Task)
        }
      ],
      "nextPageToken": string,
      "totalSize": integer
    }

成功を示すレスポンスは空でもかまいません。空のレスポンスは、指定したフィルタ条件を満たすタスクが見つかりました。

curl コマンドの例:

    # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
    curl -H "Authorization: Bearer ${JWT}" \
      "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?filter=state%20%3D%20OPEN%20AND%20delivery_vehicle_id%20%3D%20${VEHICLE_ID}"

配達車両を一覧表示する

サーバーまたはブラウザ環境から配送車両を一覧表示できます。ドライバー SDK は配信車両のリストをサポートしていません。

配達車両のリストを取得すると、配達車両への幅広いアクセスがリクエストされ、信頼できるユーザーのみを対象とするものです。Delivery Fleet Reader または Delivery Super を使用するリスト配信車両リクエストを行う際のユーザー認証トークン。

掲載されている配達車両は、影響があるため、次のフィールドが削除されていますレスポンスサイズ:

CurrentRouteSegment
RemainingVehicleJourneySegments

配達車両のリストは、attributes プロパティでフィルタできます。対象たとえば、キーが my_key で値が my_value の属性をクエリするには、次のコマンドを使用します。 attributes.my_key = my_value。複数の属性をクエリするには、クエリを結合します attributes.key1 = value1 AND attributes.key2 = value2 のように論理 AND 演算子と OR 論理演算子を使用しています。詳細については、AIP-160 をご覧ください。フィルタクエリ構文の説明です。

viewport リクエストを使用すると、リストされている配達車両をロケーションでフィルタできます。パラメータを指定します。viewport リクエストパラメータは 2 つの境界を使用してビューポートを定義する座標: high（北東）と low（南西）の緯度と経度あります。リクエストに高い緯度が含まれている場合、リクエストは拒否されます地理的に低い位置に送られます

デフォルトでは、車両リストは適切なページサイズでページ分けされます。条件ページサイズを指定すると、車両の数のみが返されます。最大数です。リクエストされたページサイズが内部サイズ内部最大値が使用されます。デフォルトページと最大ページいずれも 100 台です

配達車両リストには、配達車両の次のページを読み取るためのトークンを含めることができます。表示されます。ページトークンは、配信ページが増える場合にのみレスポンスに含まれます。車両を回収することができます。タスクの次のページを取得するには、次のコマンドを使用します。リクエストを含むページトークンが、それ以外はリクエストできます。

gRPC

次の例は、BigQuery の Java gRPC ライブラリ特定の地域の配送車両を、特定の属性で一覧表示できます。空の場合もあります。その場合、ユーザーは指定された属性を持つ車両は、すでに指定されたビューポートにあります。

static final String PROJECT_ID = "my-delivery-co-gcp-project";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Tasks request
String parent = "providers/" + PROJECT_ID;
ListDeliveryVehiclesRequest listDeliveryVehiclesRequest =
  ListDeliveryVehiclesRequest.newBuilder()  // No need for the header
      .setParent(parent)
      .setViewport(
            Viewport.newBuilder()
              .setHigh(LatLng.newBuilder()
                  .setLatitude(37.45)
                  .setLongitude(-122.06)
                  .build())
              .setLow(LatLng.newBuilder()
                  .setLatitude(37.41)
                  .setLongitude(-122.11)
                  .build())
      .setFilter("attributes.my_key = my_value")
      .build();

try {
  ListDeliveryVehiclesResponse listDeliveryVehiclesResponse =
      deliveryService.listDeliveryVehicles(listDeliveryVehiclesRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
      case NOT_FOUND:
          break;

      case PERMISSION_DENIED:
          break;
  }
  return;
}

REST

ブラウザからタスクを一覧表示するには、ListDeliveryVehicles に対する HTTP REST 呼び出しを行います。

`GET https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles`

リストされたタスクにフィルタを適用するには、「フィルタ」を含めます。URL パラメータに値として URL エスケープされたフィルタクエリ。

ルックアップが成功すると、レスポンスの本文には次の構造のデータが含まれます。

// JSON representation
{
  "deliveryVehicles": [
    {
      object (DeliveryVehicle)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}

成功を示すレスポンスは空でもかまいません。その場合、ユーザーは指定されたフィルタクエリとビューポートに一致する配達車両が検出されました。

curl コマンドの例:

# Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
  "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles?filter=attributes.my_key%20%3D%20my_value%20&viewport.high.latitude=37.45&viewport.high.longitude=-122.06&viewport.low.latitude=37.41&viewport.low.longitude=-122.11"

荷物の追跡

使用する方法は 2 つあります。 Fleet Engine Deliveries API を使用して、配送の追跡を可能にします。

推奨: JavaScript 配送トラッキングライブラリ。ライブラリを使用すると、車両の位置と場所を可視化できます Fleet Engine で追跡されている料金です。JavaScript の Map コンポーネントが含まれる標準の google.maps.Map オブジェクトを簡単に置き換えることができます。 Fleet Engine に接続しますこのコンポーネントを使用すると、カスタマイズ可能なアニメーションで配送追跡エクスペリエンスを提供ウェブやモバイルアプリからデプロイできます
Fleet Engine Deliveries API を基盤に、独自の配送追跡を実装します。

鍵となるのは、トラッキング ID で配送タスクを検索することです。

デリバリーコンシューマロールを使用する場合、Fleet Engine Deliveries API 呼び出しは配送業者または受取人に関連する情報のみを返す。その他秘匿化されます。ユーザーのエンドユーザーの認証に使用できます。さらに位置情報は選択することもできます利用不能なタスクでは位置情報がエンドユーザーと共有されることはありません。

ロギング

RPC ログを Cloud Logging に送信するように Fleet Engine を設定できます。詳細情報詳しくは、 Logging。

認可ロールとトークン

車両とタスクのライフサイクルを管理するを参照個別のユースケースの承認に関するメモを記録することで Fleet Engine の呼び出しには、次を含む JSON ウェブトークンによる認証が必要です。サービスアカウントの認証情報を使用して署名されていることです。使用するサービスアカウントこれらのトークンを発行するには、1 つ以上のロールを付与できます。

詳細については、次をご覧ください: 認証と認可。

一般的な問題のトラブルシューティング

問題が発生した場合は、以下のセクションをご確認ください。

復元性

Fleet Engine は信頼できる情報源とはみなされません。ユーザーのインフラストラクチャに依存することなく、必要に応じてシステムの状態を復元できます。 Fleet Engine

Fleet Engine の消失状態

Fleet Engine を使用する場合は、システムが修復されるようにクライアントを実装するリソース自体に障害が発生した場合に再試行されますたとえば、Fleet Engine がソフトウェアの更新をエラーが返される場合があります。あります。その後、クライアントは車両を新しい状態で再作成する必要があります。ただし、この問題が発生することはめったにありません。システムの復元力ができます。

ごくまれなケースとして Fleet Engine に壊滅的な障害が発生した場合ほとんどまたはすべての乗り物やタスクを再作成する必要がある場合があります。作成率が高すぎると、割り当ての問題により一部のリクエストが再び失敗することがあります。これは、サービス拒否（DOS）攻撃を回避するために、割り当てのチェックを実施しています。この場合、次のバックオフ戦略を使用して再作成の頻度を遅くします。再試行します。

ドライバーアプリの紛失状態

ドライバアプリがクラッシュした場合、アプリは現在の状態を再生成する必要がある Driver SDK 内にありますアプリがタスクの再作成を試行して、現在の状態を復元する必要があります。また、 Driver SDK の停止リストを再作成して明示的に設定します。

よくある質問

ドライバが順不同でタスクを停止した場合はどうなりますか？

この場合は、まずタスクの順序を更新してから、通常どおり処理します。停車地の到着時刻、タスクの完了、その他の詳細をマークできます。そうしないと、システムに一貫性がなかったり、到着予定時刻が不正確になったりする可能性があります。予期しないエラーが報告される可能性があります。

配送追跡のための Fleet Engine のスタートガイド

初期設定

設定を確認する

クライアント ライブラリ

データ構造

配達車両

タスク

配送タスク

利用できないタスク

スケジュール設定された停止タスク

タスク ID のガイドライン

その他のリソース

自動車の寿命

車種

車両属性

タスクのライフサイクル

タスクのガイドライン

タスクの属性

車両とタスクのライフサイクルの管理

クライアント トークンを管理する

他のサービス アカウントのロール

勤務日のモデルを作成する

位置情報の更新の仕組み

車両の停車地と配達場所

モバイル SDK を使用する

Delivery Driver API を初期化する

ユースケース

エンティティの固有識別子

車両を作成する

gRPC

REST

配送集荷タスクを作成する

gRPC

REST

配送タスクを作成する

gRPC

REST

タスクのバッチ作成

gRPC

REST

スケジュール設定された利用停止

gRPC

REST

スケジュール設定された停車地

gRPC

REST

ターゲット時間枠の設定

gRPC

REST

タスク トラッキングの公開設定を設定する

gRPC

REST

車両にタスクを割り当てる

タスクの順序を更新

gRPC

REST

車両は次の駅に向かっています

gRPC

REST

車両の位置情報の更新

gRPC

REST

車両が停車地に到着する

gRPC

REST

車両が停車を完了

gRPC

REST

タスクを更新する

gRPC

REST

タスクを閉じる

gRPC

REST

タスクの結果と結果のロケーションを設定する

gRPC

REST

配送先を変更する

フィーダーと配達用の車両を使用する

ストアの配送ステータスとその他のメタ情報

クライアントライブラリ

クライアントトークンを管理する

他のサービスアカウントのロール

タスクトラッキングの公開設定を設定する

ドライバーアプリの紛失状態