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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  โปรเจ็กต์ Cloud ที่คุณอ้างอิงที่นี่ต้องมีบทบาทบัญชีบริการ 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เอนทิตี

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

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

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