บทนำ: สร้างยานพาหนะ

ดูข้อมูลทั่วไปเกี่ยวกับวิธีการทำงานของยานพาหนะใน Fleet Engine ได้จากคำแนะนำต่อไปนี้ในส่วนข้อมูลสำคัญเกี่ยวกับ Fleet Engine

• Fleet Engine คืออะไร
• ข้อมูลเบื้องต้นเกี่ยวกับยานพาหนะ

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

คุณใช้วิธีการสร้างเพื่อสร้างทรัพยากรยานพาหนะโดยใช้ gRPC หรือ REST ชื่อฟิลด์ในคู่มือนี้ใช้สัญกรณ์ gRPC เพื่อความเรียบง่าย

คำขอเกี่ยวกับยานพาหนะ

สำหรับความสามารถทั้งแบบออนดีมานด์และแบบงานที่กำหนดเวลาไว้ คุณสร้างและอัปเดตยานพาหนะโดยส่งข้อความคำขอที่มีฟิลด์ต่างๆ ซึ่งสรุปได้ดังนี้

1. หลัก: สตริงที่เชื่อมโยงกับรหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ซึ่งใช้เพื่อป้อนข้อมูลในฟิลด์ชื่อของอินสแตนซ์ยานพาหนะ

2. รหัสของยานพาหนะ: สตริงที่ไม่ซ้ำกันซึ่งใช้เพื่อป้อนข้อมูลในname ฟิลด์ของยานพาหนะ

3. อินสแตนซ์ยานพาหนะ ที่มีฟิลด์ที่ต้องกรอก ฟิลด์เหล่านี้จะขึ้นอยู่กับความสามารถของ Fleet Engine ที่คุณใช้

ข้อมูลในเนื้อหาคำขอจะแตกต่างกันไปตามลักษณะของคำขอ ดูรายละเอียดเหล่านั้นได้ในคู่มือที่เกี่ยวข้อง

โทเค็นการตรวจสอบสิทธิ์และการให้สิทธิ์

คำขอที่ส่งไปยัง Fleet Engine ต้องระบุข้อมูลเข้าสู่ระบบที่ถูกต้องด้วย ตัวอย่างในคู่มือนี้มีสมมติฐานดังนี้

• ตัวอย่าง gRPC สันนิษฐานว่ามีการใช้ไลบรารีการให้สิทธิ์สำหรับ Java
• ตัวอย่าง REST แสดงส่วนหัวของคำขอ HTTP ซึ่งต้องมี ฟิลด์ Authorization ที่มีค่าเป็น Bearer <token> โดยที่ <token> คือ JSON Web Token ที่คุณออก

ดูรายละเอียดเพิ่มเติมได้ในคู่มือการตั้งค่า Fleet Engine

ฟิลด์ทรัพยากรยานพาหนะ

ทรัพยากรยานพาหนะมีฟิลด์ประเภทต่อไปนี้

• ฟิลด์เอาต์พุตเท่านั้น ฟิลด์ที่บริการตั้งค่าเป็นเอาต์พุตของเมธอดอื่นและตั้งค่าโดยตรงไม่ได้ ฟิลด์สำคัญประเภทนี้คือฟิลด์ name Fleet Engine จะไม่สนใจค่าที่ระบุสำหรับ name ของยานพาหนะตามคำแนะนำจาก Google AIP สำหรับ รหัสที่ผู้ใช้ระบุ หากคุณระบุค่าสำหรับฟิลด์เหล่านี้ Fleet Engine จะแสดงข้อผิดพลาด
• ฟิลด์ที่ต้องกรอก ยานพาหนะที่สร้างขึ้นในบริการการเดินทางแบบออนดีมานด์กำหนดให้ต้องตั้งค่าฟิลด์บางฟิลด์เมื่อสร้าง ยานพาหนะที่สร้างขึ้นในบริการงานที่กำหนดเวลาไว้ไม่มีฟิลด์ทรัพยากรยานพาหนะที่ต้องกรอก
• ฟิลด์ที่ไม่บังคับ ทั้ง 2 บริการมีฟิลด์ที่คุณตั้งค่าได้เมื่อสร้างหรือหลังจากนั้น คุณดูฟิลด์เหล่านี้ได้ในคู่มืออ้างอิงที่เกี่ยวข้องสำหรับบริการที่คุณใช้

ชื่อยานพาหนะ (เอาต์พุตเท่านั้น)

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

• หลัก: สตริงที่เชื่อมโยงกับรหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google ใน รูปแบบ providers/{provider} โดยที่ {provider} คือรหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ ยานพาหนะแต่ละคันที่คุณสร้างขึ้นสำหรับโปรเจ็กต์หนึ่งๆ จะมีเส้นทางระดับบนเหมือนกัน

  โปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่คุณอ้างอิงที่นี่ต้องมีบทบาทบัญชีบริการ Fleet Engine สำหรับบริการที่คุณใช้ด้วย ดูรายการบัญชีบริการเหล่านั้นได้ที่บัญชีบริการสำหรับ Fleet Engine ไม่รองรับการเข้าถึงจากโปรเจ็กต์ Google Cloud หลายโปรเจ็กต์

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

ในบริการที่อิงตาม Google Cloud, API ทั้งหมดต้องแสดงทรัพยากรเป็นสตริง ดูรายละเอียดเพิ่มเติมได้ที่การตั้งชื่อทรัพยากรใน Fleet Engine

ตัวระบุที่ไม่ซ้ำกันของเอนทิตี

รูปแบบและค่าของตัวระบุที่ไม่ซ้ำกันของเอนทิตีที่ใช้ในการเรียกทรัพยากรนั้น Fleet Engine จะไม่ทราบ ตรวจสอบว่าตัวระบุไม่มีข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) เช่น หมายเลขโทรศัพท์ของคนขับ

การนำยานพาหนะกลับมาใช้

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

วิธีที่แนะนำในการรักษายานพาหนะให้พร้อมใช้งานใน Fleet Engine คือการอัปเดตตำแหน่งของยานพาหนะเป็นระยะๆ การอัปเดตฟิลด์อื่นๆ ส่วนใหญ่ในเอนทิตี Vehicle จะขยายอายุการใช้งานของเอนทิตีด้วย โดยค่าฟิลด์ใหม่ต้องแตกต่างจากค่าเดิม

หมายเหตุ: ฟิลด์บางฟิลด์ในเอนทิตี Vehicle เช่น device_settings เป็นเพียงข้อมูลการแก้ไขข้อบกพร่องที่ Fleet Engine ไม่ได้เก็บไว้ การอัปเดตฟิลด์เหล่านี้จะไม่ขยายอายุการใช้งานของเอนทิตี Vehicle

เราขอแนะนำให้จับคู่รหัสคนขับกับรหัสยานพาหนะเดิมซ้ำๆ ทุกวันเพื่อการวิเคราะห์ระบบที่ดีขึ้น ทำได้โดยใช้รหัสยานพาหนะเดิมที่เชื่อมโยงกับคนขับสำหรับจุดแวะพักที่กำหนดเวลาไว้ก่อนหน้านี้หรือการเดินทางแบบออนดีมานด์

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

• สร้างยานพาหนะสำหรับการเดินทางแบบออนดีมานด์
• สร้างยานพาหนะสำหรับงานที่กำหนดเวลาไว้