หากต้องการสร้างยานพาหนะใน Fleet Engine สำหรับการเดินทางแบบออนดีมานด์ ให้ใช้ปลายทาง CreateVehicle
ที่มี CreateVehicleRequest
ปลายทางนี้ต้องใช้บัญชีที่มีบทบาทผู้ดูแลระบบแบบออนดีมานด์ของ Fleet Engine
ฟิลด์สำหรับยานพาหนะสำหรับการเดินทางแบบออนดีมานด์
เมื่อสร้างยานพาหนะสำหรับการเดินทางแบบออนดีมานด์ คุณต้องตั้งค่าฟิลด์ที่ต้องกรอก นอกจากนี้ คุณควรคุ้นเคยกับวิธีที่ช่องยานพาหนะบางช่องส่งผลต่อฟังก์ชันอื่นๆ ใน Fleet Engine ด้วย โปรดดูอัปเดตช่องยานพาหนะ
ฟิลด์ที่ต้องกรอกสำหรับการเดินทางแบบออนดีมานด์
vehicle_state
: ค่าเริ่มต้นคือ "ไม่ทราบ" แต่ควรตั้งค่าเป็น "ออนไลน์" หรือ "ออฟไลน์" ดูข้อมูลเกี่ยวกับการตั้งค่าช่องสถานะยานพาหนะในอัปเดตช่องยานพาหนะsupported_trip_types
: ค่าเริ่มต้นคือ "ไม่ทราบ" แต่ควรตั้งค่าเป็น SHARED, EXCLUSIVE หรือทั้ง 2 อย่าง ดูรายละเอียดเกี่ยวกับประเภทการเดินทางได้ในคู่มือการเดินทางแบบออนดีมานด์maximum_capacity
: จำนวนผู้โดยสารที่ยานพาหนะสามารถบรรทุกได้ ซึ่งไม่รวมคนขับ (ตามคำจำกัดความ)vehicle_type
: ค่าคือAUTO
,TAXI
,TRUCK
,TWO_WHEELER
,BICYCLE
หรือPEDESTRIAN
ใช้เพื่อกรองยานพาหนะสำหรับการค้นหายานพาหนะได้ ซึ่งจะส่งผลต่อการคำนวณเวลาถึงโดยประมาณและเส้นทางด้วย เครื่องมือจัดการยานพาหนะจะแสดงเส้นทางและการคำนวณการเดินทางที่สอดคล้องกับรูปแบบการเดินทางตามกลุ่มประเภทยานพาหนะต่อไปนี้AUTO
,TAXI
หรือTRUCK
: เช่น ทางหลวงTWO_WHEELER
: เช่น จะไม่แสดงเส้นทางที่ห้ามใช้รถ 2 ล้อBICYCLE
: เช่น เส้นทางจักรยานPEDESTRIAN
: เช่น สะพานและทางเดินสำหรับเดินเท้าเท่านั้น
ฟิลด์อื่นๆ
ดูช่องอื่นๆ ที่คุณตั้งค่าได้เมื่อสร้างยานพาหนะได้ที่อัปเดตช่องของยานพาหนะ
ตัวอย่างการสร้างยานพาหนะ
ค่าที่แสดงผลจาก CreateVehicle
คือเอนทิตี Vehicle
ที่สร้างขึ้น
Java
static final String PROJECT_ID = "project-id";
VehicleServiceBlockingStub vehicleService =
VehicleService.newBlockingStub(channel);
String parent = "providers/" + PROJECT_ID;
Vehicle vehicle = Vehicle.newBuilder()
.setVehicleState(VehicleState.OFFLINE) // Initial state
.addSupportedTripTypes(TripType.EXCLUSIVE)
.setMaximumCapacity(4)
.setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
.addAttributes(VehicleAttribute.newBuilder()
.setKey("on_trip").setValue("false")) // Opaque to the Fleet Engine
// Add .setBackToBackEnabled(true) to make this vehicle eligible for trip
// matching while even if it is on a trip. By default this is disabled.
.build();
CreateVehicleRequest createVehicleRequest =
CreateVehicleRequest.newBuilder() // no need for the header
.setParent(parent)
.setVehicleId("vid-8241890") // Vehicle ID assigned by Rideshare or Delivery Provider
.setVehicle(vehicle) // Initial state
.build();
// In this case, the Vehicle is being created in the OFFLINE state and
// no initial position is being provided. When the Driver App checks
// in with the Rideshare or Delivery Provider, the state can be set to ONLINE and
// the Driver App will update the Vehicle Location.
try {
Vehicle createdVehicle =
vehicleService.createVehicle(createVehicleRequest);
} catch (StatusRuntimeException e) {
Status s = e.getStatus();
switch (s.getCode()) {
case ALREADY_EXISTS:
break;
case PERMISSION_DENIED:
break;
}
return;
}
// If no Exception, Vehicle created successfully.
REST
curl -X POST \
"https://fleetengine.googleapis.com/v1/providers/project-id/vehicles?vehicleId=vid-8241890" \
-H "Authorization: Bearer $JWT" \
-H "Content-Type: application/json" \
--data-binary @- << EOM
{
"vehicleState": "OFFLINE",
"supportedTripTypes": ["EXCLUSIVE"],
"maximumCapacity": 4,
"vehicleType": {"category": "AUTO"},
"attributes": [{"key": "on_trip", "value": "false"}]
}
EOM
ดูข้อมูลอ้างอิง providers.vehicles.create