이 문서에서는 Fleet Engine 소개 섹션의 예약된 태스크 소개 가이드와 이 섹션의 예약된 태스크란 무엇인가?를 읽었다고 가정합니다.
예약된 태스크용 Fleet Engine은 다음과 같은 다양한 광범위한 태스크 카테고리를 제공합니다.
- 배송 태스크: 배송 픽업 및 배송을 비롯한 운전 태스크에 사용합니다.
- 사용 불가능 태스크: 운전자가 사용 불가능한 시간(예: 필수 휴식 시간)에 사용합니다.
- 예약된 정지 태스크: 건물에 들어가거나 배송 지점을 찾는 시간과 같이 드롭박스 또는 고객 위치에서 운전하지 않는 태스크에 사용합니다.
이 문서에서는 서버에서 배송 이외 태스크를 만드는 방법을 설명합니다. 배송 태스크 유형은 배송 태스크 만들기를 참고하세요.
운전하지 않는 태스크의 태스크 필드
이 섹션에서는 사용 불가능 태스크와 예약된 정지 태스크 모두에 필요한 태스크 필드를 설명합니다.
필수 태스크 필드
Fleet Engine에서 만드는 모든 태스크에 필수 필드를 제공해야 하며 선택적 필드를 제공할 수도 있습니다. Fleet Engine은 다른 모든 필드를 무시하고 태스크 생성 요청에서 할당된 deliveryVehicleId를 제공하는 경우 예외를 발생시킵니다. 차량에 태스크를 할당하려면 UpdateDeliveryVehicleRequest를 사용하세요. 자세한 내용은
태스크 업데이트를 참고하세요.
| 필드 | 값 |
|---|---|
type |
태스크 유형과 일치하는 유형으로 설정합니다. 다음 중 하나입니다.
|
state |
State.OPEN |
task_id |
고유한 태스크 ID입니다. 배송의 운송장 번호가 아니어야 합니다. 시스템에 태스크 ID가 없는 경우 범용 고유 식별자 (UUID)를 생성할 수 있습니다. 자세한 내용은 태스크 ID를 참고하세요. |
tracking_id |
PICKUP 또는 DELIVERY 태스크만 해당:
배송을 추적하는 데 사용하는 번호 또는 식별자입니다. 배송 이외 태스크에는 이 필드를 제공하지 마세요. |
planned_location |
PICKUP, DELIVERY, 또는
SCHEDULED_STOP 태스크만 해당: 태스크가 완료될 위치입니다.
태스크에는 필요하지 않습니다.UNAVAILABLE |
task_duration |
태스크를 완료하는 데 추가할 예상 시간입니다. 예를 들어 주차 공간을 찾거나 인계 지점까지 걸어가는 데 걸리는 시간입니다. |
선택적 배송 태스크 필드
| 필드 | 값 |
|---|---|
target_time_window |
태스크를 완료해야 하는 기간입니다. 이 필드 는 라우팅 동작에 영향을 미치지 않습니다. |
task_tracking_view_config |
PICKUP 또는 DELIVERY 태스크만 해당:
어떤 상황에서 최종 사용자에게 표시되는 데이터 요소를 지정하는 태스크 추적 구성입니다. |
attributes |
맞춤 태스크 속성의 목록입니다. 각 속성에는 고유한 키가 있어야 합니다. |
사용 불가능 태스크 만들기
운전자 휴식 시간과 같이 사용 불가능을 나타내는 태스크를 만들 수 있습니다. 사용 불가능 태스크를 만들려면 다음 가이드라인을 따르세요.
- 태스크 유형을
UNAVAILABLE로 설정합니다. - 추적 ID를 포함하지 마세요.
- 사용 불가능 태스크의 위치를 제공하지 않아도 되지만, 제공하면 하루 종일 향상된 도착 예정 시간 계산이 가능합니다.
이동 공유를 위해 UNAVAILABLE 태스크를 실행 중인 경우 차량 위치에 특별한 공개 상태 규칙이 적용됩니다.
- 배송 추적 라이브러리와 통합된 소비자 앱: 차량이 사용 불가능 태스크를 실행 중인 경우 소비자 앱 사용자는 배송 상태 정보는 계속 확인할 수 있지만 차량 위치는 확인할 수 없습니다.
- Fleet 추적 라이브러리와 통합된 Fleet 추적 앱: 차량이 사용 불가능 태스크를 실행 중인 경우 Fleet 추적 앱을 사용하는 Fleet 관리자는 사용 불가능 태스크의 차량 위치를 확인할 수 있습니다.
다음 예에서는
Java gRPC 라이브러리를 사용하여 예약된 사용 불가능 태스크를 만드는 방법 또는
CreateTask에 HTTP REST 요청을 실행하는 방법을 보여줍니다.
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
서버 환경에서 사용 불가능 태스크를 만들려면 CreateTask에 HTTP REST 호출을 실행하세요.
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id><id>는 태스크의 고유 식별자입니다.
요청 헤더에는 Authorization 필드와 Bearer <token> 값이 포함되어야 합니다. 여기서 <token>은 서비스 계정 역할 및 JSON 웹 토큰에 설명된 가이드라인에 따라 서버에서 발급합니다.
요청 본문에는 운전하지 않는 태스크의 태스크 필드에 설명된 적절한 필드가 있는 Task 항목이 포함되어야 합니다.
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예약된 정지 태스크 만들기
예약된 정지 태스크를 만들 수 있습니다. 예를 들어 고객 위치에서 운전하지 않는 태스크, 주유 정지 또는 운전자가 피더 차량에서 배송을 받는 경우에 사용할 수 있습니다. 예약된 정지 태스크를 만들 때는 다음 가이드라인을 따르세요.
- 태스크 유형을
- 추적 ID를 포함하지 마세요.
- 선택적으로 위치를 제공할 수 있습니다.
다음 예에서는
Java gRPC 라이브러리를 사용하여 예약된 사용 불가능 태스크를 만드는 방법 또는
CreateTask에 HTTP REST 요청을 실행하는 방법을 보여줍니다.
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
서버 환경에서 예약된 정지 태스크를 만들려면 CreateTask에 HTTP REST 호출을 실행하세요.
POST https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks?taskId=<id><id>는 태스크의 고유 식별자입니다.
요청 헤더에는 Authorization 필드와 Bearer <token> 값이 포함되어야 합니다. 여기서 <token>은 서비스 계정 역할 및 JSON 웹 토큰에 설명된 가이드라인에 따라 서버에서 발급합니다.
요청 본문에는 Task 항목이 포함되어야 합니다.
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