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

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

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

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

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

การเดินทางแบบออนดีมานด์

• CreateVehicleRequest (gRPC)
• providers.vehicle.create (พัก)
• ทรัพยากร Vehicle (REST, gRPC)

งานที่กำหนดเวลาไว้

• CreateDeliveryVehicleRequest (gRPC)
• providers.deliveryVehicles.create (พัก)
• 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 แสดงผลข้อผิดพลาด
• ช่องที่ต้องกรอก ยานพาหนะที่สร้างขึ้นในบริการการเดินทางแบบออนดีมานด์ต้องใช้ ว่าจะตั้งค่าบางช่องไว้ในการสร้าง ยานพาหนะที่สร้างขึ้นในกำหนดการ Tasks ไม่มีฟิลด์ทรัพยากรของยานพาหนะที่ต้องระบุ
• ช่องที่ไม่บังคับ ทั้ง 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

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

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

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