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

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

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

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

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

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