สร้างการเดินทางต่อเนื่อง

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

• ตั้งค่า Fleet Engine
• สร้างพาหนะ
• สถานการณ์การเดินทางในภาพรวมการเดินทางแบบออนดีมานด์

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

ส่วนนี้จะอธิบายรายละเอียดคำขอที่จำเป็นสำหรับการสร้างการเดินทางใน Fleet Engine คุณส่งคำขอสร้างโดยใช้ gRPC และ REST

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

ช่องสำหรับการเดินทาง

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

ฟิลด์การเดินทาง

ชื่อ	จำเป็นหรือไม่	คำอธิบาย
หลัก	ใช่	สตริงที่มีรหัสโปรเจ็กต์ รหัสนี้ต้องเป็นรหัสเดียวกับที่ใช้ ในการผสานรวม Fleet Engine ทั้งหมดด้วยบัญชีบริการเดียวกัน บทบาทใหม่
trip_id	ใช่	สตริงที่คุณสร้างซึ่งระบุการเดินทางนี้โดยไม่ซ้ำกัน รหัสการเดินทางมี ข้อจำกัดบางอย่างตามที่ระบุไว้ในข้อมูลอ้างอิง
trip_type	ใช่	ตั้งค่า TripType ให้เป็นค่าต่อไปนี้สำหรับประเภทการเดินทางที่กำลังสร้าง ปลายทางเดียว: ตั้งค่าเป็น SHARED หรือ EXCLUSIVE หลายปลายทาง: ตั้งค่าเป็น EXCLUSIVE ต่อเนื่องกัน: ตั้งค่าเป็น EXCLUSIVE การรวมกลุ่มที่ใช้ร่วมกัน: ตั้งค่าเป็น SHARED
pickup_point	ใช่	จุดเริ่มต้นของการเดินทาง
ปลายทางขั้นกลาง	ใช่	การเดินทางที่มีหลายปลายทางเท่านั้น: รายการจุดหมายระดับกลางที่คนขับเข้าชมระหว่างทาง การรับส่ง เช่นเดียวกับ dropoff_point ฟิลด์นี้ คุณสามารถตั้งค่าในภายหลังได้โดยเรียก UpdateTrip แต่เป็นหลายปลายทาง การเดินทางตามคำจำกัดความจะมีปลายทางระดับกลาง
vehicle_waypoints	ใช่	การเดินทางแบบแชร์ร่วมกันเท่านั้น: ช่องนี้รองรับการสลับจุดระหว่างการเดินทางจากหลายการเดินทาง ซึ่งประกอบด้วยจุดอ้างอิงที่เหลืออยู่ทั้งหมดสำหรับยานพาหนะที่กำหนด เป็นจุดอ้างอิงจุดรับส่งสำหรับการเดินทางนี้ คุณสามารถตั้งค่าช่องนี้ได้ โดยโทรไปที่ CreateTrip หรือ UpdateTrip นอกจากนี้คุณยัง อัปเดตจุดอ้างอิงของยานพาหนะผ่านฟิลด์ waypoints ด้วย โทรหา UpdateVehicle บริการไม่ส่งคืนข้อมูลนี้เมื่อโทร GetTrip ครั้ง เนื่องจากเหตุผลด้านความเป็นส่วนตัว
number_of_passengers	ไม่ได้	จำนวนผู้โดยสารในการเดินทาง
dropoff_point	ไม่ได้	จุดหมายของการเดินทาง
vehicle_id	ไม่ได้	รหัสของพาหนะที่กำหนดการเดินทาง

ตัวอย่าง: สร้างการเดินทางขากลับ

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

// A vehicle with ID 'my-vehicle' is already created and it is assigned to a trip with ID 'current-trip'.

static final String PROJECT_ID = "my-rideshare-co-gcp-project";
static final String VEHICLE_ID =" my-vehicle";
static final String TRIP_ID = "back-to-back-trip");

TripServiceBlockingStub tripService = TripService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;

Trip trip = Trip.newBuilder()
    .setTripType(TripType.EXCLUSIVE)
    .setPickupPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.195139).setLongitude(106.820826)))
    .setDropoffPoint(
        TerminalLocation.newBuilder().setPoint(
            LatLng.newBuilder()
                .setLatitude(-6.1275).setLongitude(106.6537)))
    .setVehicleId(VEHICLE_ID)
    .build();

// Create trip request
CreateTripRequest createTripRequest = CreateTripRequest.newBuilder()
    .setParent(parent)
    .setTripId(TRIP_ID)
    .setTrip(trip)
    .build();

// Error handling.
try {
  // Fleet Engine automatically assigns a 'waypoints' list to the trip containing
  // the vehicle's current trip waypoints.
  Trip createdTrip =
      tripService.createTrip(createTripRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}

อัปเดตการเดินทางขาไป

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

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

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

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

• การเรียกใช้ getVehicle() จะส่งคืน remainingWaypoints ที่มี:
  _{การออก} → B _{การรับสินค้า} → B _{การออก}
• getTrip() หรือ onTripRemainingWaypointsUpdated Callback สำหรับ การเดินทาง A กลับมาแล้ว remainingWaypoints ที่มีสิ่งต่อไปนี้
  ก _{การออก}
• getTrip() หรือ onTripRemainingWaypointsUpdated Callback สำหรับ การเดินทาง B กลับมาแล้ว remainingWaypoints ที่มี:
  การ_{ออกจาก} → B _{การรับสินค้า} → และ B _{การออก}

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

• สร้างการเดินทางร่วมที่แชร์
• ตั้งค่า Driver SDK