このドキュメントでは、以下を使用してサーバー環境から車両を作成する方法について説明します。 いずれかを選択できます提供されている Driver SDK から車両を作成できます。 適切な API を使って、アプリを信頼できる環境としてプロビジョニングし、 認証情報が必要です。
Driver SDK を使用して車両を作成する方法については、以下をご覧ください。
- スケジュール設定されたタスク用の Driver SDK
- Fleet Engine の基本のサービス アカウント ロール
サーバー環境から新しい車両を作成するには、
Fleet Engine への CreateDeliveryVehicle
リクエスト。こちらの
CreateDeliveryVehicleRequest
オブジェクトを使用して、新しい
提供します
スケジュール設定されたタスクを行う車両のフィールド
DeliveryVehicle
を作成するときに、次のオプション フィールドを設定します。
attributes
last_location
type
オプション フィールドを設定せずに車両を作成するには、
CreateDeliveryVehicleRequest
で DeliveryVehicle
フィールドの設定が解除されました。
車両の例の作成
Java gRPC ライブラリを使用して車両または REST を作成できます。
Java
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>
POST 本文は、作成される DeliveryVehicle
エンティティを表します。Google Chat では
次のオプション フィールドを指定します。
attributes
lastLocation
type
# 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
フィールドを設定せずに車両を作成するには、POST の本文を残します。
リクエストが空です。次に、新しく作成された車両が車両 ID を
POST URL の deliveryVehicleId
パラメータ
例:
# 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}"