Fleet Engine での車両の仕組みに関する一般的な情報については、 Fleet Engine の基本セクションにある以下のガイドをご覧ください。
このセクションのドキュメントでは、Google Cloud で車両を作成および管理する方法について説明します。 Fleet EngineFleet 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 用認可ライブラリの使用を想定しています。
- REST の例は、HTTP リクエスト ヘッダーを示しています。これには、
値が
Bearer <token>のフィールドAuthorization。<token>は、 発行する JSON Web Token。
詳細については、Fleet Engine の設定ガイドをご覧ください。
車両リソース フィールド
車両リソースには次の種類のフィールドがあります。
- 出力専用フィールド。サービスによって次の出力として設定されるフィールド
直接設定できないことを意味します。この重要なフィールドは
nameフィールドです。Fleet Engine は、サービス認証情報に Google AIP からのガイダンスに基づく車両のnameフィールド（ユーザー指定） ID。これらのフィールドに値を指定すると、Fleet Engine は エラーが返されます。 - 必須フィールド。オンデマンドの配車サービスで作成された車両には、 作成時に特定のフィールドを設定できますスケジュール設定された車両 タスク サービスには必須の車両リソース フィールドがありません。
- オプション フィールド。どちらのサービスにも、作成時に設定できるフィールドがあります できます。これらについては、それぞれのリファレンス ガイドで 使用した分だけのお支払いになります。
車両名（出力のみ）
name フィールドは、オンデマンド賃走と運行スケジュール タスクでまったく同じです。
提供します。Fleet Engine では、車両の作成時に
車両の作成時に設定する 2 つのフィールド:
親: プロジェクトの Google Cloud プロジェクト ID に関連付けられた文字列
providers/{provider}の形式（{provider}は Cloud Storage の ID） できます。プロジェクト用に作成する各車両には、 あります。ここで参照する Cloud プロジェクトには、Fleet Engine も含まれている必要があります。 サービス アカウントのロールも付与します。詳細については、サービス アカウントをご覧ください。 それらのサービス アカウントのリストを作成します。Fleet Engine は、 複数の Google Cloud プロジェクトを作成できます
車両の ID。車両のすべての車両で一意である必要があります。 有効な Unicode 文字列にする必要があります。これは、リソースのリソース ID です。 あります。オンデマンドルートとスケジュールされた停留所の両方で、この情報を使用して 完了する車両のタスクなどです
Google Cloud ベースのサービスでは、すべての API でリソースを文字列として表す必要があります。 詳細については、Fleet Engine でのリソースの命名をご覧ください。
エンティティの固有識別子
リソース呼び出しで使用される一意のエンティティ ID の形式と値は次のとおりです。 Fleet Engine には不透明です。ID にタグ名が一切含まれていないことを ドライバーの電話番号などの個人情報（PII）が 含まれることがあります
車両の再利用
車両が特定の旅程のすべての停車地を完了したら、その後も利用可能なままとなる Fleet Engine で 7 日間再利用できます 翌営業日以降に新たにアカウントを作成する必要もありません。ユーザーが 車両を再利用すると、Fleet Engine はその可用性をリセットします。その時点で 7 日間のカウントダウンが新たに開始されます。
Fleet Engine で車両を利用できるようにするには、以下のようにすることをおすすめします。
定期的に位置情報を更新しています。
Vehicle エンティティの存続期間は、新しいフィールド値が
作成できます
注: Vehicle エンティティの一部のフィールド（device_settings など）は純粋にデバッグ用のフィールドです。
Fleet Engine によって保持されない情報です。更新しても、
Vehicle エンティティの有効期間を延長する。
システム分析を改善するには、同じ運転車 ID を再利用することをおすすめします。 日々進化させていますこれを行うには、関連付けられた車両 ID と、 過去に予定された停車地またはオンデマンドルートの運転手。