Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ค้นหางาน

เอกสารนี้อธิบายวิธีค้นหาข้อมูลงานจากเซิร์ฟเวอร์หรือเบราว์เซอร์ Fleet Engine รองรับการค้นหางาน 2 วิธีดังนี้

ค้นหางาน: คุณสามารถค้นหางานได้โดยใช้รหัสต่อไปนี้
- รหัสงาน: ใช้โดยผู้ใช้ เช่น ผู้ให้บริการกลุ่มยานพาหนะที่มีสิทธิ์เข้าถึงมุมมองข้อมูลงานแบบเต็ม
- รหัสติดตาม: ใช้โดยซอฟต์แวร์ไคลเอ็นต์ของคุณเพื่อระบุข้อมูลที่จำกัดให้แก่ผู้ใช้ปลายทาง เช่น เวลาที่คาดว่าพัสดุจะไปถึงบ้าน
โปรดทำความเข้าใจความแตกต่างระหว่างรหัสงานกับรหัสติดตามงาน สองรายการนี้ไม่เหมือนกัน ดูช่องงานพื้นฐานในคู่มืองานที่กำหนดเวลาไว้
แสดงรายการงาน: การเข้าถึงงานแบบกว้าง ซึ่งมีไว้สำหรับผู้ใช้ที่เชื่อถือได้เท่านั้น

ค้นหางาน

ส่วนนี้จะอธิบายวิธีค้นหางานตามรหัสงานหรือรหัสติดตาม โดยมีข้อกำหนดดังนี้

การค้นหาด้วยรหัสติดตามต้องเป็นไปตามกฎระดับการเข้าถึงที่ระบุไว้ในกฎระดับการเข้าถึงสำหรับออบเจ็กต์ที่ติดตาม
ใช้โทเค็นที่แคบที่สุดเท่าที่จะเป็นไปได้เพื่อจำกัดความเสี่ยงด้านความปลอดภัย ตัวอย่างเช่น หากคุณใช้โทเค็นผู้บริโภคสำหรับการนำส่ง การเรียกใช้ทั้งหมดจะแสดงเฉพาะข้อมูลที่เกี่ยวข้องกับผู้ใช้ปลายทางรายนั้น เช่น ผู้จัดส่งหรือผู้รับการจัดส่ง Fleet Engine จะปกปิดข้อมูลอื่นๆ ทั้งหมดในการตอบกลับ ดูข้อมูลเพิ่มเติมเกี่ยวกับโทเค็นได้ที่เว็บโทเค็น JSON

ค้นหางานตามรหัสงาน

คุณสามารถค้นหางานตามรหัสงานจากสภาพแวดล้อมของเซิร์ฟเวอร์โดยใช้ gRPC หรือ REST ตัวอย่างต่อไปนี้แสดงวิธีใช้ไลบรารี gRPC ของ Java หรือคำขอ REST เพื่อ GetTask

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TASK_ID = "task-8597549";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Task request
 String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
 GetTaskRequest getTaskRequest = GetTaskRequest.newBuilder()  // No need for the header
     .setName(taskName)
     .build();

 try {
   Task task = deliveryService.getTask(getTaskRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;

      case PERMISSION_DENIED:
        break;
   }
   return;
 }

REST

GET https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<taskId>

<id> คือตัวระบุที่ไม่ซ้ำกันสำหรับงาน
<taskId> คือรหัสของงานที่จะค้นหา
ส่วนหัวของคำขอต้องมีช่อง Authorization ที่มีค่า Bearer <token> โดยที่ <token> ออกโดยเซิร์ฟเวอร์ของคุณตามหลักเกณฑ์ที่อธิบายไว้ในบทบาทของบัญชีบริการและโทเค็นเว็บ JSON
เนื้อหาของคำขอต้องว่างเปล่า
หากการค้นหาสำเร็จ เนื้อหาการตอบกลับจะมีเอนทิตีงาน

ตัวอย่างคำสั่ง curl:

    # Set JWT, PROJECT_ID, and TASK_ID in the local environment
    curl -H "Authorization: Bearer ${JWT}" \
      "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}"

ค้นหางานตามรหัสติดตาม

ตัวอย่างต่อไปนี้แสดงวิธีค้นหางานตามรหัสติดตามการจัดส่งโดยใช้ gRPC หรือการเรียก HTTP REST ไปยัง GetTaskTrackingInfo

gRPC

static final String PROJECT_ID = "my-delivery-co-gcp-project";
static final String TRACKING_ID = "TID-7449w087464x5";

DeliveryServiceBlockingStub deliveryService =
  DeliveryServiceGrpc.newBlockingStub(channel);

// Tasks request
String parent = "providers/" + PROJECT_ID;
GetTaskTrackingInfoRequest getTaskTrackingInfoRequest = GetTaskTrackingInfoRequest.newBuilder()  // No need for the header
    .setParent(parent)
    .setTrackingId(TRACKING_ID)
    .build();

try {
  TaskTrackingInfo taskTrackingInfo = deliveryService.getTaskTrackingInfo(getTaskTrackingInfoRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
     case NOT_FOUND:
       break;

     case PERMISSION_DENIED:
       break;
  }
  return;
}

REST

GET https://fleetengine.googleapis.com/v1/providers/<project_id>/taskTrackingInfo/<tracking_id>

<tracking_id> คือรหัสติดตามที่เชื่อมโยงกับงาน
ส่วนหัวของคำขอต้องมีช่อง Authorization ที่มีค่า Bearer <token> โดยที่ <token> มีบทบาทบัญชีบริการที่ถูกต้อง ดูบทบาทในบัญชีบริการ
หากการค้นหาสำเร็จ เนื้อหาการตอบกลับจะมีเอนทิตี taskTrackingInfo

ตัวอย่างคำสั่ง curl:

# Set JWT, PROJECT_ID, and TRACKING_ID in the local environment
curl -H "Authorization: Bearer ${JWT}" \
  "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/taskTrackingInfo/${TRACKING_ID}"

แสดงรายการงาน

การแสดงรายการงานจะขอสิทธิ์เข้าถึงงานในวงกว้าง การแสดงรายการงานมีไว้สำหรับผู้ใช้ที่เชื่อถือได้เท่านั้น ใช้โทเค็นการตรวจสอบสิทธิ์ Delivery Fleet Reader หรือ Delivery Admin เมื่อส่งคำขอรายการงาน ดูข้อมูลเพิ่มเติมได้ที่บทบาทของบัญชีบริการ

รายการเลขหน้า

รายการงานจะแบ่งเป็นหน้าๆ คุณสามารถระบุขนาดหน้าในคำขอแสดงรายการงานได้ หากระบุขนาดหน้า จำนวนงานที่แสดงผลจะไม่เกินขนาดหน้าที่ระบุ หากไม่มีขนาดหน้า ระบบจะใช้ค่าเริ่มต้นที่เหมาะสม หากขนาดหน้าที่ขอเกินค่าสูงสุดภายใน ระบบจะใช้ค่าสูงสุดภายใน

รายการงานอาจมีโทเค็นสำหรับการอ่านผลลัพธ์หน้าถัดไป หากต้องการเรียกข้อมูลหน้าถัดไป ให้ส่งคำขอเดิมอีกครั้งพร้อมกับโทเค็นของหน้า เมื่อโทเค็นหน้าเว็บที่แสดงผลว่างเปล่า แสดงว่าไม่มีงานที่พร้อมให้เรียกข้อมูลอีกต่อไป

ช่องเมื่อแสดงรายการงาน

Fleet Engine จะปกปิดข้อมูลในช่องต่อไปนี้เมื่อแสดงรายการงาน

VehicleStop.planned_location
VehicleStop.state
VehicleStop.TaskInfo.taskId

ใช้รูปแบบฟิลด์ต่อไปนี้ตามข้อเสนอการปรับปรุง Google API

ชนิดของฟิลด์	รูปแบบ	ตัวอย่าง
การประทับเวลา	RFC-3339	`task_outcome_time = 2022-03-01T11:30:00-08:00`
ระยะเวลา	จำนวนวินาทีตามด้วย `s`	`task_duration = 120s`
ค่าแจกแจง	สตริง	`state = CLOSED AND type = PICKUP`
ตำแหน่ง	`point.latitude` และ `point.longitude`	`planned_location.point.latitude > 36.1 AND planned_location.point.longitude < -122.0`

กรองงานที่แสดงอยู่

คุณสามารถกรองงานที่แสดงตามพร็อพเพอร์ตี้งานส่วนใหญ่ได้ ดูไวยากรณ์การค้นหาตัวกรองได้ที่ AIP-160 หากไม่ได้ระบุคำค้นหาตัวกรอง ระบบจะแสดงรายการงานทั้งหมด

ตารางต่อไปนี้แสดงพร็อพเพอร์ตี้ของงานที่ถูกต้องซึ่งคุณใช้กรองได้

พร็อพเพอร์ตี้ของงานสำหรับการกรองรายการ
`type` `attributes` `tracking_id` `delivery_vehicle_id` `state` `planned_location`	`task_duration` `task_duration_outcome` `task_outcome` `task_outcome_location` `task_outcome_time`

ดูโอเปอเรเตอร์การค้นหาตัวกรองทั้งหมดได้ที่ AIP-160

ตัวอย่างงานในรายการ

ตัวอย่างต่อไปนี้แสดงวิธีแสดงรายการงานสำหรับ deliveryVehicleId และแอตทริบิวต์งาน ทั้งด้วยไลบรารี Java gRPC และการเรียก HTTP REST ไปยัง ListTasks

การตอบกลับที่สำเร็จอาจยังว่างเปล่าอยู่ การตอบกลับที่ว่างเปล่าหมายความว่าไม่มีงานที่เชื่อมโยงกับ deliveryVehicleId ที่ระบุ

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TRACKING_ID = "TID-7449w087464x5";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Tasks request
 String parent = "providers/" + PROJECT_ID;
 ListTasksRequest listTasksRequest = ListTasksRequest.newBuilder()  // No need for the header
     .setParent(parent)
     .setFilter("delivery_vehicle_id = 123 AND attributes.foo = true")
     .build();

 try {
   ListTasksResponse listTasksResponse = deliveryService.listTasks(listTasksRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;

      case PERMISSION_DENIED:
        break;
   }
   return;
 }

REST

GET https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks

หากต้องการใช้ตัวกรองกับงานที่แสดง ให้ใส่พารามิเตอร์ของ URL "filter" พร้อมกับคำค้นหาตัวกรองที่กำหนดเป็น URL เป็นค่า

ส่วนหัวของคำขอต้องมีช่อง Authorization ที่มีค่า Bearer <token> โดยที่ <token> มีบทบาทบัญชีบริการที่ถูกต้อง ดูบทบาทในบัญชีบริการ

การค้นหาที่สำเร็จจะแสดงเนื้อหาการตอบกลับที่มีโครงสร้างต่อไปนี้

    // JSON representation
    {
      "tasks": [
        {
          object (Task)
        }
      ],
      "nextPageToken": string,
      "totalSize": integer
    }

ตัวอย่างคำสั่ง curl:

 # Set JWT, PROJECT_ID, and VEHICLE_ID in the local environment
 curl -H "Authorization: Bearer ${JWT}" \
   "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks?filter=state%20%3D%20OPEN%20AND%20delivery_vehicle_id%20%3D%20${VEHICLE_ID}"

ขั้นตอนถัดไป

จัดการการจัดส่ง

ค้นหางาน จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

ค้นหางาน

ค้นหางานตามรหัสงาน

gRPC

REST

ค้นหางานตามรหัสติดตาม

gRPC

REST

แสดงรายการงาน

รายการเลขหน้า

ช่องเมื่อแสดงรายการงาน

กรองงานที่แสดงอยู่

ตัวอย่างงานในรายการ

gRPC

REST

ขั้นตอนถัดไป

ค้นหางาน