ดูข้อมูลทั่วไปเกี่ยวกับวิธีการทำงานของยานพาหนะใน Fleet Engine ได้จากคำแนะนำต่อไปนี้ในส่วนข้อมูลสำคัญเกี่ยวกับ Fleet Engine
เอกสารประกอบในส่วนนี้จะอธิบายวิธีสร้างและจัดการยานพาหนะในฟีเจอร์ Fleet Engine คุณสร้างยานพาหนะในสภาพแวดล้อมเซิร์ฟเวอร์ของ Fleet Engine เพื่อจำลองยานพาหนะจริงในการใช้งานจริง ยานพาหนะของเครื่องยนต์ฟลีตควรสอดคล้องกับยานพาหนะที่ใช้ในระบบแบ็กเอนด์ที่คุณใช้สำหรับการกำหนดและการกำหนดเส้นทางยานพาหนะ
คุณใช้เมธอดสร้างเพื่อสร้างทรัพยากรยานพาหนะโดยใช้ gRPC หรือ REST ชื่อช่องในคู่มือนี้ใช้การเขียน gRPC เพื่อให้เข้าใจง่าย
การเดินทางแบบออนดีมานด์
CreateVehicleRequest(gRPC)providers.vehicle.create(REST)- ทรัพยากร
Vehicle(REST, gRPC)
งานที่กำหนดเวลาไว้
CreateDeliveryVehicleRequest(gRPC)providers.deliveryVehicles.create(REST)DeliveryVehicle(REST, gRPC)
คำขอยานพาหนะ
สำหรับความสามารถของงานแบบออนดีมานด์และแบบกำหนดเวลา คุณจะสร้างและอัปเดตยานพาหนะได้โดยส่งข้อความคำขอที่มีช่องต่างๆ ซึ่งสรุปได้ดังนี้
- รายการหลัก: สตริงที่เชื่อมโยงกับรหัสโปรเจ็กต์ Google Cloud ของคุณ ซึ่งใช้เพื่อป้อนข้อมูลในช่องชื่อของอินสแตนซ์ยานพาหนะ
รหัสของยานพาหนะ: สตริงที่ไม่ซ้ำกันซึ่งใช้ป้อนข้อมูลในช่อง
nameของยานพาหนะอินสแตนซ์ยานพาหนะที่มีช่องที่ต้องกรอก ช่องเหล่านี้ขึ้นอยู่กับความสามารถของเครื่องมือจัดการฟลีตที่คุณใช้
ข้อมูลในเนื้อหาคำขอจะแตกต่างกันไปตามลักษณะของคำขอ ดูรายละเอียดเหล่านั้นได้ในคู่มือที่เกี่ยวข้อง
โทเค็นการตรวจสอบสิทธิ์และการให้สิทธิ์
คำขอไปยัง Fleet Engine จะต้องระบุข้อมูลเข้าสู่ระบบที่ถูกต้องด้วย ตัวอย่างในคู่มือนี้จะถือว่ามีเงื่อนไขต่อไปนี้
- ตัวอย่าง gRPC ถือว่ามีการใช้ไลบรารีการให้สิทธิ์สําหรับ Java
- ตัวอย่าง REST แสดงส่วนหัวคำขอ HTTP ซึ่งต้องมีช่อง
Authorizationที่มีค่าเป็นBearer <token>โดยที่<token>คือโทเค็นเว็บ JSON ที่คุณออก
ดูรายละเอียดเพิ่มเติมได้ที่คู่มือตั้งค่า Fleet Engine
ฟิลด์ทรัพยากรยานพาหนะ
ทรัพยากรยานพาหนะมีฟิลด์ประเภทต่อไปนี้
- ช่องเอาต์พุตเท่านั้น ช่องที่บริการตั้งค่าเป็นเอาต์พุตของวิธีอื่นและตั้งค่าโดยตรงไม่ได้ ช่องที่สําคัญของประเภทนี้คือช่อง
nameเครื่องมือจัดการฟลีตจะไม่สนใจค่าที่ระบุสำหรับช่องnameของยานพาหนะตามคำแนะนำจาก Google AIP สำหรับรหัสที่ผู้ใช้ระบุ หากคุณระบุค่าในช่องเหล่านี้ Fleet Engine จะแสดงข้อผิดพลาด - ช่องที่ต้องกรอก ยานพาหนะที่สร้างขึ้นในบริการการเดินทางแบบออนดีมานด์จำเป็นต้องมีการตั้งค่าฟิลด์บางอย่างเมื่อสร้าง ยานพาหนะที่สร้างขึ้นในบริการงานที่กำหนดเวลาไว้จะไม่มีฟิลด์ทรัพยากรยานพาหนะที่จําเป็น
- ช่องที่ไม่บังคับ บริการทั้ง 2 รายการมีช่องที่คุณตั้งค่าได้เมื่อสร้างหรือหลังจากนั้น ซึ่งดูได้ในคู่มืออ้างอิงที่เกี่ยวข้องสำหรับบริการที่คุณใช้
ชื่อยานพาหนะ (เอาต์พุตเท่านั้น)
ช่อง name เหมือนกันทุกประการสำหรับบริการการเดินทางแบบออนดีมานด์และบริการงานที่กำหนดเวลาไว้ Fleet Engine จะกำหนดฟิลด์เมื่อคุณสร้างยานพาหนะ โดยอิงตามฟิลด์ 2 ฟิลด์ที่คุณตั้งค่าไว้เมื่อสร้างยานพาหนะ
รายการหลัก: สตริงที่เชื่อมโยงกับรหัสโปรเจ็กต์ Google Cloud ในรูปแบบ
providers/{provider}โดยที่{provider}คือรหัสของโปรเจ็กต์ Cloud ยานพาหนะแต่ละคันที่คุณสร้างสำหรับโปรเจ็กต์หนึ่งๆ จะมีเส้นทางหลักเดียวกันโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่คุณอ้างอิงที่นี่ต้องมีบทบาทบัญชีบริการของ Fleet Engine สำหรับบริการที่คุณใช้ด้วย ดูรายการบัญชีบริการเหล่านั้นได้ที่บัญชีบริการ Fleet Engine ไม่รองรับการเข้าถึงจากโปรเจ็กต์ Google Cloud หลายโปรเจ็กต์
รหัสของยานพาหนะ ซึ่งต้องไม่ซ้ำกันสำหรับยานพาหนะทั้งหมดในฟลีตและเป็นสตริง Unicode ที่ถูกต้อง นี่เป็นรหัสทรัพยากรของยานพาหนะ ทั้งการเดินทางแบบออนดีมานด์และจุดจอดตามกำหนดการจะใช้ข้อมูลนี้เพื่อเชื่อมโยงการเดินทางหรืองานกับยานพาหนะที่ดำเนินการเสร็จสมบูรณ์
ในบริการที่ทำงานบน Google Cloud นั้น API ทั้งหมดต้องแสดงทรัพยากรเป็นสตริง ดูรายละเอียดเพิ่มเติมได้ที่การตั้งชื่อทรัพยากรใน Fleet Engine
ตัวระบุเอนทิตีที่ไม่ซ้ำกัน
รูปแบบและค่าของตัวระบุเอนทิตีที่ไม่ซ้ำกันซึ่งใช้ในการเรียกใช้ทรัพยากรจะมองไม่เห็นสำหรับ Fleet Engine ตรวจสอบว่าตัวระบุไม่มีข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) เช่น หมายเลขโทรศัพท์ของคนขับ
การใช้ยานพาหนะซ้ำ
หลังจากยานพาหนะหยุดทุกจุดตามแผนการเดินทางที่กำหนดแล้ว ยานพาหนะจะยังคงพร้อมใช้งานใน Fleet Engine เป็นเวลา 7 วัน ซึ่งหมายความว่าคุณจะใช้ยานพาหนะซ้ำได้ในวันทำการต่อๆ ไปโดยไม่ต้องสร้างใหม่ ทุกครั้งที่คุณนำยานพาหนะกลับมาใช้ใหม่ เครื่องยนต์ของกลุ่มยานพาหนะจะรีเซ็ตความพร้อมใช้งานของยานพาหนะนั้น และเมื่อถึงจุดนี้ การนับถอยหลัง 7 วันก็จะเริ่มขึ้นใหม่
แนวทางที่แนะนำเพื่อให้ยานพาหนะพร้อมใช้งานใน Fleet Engine อยู่เสมอคือการอัปเดตตำแหน่งเป็นระยะๆ การอัปเดตช่องอื่นๆ ส่วนใหญ่ในเอนทิตี Vehicle จะยืดอายุของเอนทิตีนั้นด้วย ในกรณีที่ค่าช่องใหม่แตกต่างจากค่าที่มีอยู่
หมายเหตุ: ฟิลด์บางฟิลด์ในเอนทิตี Vehicle เช่น device_settings เป็นข้อมูลการแก้ไขข้อบกพร่องล้วนๆ ที่ Fleet Engine ไม่ได้เก็บไว้ การอัปเดตจะไม่ยืดอายุการใช้งานของเอนทิตี Vehicle
คุณควรใช้การจับคู่รหัสคนขับกับรหัสยานพาหนะเดิมซ้ำๆ ในแต่ละวันเพื่อให้การวิเคราะห์ของระบบดีขึ้น โดยให้ใช้รหัสยานพาหนะเดียวกันกับที่เชื่อมโยงกับคนขับสำหรับจุดจอดตามกำหนดการหรือการเดินทางแบบออนดีมานด์ก่อนหน้านี้