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

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

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

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

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

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

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

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

อัปเดตฟิลด์การเดินทาง

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

ใช้ Field Mask

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

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

คุณต้องกำหนดค่าการเดินทางด้วยรหัสยานพาหนะเพื่อให้ 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

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