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

เอกสารนี้อธิบายวิธีอัปเดตการเดินทางและจัดการสถานะของการเดินทาง ซึ่งรวมถึงการใช้มาสก์ฟิลด์เพื่อตั้งค่าฟิลด์ที่เกี่ยวข้องกับการเดินทาง โดยถือว่าคุณ ได้ตั้งค่า 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

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

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