이 문서에서는 다음 사항에 대해 잘 알고 있다고 가정합니다.
실제 배송 시나리오에서 비즈니스는 배송 업무를 이 운전자는 차량을 사용하여 예정된 목적지까지 차량을 배달하고 건물 단지 내의 주거지나 배달실과 같은 위치. 나 작업을 생성하고 배송 차량을 실행하여 Fleet Engine에서 업데이트 요청: 그런 다음 차량 항목을 여행. 각 정류장에는 정류장에서 완료해야 할 작업 목록을 할당합니다.
차량 작업은 언제든지 업데이트할 수 있지만 일반적으로 다음과 같은 목적으로 사용됩니다.
- 차량이 완료할 작업을 예약합니다. 이 작업을 할 수도 있습니다. 차량에 새 정류장을 추가하는 업데이트 요청 또는 기존 정류장에 새 작업을 추가하는 요청입니다.
- 지정된 차량 정류장과 연결된 기존 작업의 순서를 업데이트합니다.
- 작업 완료 위치를 변경합니다. 기본적으로 Fleet Engine은 작업 완료 위치를 차량 정류장과 동일한 위치로 표시 정보를 제공합니다 원하는 경우 특정 위치를 지정할 수 있습니다. 개별 태스크에 대한 액세스를 제어할 수 있습니다 예를 들어 대규모의 차량 정류장이 있을 수 있습니다. 여러 개의 패키지를 배송하기 복잡하며, 각 패키지에는 지정할 수 있습니다.
- 업데이트된 목록에서 제외하려면 이전에 할당된 할 일을 모두 닫습니다. 있습니다. 자세한 내용은 태스크 완료하기를 참고하세요.
전송 작업 예약 또는 변경
서버 중 하나에서 차량에 할당된 작업을 예약하거나 변경할 수 있습니다. 또는 Driver SDK를 사용하여(드라이버 SDK를 사용할 수도 있음) 신뢰할 수 있는 기기로 작업 관리 하나의 방법만 사용하여 경합 방지 단일 정보 소스를 유지할 수 있다는 장점이 있습니다
한 차량에서 다른 차량으로 배송을 변경하려면 원래 작업을 종료하세요. 다른 차량에 할당하기 전에 다시 만들어야 합니다. 이 다른 작업 부하에 이미 할당된 작업을 포함하는 오류가 발생합니다.
태스크 업데이트를 위한 필수 필드
이 섹션에서는 작업을 업데이트할 때 설정해야 하는 필수 입력란을 설명합니다. 있습니다. 선택적인 필드가 제공되지 않았습니다. Fleet 엔진이 다른 모든 필드를 무시함 업데이트합니다.
필수 입력란 | 값 |
---|---|
remainingVehicleJourneySegments |
작업이 실행되어야 하는 순서대로 나열된 작업의 여정 세그먼트 목록입니다. 목록의 첫 번째 작업이 먼저 실행됩니다. |
remainingVehicleJourneySegments[i].stop |
목록에서 작업 i의 중지 |
remainingVehicleJourneySegments[i].stop.plannedLocation |
정류장에 대해 계획된 위치입니다. |
remainingVehicleJourneySegments[i].stop.tasks |
이 차량 정류장에서 실행할 작업 목록입니다. |
remainingVehicleJourneySegments[i].stop.state |
State.NEW |
할 일 할당 예시
다음 예에서는 자바 gRPC 라이브러리와 HTTP를 사용하는 방법을 보여줍니다.
차량에 새 태스크 두 개를 추가하는 UpdateDeliveryVehicle
의 REST 호출입니다.
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
PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=remainingVehicleJourneySegments`
<id>는 차량 내 배송 차량의 고유 식별자입니다. 태스크 순서를 업데이트하려는 대상입니다. 이 식별자는 차량을 만들 때 지정한 값입니다.
요청 헤더에는 값이 있는 Authorization 필드가 있어야 합니다. Bearer <token> - 서버에서 <token>을 가져옴 서비스 계정 역할 및 JSON 웹 토큰.
요청 본문에는
DeliveryVehicle
항목이 포함되어야 합니다.
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