Fleet Engine での車両の仕組みの一般的な情報については、Fleet Engine の基本セクションの次のガイドをご覧ください。
このセクションのドキュメントでは、Fleet Engine で車両を作成して管理する方法について説明します。Fleet Engine サーバー環境で車両を作成して、実際の運用における実際の車両を反映させます。また、Fleet Engine の車両は、車両の割り当てとルート設定に使用するバックエンド システムで使用される車両に対応している必要があります。
車両リソースを作成するには、gRPC または REST を使用して create メソッドを使用します。 このガイドのフィールド名は、わかりやすくするために gRPC 表記を使用しています。
オンデマンド配車
CreateVehicleRequest（gRPC）providers.vehicle.create（REST）Vehicleリソース（REST、gRPC）
スケジュール設定されたタスク
CreateDeliveryVehicleRequest（gRPC）providers.deliveryVehicles.create（REST）DeliveryVehicle（REST、gRPC）
車両リクエスト
オンデマンド配車とスケジュール設定されたタスクの両方の機能で、フィールドを含むリクエスト メッセージを発行して車両を作成、更新します。概要は次のとおりです。
- 親: Google Cloud プロジェクト ID に関連付けられた文字列。車両インスタンスの名前フィールドに入力するために使用されます。
車両の ID: 車両の
nameフィールドに入力するために使用される一意の文字列。必要なフィールドを含む車両インスタンス 。これらのフィールドは、使用する Fleet Engine の機能によって異なります。
リクエスト本文の情報は、リクエストの性質によって異なります。詳細については、それぞれのガイドをご覧ください。
認証トークンと認可トークン
Fleet Engine へのリクエストでは、正しいアクセス認証情報も提供する必要があります。 このガイドの例では、次の前提条件があります。
- gRPC の例では、Java 用の Authorization library を使用することを前提としています。
- REST の例では、HTTP リクエスト ヘッダーを示しています。このヘッダーには、
フィールド
AuthorizationとBearer <token>の値が含まれている必要があります。ここで、<token>は 発行する JSON ウェブトークンです。
詳細については、Fleet Engine の設定ガイドをご覧ください。
車両リソース フィールド
車両リソースには次の種類のフィールドがあります。
- 出力専用フィールド 。別のメソッドの出力としてサービスによって設定され、直接設定できない フィールド。このタイプの重要なフィールドは
nameフィールドです。Google AIP の ユーザー指定 ID に関するガイダンスに従って、Fleet Engine は車両のnameフィールドに指定された値を無視します。これらのフィールドに値を指定すると、Fleet Engine はエラーを返します。 - 必須フィールド 。オンデマンド配車サービスで作成された車両では、作成時に特定のフィールドを設定する必要があります。スケジュール設定されたタスク サービスで作成された車両には、必須の車両リソース フィールドはありません。
- 省略可能フィールド 。どちらのサービスにも、作成時または作成後に設定できるフィールドがあります。これらは、使用するサービスのそれぞれのリファレンス ガイドに記載されています。
車両名（出力専用）
name フィールドは、オンデマンド配車サービスとスケジュール設定されたタスク サービスでまったく同じです。Fleet Engine は、車両の作成時に設定した 2 つのフィールドに基づいて、車両の作成時にフィールドを定義します。
親: Google Cloud プロジェクト ID に関連付けられた文字列。形式は
providers/{provider}です。ここで、{provider}は Cloud プロジェクトの ID です。特定のプロジェクト用に作成する各車両には、同じ親パスが設定されます。ここで参照する Cloud プロジェクトには、使用するサービスの Fleet Engine サービス アカウントのロールも含まれている必要があります。サービス アカウントの一覧については、サービス アカウントをご覧ください。Fleet Engine は、複数の Google Cloud プロジェクトからのアクセスをサポートしていません。
車両の ID。フリート内のすべての車両で一意であり、有効な Unicode 文字列である必要があります。これは車両の リソース ID です。オンデマンド配車とスケジュール設定された停車地の両方で、これを使用して配車またはタスクを完了する車両に関連付けます。
Google Cloud ベースのサービスでは、すべての API でリソースを文字列として表す必要があります。 詳細については、Fleet Engine のリソース命名をご覧ください。
一意のエンティティ ID
リソース呼び出しで使用される一意のエンティティ ID の形式と値は、Fleet Engine には公開されません。ID に、ドライバーの電話番号など、個人を特定できる情報（PII）が含まれていないことを確認してください。
車両の再利用
車両が特定の旅程のすべての停車地を完了すると、Fleet Engine で 7 日間再利用できます。つまり、新しい車両を作成しなくても、後続の営業日に車両を再利用できます。車両を再利用するたびに、Fleet Engine はその可用性をリセットし、7 日間のカウントダウンが新たに開始されます。
Fleet Engine で車両を使用可能にするには、定期的に車両の位置情報を更新することをおすすめします。Vehicle エンティティの他のほとんどのフィールドを更新すると、新しいフィールドの値が既存の値と異なる場合に、その有効期間も延長されます。
注: device_settings などの Vehicle エンティティの一部のフィールドは、Fleet Engine によって保持されないデバッグ情報です。これらを更新しても、Vehicle エンティティの有効期間は延長されません。
システムの分析を改善するには、ドライバーと車両の ID のペアを毎日再利用することをおすすめします。これを行うには、以前のスケジュール設定された停車地またはオンデマンド配車でドライバーに関連付けられた同じ車両 ID を使用します。