อัปเดตการเดินทางและจัดการรัฐ

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

ข้อมูลเบื้องต้นเกี่ยวกับการอัปเดตการเดินทาง

ระบบของคุณจะใช้ Fleet Engine เพื่ออัปเดตการเดินทางในสถานการณ์ต่อไปนี้

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

หากต้องการอัปเดตการเดินทาง ให้ส่งคำขอโดยใช้ gRPC หรือ REST

• วิธี UpdateTrip(): gRPC หรือ REST
• ข้อความ UpdateTripRequest: gRPC เท่านั้น

ใช้ข้อมูลเข้าสู่ระบบที่เหมาะสมสำหรับบัญชีบริการของโปรเจ็กต์ตามที่อธิบายไว้ในFleet Engine: บทบาทของบัญชีบริการ

อัปเดตช่องการเดินทาง

คุณสามารถอัปเดตช่องการเดินทางที่อธิบายไว้ในช่องการเดินทางในสร้างการเดินทางที่มีจุดหมายเดียวได้ ตัวอย่างเช่น หลังจากสร้างการเดินทางแล้ว แนวทางปฏิบัติที่พบบ่อยคือการค้นหายานพาหนะก่อน แล้วจึงอัปเดตช่อง vehicle_id ของการเดินทางเพื่อเชื่อมโยงกับการเดินทางที่จะดำเนินการ

ใช้มาสก์ฟิลด์

มาสก์ฟิลด์เป็นวิธีที่การเรียก API จะแสดงรายการฟิลด์ที่คำขอควรแสดงหรืออัปเดต การใช้ FieldMask จะช่วยหลีกเลี่ยงการทำงานที่ไม่จำเป็นและปรับปรุงประสิทธิภาพ Fleet Engine ใช้มาสก์ฟิลด์เพื่ออัปเดตฟิลด์ในทรัพยากรทั้งหมด

อัปเดตการเดินทางด้วยรหัสยานพาหนะ

คุณต้องกำหนดค่าการเดินทางด้วยรหัสยานพาหนะเพื่อให้ Fleet Engine ติดตามยานพาหนะตามเส้นทางได้ ตัวอย่างโค้ดต่อไปนี้แสดงวิธีอัปเดตการเดินทางด้วยรหัสยานพาหนะ

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// The trip settings to update.
Trip trip = Trip.newBuilder()
    .setVehicleId("8241890")
    .build();

// The trip update request.
UpdateTripRequest updateTripRequest =
    UpdateTripRequest.newBuilder()      // No need for the header.
        .setName(tripName)
        .setTrip(trip)
        .setUpdateMask(FieldMask.newBuilder().addPaths("vehicle_id"))
        .build();

// Error handling.
// If the Fleet Engine has both a trip and vehicle with IDs, and if the
// credentials validate, then the service updates the trip.
try {
  Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:                    // Neither the trip nor vehicle exist.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

จัดการสถานะการเดินทางสำหรับการเดินทาง

คุณระบุสถานะของการเดินทางโดยใช้ค่าการแจงนับ TripStatus ค่าใดค่าหนึ่ง เมื่อสถานะของการเดินทางเปลี่ยนแปลง เช่น จาก ENROUTE_TO_PICKUP เป็น ARRIVED_AT_PICKUP คุณจะอัปเดตสถานะการเดินทางใน Fleet Engine วงจรการเดินทางจะเริ่มต้นด้วยค่าสถานะ NEW เสมอ และสิ้นสุดด้วยค่า COMPLETE หรือ CANCELED

ตัวอย่างการอัปเดตการเดินทาง

ตัวอย่างต่อไปนี้แสดงวิธีอัปเดตสถานะการเดินทางสำหรับการเดินทางแบบต่อเนื่องใน Fleet Engine

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String TRIP_ID = "trip-8241890";

String tripName = "providers/" + PROJECT_ID + "/trips/" + TRIP_ID;

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

// Trip settings to be updated.
Trip trip = Trip.newBuilder()
    .setTripStatus(TripStatus.ARRIVED_AT_PICKUP)
    .build();

// Trip update request
UpdateTripRequest updateTripRequest = UpdateTripRequest.newBuilder()
    .setName(tripName)
    .setTrip(trip)
    .setUpdateMask(FieldMask.newBuilder().addPaths("trip_status"))
    .build();

// Error handling.
try {
  Trip updatedTrip = tripService.updateTrip(updateTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case NOT_FOUND:            // The trip doesn't exist.
      break;
    case FAILED_PRECONDITION:  // The given trip status is invalid.
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

ดูตัวอย่างอื่นๆ เกี่ยวกับวิธีอัปเดตการเดินทางได้ในส่วนการเดินทางประเภทอื่นๆ

จัดการข้อผิดพลาดเกี่ยวกับการเดินทาง

เมื่ออัปเดตหรือค้นหาการเดินทางที่มีอยู่ คุณอาจพบข้อผิดพลาด DEADLINE_EXCEEDED ซึ่งในกรณีนี้จะไม่ทราบสถานะของ Fleet Engine หากต้องการตรวจสอบปัญหานี้ ให้เรียกใช้ CreateTrip อีกครั้งโดยใช้รหัสการเดินทางเดียวกับที่คุณพยายามอัปเดตหรือตรวจสอบ ซึ่งควรแสดงผลเป็น 201 (CREATED) หรือ 409 (CONFLICT) ในกรณีหลัง คำขอก่อนหน้าสำเร็จก่อน DEADLINE_EXCEEDED

ดูรายการข้อผิดพลาดเกี่ยวกับเครือข่ายใน Consumer SDK สำหรับ Android หรือ iOS

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

• ค้นหาการเดินทาง