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

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

ดูรายการข้อผิดพลาดของเครือข่ายใน SDK ของผู้บริโภค สำหรับทั้ง Android หรือ iOS

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