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

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

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

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

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

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

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

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

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

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

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

หน้ากากฟิลด์เป็นวิธีที่ผู้เรียก API แสดงรายการฟิลด์ที่คำขอควรอัปเดตหรืออัปเดต การใช้ FieldMask ช่วยหลีกเลี่ยงการทำงานที่ไม่จำเป็นและปรับปรุงประสิทธิภาพ 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 ซึ่งในกรณีนี้ สถานะของเครื่องยนต์ของกลุ่มยานพาหนะจะไม่ทราบ หากต้องการตรวจสอบเรื่องนี้ ก่อนอื่นให้โทรหา CreateTrip อีกครั้งโดยใช้รหัสการเดินทางเดียวกันกับที่คุณพยายามอัปเดตหรือตรวจสอบ ซึ่งควรแสดงผลเป็น 201 (สร้างแล้ว) หรือ 409 (ขัดแย้ง) ในกรณีหลัง หมายความว่าคำขอก่อนหน้าดำเนินการสำเร็จแล้ว DEADLINE_EXCEEDED

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

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