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

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

• 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)

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

คำขอใช้ยานพาหนะ

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

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

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

   หมายเหตุ: สตริงรหัสยานพาหนะมีข้อจำกัดด้านอักขระบางอย่าง หลีกเลี่ยง รหัสที่เพิ่มขึ้นโดยอัตโนมัติ และตรวจสอบว่ารหัสไม่มีข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ ดูรายละเอียดเกี่ยวกับข้อจำกัดของอักขระได้ที่ฟิลด์รหัสยานพาหนะ สำหรับ CreateVehicleRequest หรือ CreateDeliveryVehicleRequest

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 ของคุณ รถแต่ละคันที่คุณสร้างสำหรับโปรเจ็กต์หนึ่งๆ จะมีเส้นทางหลักเดียวกัน

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

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

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

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