เมื่อใช้การแชร์เส้นทางของ Fleet Engine สำหรับการเดินทางแบบออนดีมานด์ ผู้บริโภค สามารถติดตามความคืบหน้าของคำสั่งซื้อ การโดยสาร หรือบริการอื่นๆ ที่คุณมอบให้
การแชร์การเดินทางคืออะไร
การแชร์เส้นทางการท่องเว็บเป็นฟีเจอร์ของ Fleet Engine สำหรับการโดยสารแบบออนดีมานด์ ซึ่งใช้สำหรับ SDK สำหรับผู้บริโภค มีอินเทอร์เฟซที่จำลองข้อมูลการเดินทางและติดตามการเดินทาง ใน Fleet Engine และมีคลาสที่คุณใช้ในการสร้าง การแสดงผลแบบแผนที่สำหรับข้อมูลการเดินทางแก่ผู้ใช้ผู้บริโภค คุณผสานรวม SDK ลงในแอปและตั้งค่าโปรไฟล์บทบาทที่เหมาะสมภายใน Fleet Engine เป็น รองรับการใช้งานการแชร์เส้นทางของผู้บริโภค
การแชร์เส้นทางมี API เฉพาะแพลตฟอร์ม คุณจึงสร้างเส้นทางได้ เข้าสู่แอปพลิเคชันของคุณได้ทันที Consumer SDK มีให้บริการสำหรับ แพลตฟอร์มต่อไปนี้
เหตุผลที่ควรใช้การแชร์การเดินทาง
เมื่อผสานรวมการแชร์เส้นทางเข้ากับแอปพลิเคชันการเดินทางแบบออนดีมานด์ ด้วยระบบการตรวจสอบพาหนะที่ครอบคลุมด้วยระบบเกือบเรียลไทม์ การอัปเดตตำแหน่งและตำแหน่งของถนน บัญชี ผู้บริโภคสามารถดูเส้นทางของยานพาหนะซ้อนทับอยู่บนแผนที่ รวมทั้ง รายละเอียดความคืบหน้าที่ช่วยให้เข้าใจว่าการเดินทางหรือการจัดส่งอยู่ที่ไหน
คุณใช้การแชร์การเดินทางทำอะไรได้บ้าง
คุณใช้ข้อมูลจาก Driver SDK และ Fleet Engine เพื่อสร้างริชมีเดียได้ มุมมอง SDK อุปกรณ์เคลื่อนที่และการตอบกลับของบริการเว็บที่มีฟีเจอร์ต่อไปนี้
แสดงการปรับแต่ง UI แผนที่ให้เหมาะกับความต้องการในการสร้างแบรนด์ของคุณ
ตำแหน่งปัจจุบันของรถขณะที่ขับตามเส้นทาง โดย จะมีการอัปเดตตำแหน่งเป็นระยะๆ
เวลาถึงโดยประมาณ (ETA) สําหรับสถานที่รับและส่ง
ระยะทางที่เหลือ
ข้อมูลการจราจรสดบนเส้นทาง
วิธีการทำงานของการแชร์เส้นทาง
ในระดับสูง การแชร์การเดินทางจะใช้กลไกต่อไปนี้
- บทบาทของผู้ใช้ Fleet Engine ที่เหมาะสมเพื่อให้ผู้ใช้แอปที่ผ่านการตรวจสอบสิทธิ์ทำได้ จะดึงข้อมูลการเดินทางที่เชื่อมโยงกับคำสั่งซื้อของตน
- การเชื่อมโยงระหว่างผู้บริโภคกับการเดินทาง โดย ระบบแบ็กเอนด์
- คลาส SDK สำหรับผู้บริโภค
TripModelและJourneySharingSessionซึ่งเป็นคลาส SDK ที่ สร้างแบบจำลองข้อมูลการเดินทางและแชร์เซสชันการเดินทางในแอปสำหรับผู้บริโภค
นอกจากนี้ Consumer SDK ยังมีอินเทอร์เฟซและคลาสอื่นๆ เพื่อให้คุณสามารถ เพื่อสร้างการแมปอินเทอร์เฟซผู้ใช้สำหรับแอป เพื่อให้ผู้บริโภค ประสบการณ์การใช้งานแอปที่สมบูรณ์พร้อมด้วยรายละเอียดต่างๆ เช่น การจราจร เครื่องหมายบนแผนที่ เวลาถึงโดยประมาณ และ ข้อมูลเส้นทาง
ตารางนี้แสดงเส้นทางของเส้นทางที่แชร์
| 1 | แอปของผู้บริโภคส่งคำขอการเดินทาง | เซิร์ฟเวอร์แบ็กเอนด์ของคุณได้รับคำขอการเดินทางแบบออนดีมานด์และ
ดังต่อไปนี้:
|
| 2 | คนขับยอมรับการเดินทาง | แอปคนขับจะได้รับรหัสการเดินทางและข้อมูลการเดินทาง รวมถึงคนขับ ยอมรับการเดินทาง |
| 3 | แอปผู้บริโภคขอสิทธิ์เข้าถึงเส้นทางการใช้งาน | แอปสำหรับผู้บริโภคจะได้รับรหัสการเดินทางจากแบ็กเอนด์ของคุณและ คำขอเริ่มการแชร์เส้นทาง |
| 4 | คนขับเริ่มการเดินทาง | เมื่อคนขับใช้แอปคนขับเพื่อระบุว่าการเดินทางนั้นถึง เริ่มทำงานแล้ว แอปจะแจ้งเซิร์ฟเวอร์แบ็กเอนด์ผ่าน Driver SDK ตัวอย่างเช่น เมื่อคนขับคือ กำลังจะออกจากร้านอาหารหรือขับรถไปยังจุดรับ |
| 5 | Fleet Engine เริ่มแชร์การเดินทาง | Fleet Engine เริ่มติดตามเส้นทางและการแชร์ ความคืบหน้าด้วยแอปสำหรับผู้บริโภค |
| 6 | แอปผู้บริโภคแสดงเส้นทาง | แอปสำหรับผู้บริโภคจะแจ้งให้ผู้บริโภคทราบและเริ่มแสดง การเดินทางไปหาพวกเขา และอัปเดตเส้นทางที่กำลังดำเนินไป |
| 7 | การเดินทางเสร็จสมบูรณ์หรือยกเลิก | เมื่อคนขับยกเลิกหรือเดินทางจนครบ แอปไดรเวอร์จะปิดใช้การติดตามตำแหน่ง และเซิร์ฟเวอร์แบ็กเอนด์ของคุณ บอกให้ Fleet Engine ทำเครื่องหมายการเดินทางว่ายกเลิกหรือสิ้นสุดแล้ว |
| 8 | แอปสำหรับผู้บริโภคหยุดแชร์เส้นทาง | การเดินทางแสดงเป็นยกเลิกหรือเสร็จสมบูรณ์แล้ว |
| 9 | ระบบจะดำเนินการซ้ำสำหรับการเดินทางถัดไป | ระบบจะสร้างการเดินทางใหม่และกระบวนการนี้จะเกิดซ้ำ |
วิธีใช้การแชร์การเดินทาง
เลือกแพลตฟอร์มเพื่อดูวิธีเริ่มต้นแชร์เส้นทาง
Android
| 1 | ตั้งค่า SDK ของผู้บริโภคใน Android | โปรดตั้งค่า Consumer SDK เพื่อแชร์เส้นทางการเดินทางแบบออนดีมานด์ในแอป โปรดดูข้อมูลเพิ่มเติมในดาวน์โหลด Android Consumer SDK |
| 2 | ตั้งค่าอินเทอร์เฟซภาพของการแชร์เส้นทาง | กำหนดแผนที่และเพิ่มการสนับสนุนแผนที่เวกเตอร์เพื่อตั้งค่าอินเทอร์เฟซของการเดินทางของคุณ ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าแผนที่ |
| 3 | แชร์การเดินทาง | ติดตามการเดินทางเพื่อแชร์ตำแหน่งของยานพาหนะที่เหมาะสมกับผู้บริโภค ดูข้อมูลเพิ่มเติมได้ที่ติดตามการเดินทาง |
| 5 | อัปเดตความคืบหน้าของเส้นทางและจัดการข้อผิดพลาดในการเดินทาง | อัปเดตรายละเอียดเกี่ยวกับการเดินทาง เช่น ระยะทางและเวลาถึงโดยประมาณ และแก้ไขข้อผิดพลาดระหว่างการเดินทางดังกล่าว สำหรับข้อมูลเพิ่มเติม โปรดดู อัปเดตความคืบหน้าของการเดินทาง และ จัดการข้อผิดพลาดในการเดินทาง |
| 5 | เมื่อเส้นทางเสร็จแล้ว ให้หยุดแชร์ | หยุดติดตามการเดินทางเพื่อหยุดการแชร์ตำแหน่งของยานพาหนะกับผู้บริโภค ดูข้อมูลเพิ่มเติมได้ที่หยุดติดตามการเดินทาง |
iOS
| 1 | ตั้งค่า SDK ของผู้บริโภคใน iOS | โปรดตั้งค่า Consumer SDK เพื่อแชร์เส้นทางการเดินทางแบบออนดีมานด์ในแอป โปรดดูข้อมูลเพิ่มเติมในดาวน์โหลด iOS Consumer SDK |
| 2 | ตั้งค่าอินเทอร์เฟซภาพของการแชร์เส้นทาง | เริ่มต้นมุมมองแผนที่และจัดการเหตุการณ์บนแผนที่เพื่อตั้งค่าอินเทอร์เฟซของการเดินทางของคุณ ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าแผนที่ |
| 3 | แชร์การเดินทาง | ติดตามการเดินทางเพื่อแชร์ตำแหน่งของยานพาหนะที่เหมาะสมกับผู้บริโภค ดูข้อมูลเพิ่มเติมได้ที่ติดตามการเดินทาง |
| 5 | อัปเดตความคืบหน้าของเส้นทางและจัดการข้อผิดพลาดในการเดินทาง | อัปเดตรายละเอียดเกี่ยวกับการเดินทาง เช่น ระยะทางและเวลาถึงโดยประมาณ และแก้ไขข้อผิดพลาดระหว่างการเดินทางดังกล่าว สำหรับข้อมูลเพิ่มเติม โปรดดู อัปเดตความคืบหน้าของการเดินทาง และ จัดการข้อผิดพลาดในการเดินทาง |
| 5 | เมื่อเส้นทางเสร็จแล้ว ให้หยุดแชร์ | หยุดติดตามการเดินทางเพื่อหยุดแชร์ตำแหน่งของยานพาหนะกับผู้บริโภค โปรดดูข้อมูลเพิ่มเติมที่หัวข้อหยุดติดตามการเดินทาง |
JavaScript
| 1 | ตั้งค่าการแชร์เส้นทางการท่องเว็บใน JavaScript | โปรดตั้งค่า Consumer SDK เพื่อแชร์เส้นทางการเดินทางแบบออนดีมานด์ในแอป ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่า JavaScript Consumer SDK |
| 2 | โหลดและปรับแต่งแผนที่การแชร์การเดินทาง | เปิดใช้ Maps JavaScript API และตั้งค่าการให้สิทธิ์เพื่อตั้งค่าอินเทอร์เฟซของการเดินทาง ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าแผนที่ |
| 3 | แชร์การเดินทาง | ติดตามการเดินทางเพื่อแชร์ตำแหน่งของยานพาหนะที่เหมาะสมกับผู้บริโภค ดูข้อมูลเพิ่มเติมได้ที่ติดตามการเดินทาง |
| 5 | อัปเดตความคืบหน้าของเส้นทางและจัดการข้อผิดพลาดในการเดินทาง | อัปเดตรายละเอียดเกี่ยวกับการเดินทาง เช่น ระยะทางและเวลาถึงโดยประมาณ และแก้ไขข้อผิดพลาดระหว่างการเดินทางดังกล่าว สำหรับข้อมูลเพิ่มเติม โปรดดู อัปเดตและติดตามความคืบหน้าของการเดินทาง และ จัดการข้อผิดพลาดในการเดินทาง |
| 5 | เมื่อเส้นทางเสร็จแล้ว ให้หยุดแชร์ | หยุดติดตามการเดินทางเพื่อหยุดการแชร์ตำแหน่งของยานพาหนะกับผู้บริโภค โปรดดูข้อมูลเพิ่มเติมที่หัวข้อหยุดแชร์เส้นทาง |
คอมโพเนนต์
ส่วนนี้จะสรุปองค์ประกอบสำคัญ 2 อย่างของการแชร์เส้นทาง ดังนี้
หรือคุณจะปรับแต่งประสบการณ์การแชร์การเดินทางด้วยก็ได้ คอมโพเนนต์
ตัวดึงข้อมูลโทเค็นการตรวจสอบสิทธิ์
ในการควบคุมการเข้าถึงข้อมูลตำแหน่งที่จัดเก็บไว้ใน Fleet Engine คุณต้องดำเนินการต่อไปนี้ ดังต่อไปนี้:
ใช้บริการสร้าง JSON Web Token (JWT) สำหรับ Fleet Engine บนเซิร์ฟเวอร์ของคุณ
ใช้ตัวดึงข้อมูลโทเค็นการตรวจสอบสิทธิ์ในเว็บหรือแอปบนอุปกรณ์เคลื่อนที่ เพื่อตรวจสอบสิทธิ์การเข้าถึงข้อมูลตำแหน่ง
สำหรับ ข้อมูลเพิ่มเติมโปรดดูคู่มือการตั้งค่าสำหรับ Android iOS หรือ JavaScript
มุมมองแผนที่และเครื่องมือติดตามการเดินทาง
การแชร์เส้นทางมีคอมโพเนนต์สำหรับการแสดงข้อมูลผ่านภาพ ของยานพาหนะและจุดอ้างอิง รวมถึงฟีดข้อมูลดิบสำหรับ ETA ของผู้ขับ หรือระยะทางที่เหลือในการขับรถ
ตารางต่อไปนี้จะอธิบายองค์ประกอบเหล่านี้
| ส่วนประกอบ | คำอธิบาย |
|---|---|
| มุมมองแผนที่สำหรับเส้นทางการแชร์ | มุมมองแผนที่จะจัดการวงจรของการเดินทาง แสดงจุดอ้างอิง สำหรับตำแหน่งของยานพาหนะในระหว่างการเดินทาง หากทราบเส้นทางสำหรับยานพาหนะ มุมมองแผนที่จะอัปเดตเส้นทางของยานพาหนะ เส้นประกอบเพื่อแสดงความคืบหน้าของยานพาหนะตามเส้นทาง |
| ผู้ให้บริการตำแหน่งการเดินทางใน JavaScript | สําหรับเว็บแอป JavaScript ผู้ให้บริการตําแหน่งจะฟีดตำแหน่ง
ของออบเจ็กต์ที่ติดตามลงในแผนที่เส้นทางที่แชร์ สำหรับข้อมูลเพิ่มเติม
ดูข้อมูลได้ที่
สร้างอินสแตนซ์ผู้ให้บริการสถานที่เดินทางขึ้นมา
คุณสามารถใช้ผู้ให้บริการสถานที่เดินทางเพื่อติดตามรายละเอียดต่อไปนี้สำหรับ
การเดินทาง:
|
ออบเจ็กต์ตำแหน่งที่ติดตาม
ผู้ให้บริการตำแหน่งจะติดตามตำแหน่งของวัตถุ เช่น จุดอ้างอิงและ ยานพาหนะ ตามที่อธิบายไว้ในตารางต่อไปนี้
| ตำแหน่งที่ติดตาม | คำอธิบาย |
|---|---|
| สถานที่รับรถ | สถานที่รับคือจุดเริ่มต้นของการเดินทาง เครื่องหมาย สถานที่รับสินค้า |
| ตำแหน่งปลายทาง | สถานที่จุดหมายคือสถานที่ที่การเดินทางสิ้นสุด ซึ่งจะระบุจุดส่ง |
| ตำแหน่งจุดอ้างอิง | ตำแหน่งจุดอ้างอิงคือตำแหน่งระดับกลางตามเส้นทางของ การเดินทางที่ติดตาม แม้ในทางเทคนิคแล้ว จุดอ้างอิงอาจรวมถึง ตำแหน่งรับและส่ง จุดอ้างอิงมักหมายถึงระดับกลาง จุดแวะพักที่อยู่ในเส้นทาง เช่น จุดแวะพักระหว่างจุดรับและจุดหมาย ตำแหน่งบนเส้นทางการนำส่งคือตำแหน่งจุดอ้างอิง สำหรับข้อมูลเพิ่มเติม โปรดดู จุดอ้างอิงสำหรับการเดินทาง ในเอกสารประกอบของ Fleet Engine |
| ตำแหน่งของรถ | ตําแหน่งของยานพาหนะคือตําแหน่งที่รายงานของยานพาหนะ สำหรับข้อมูลเพิ่มเติม โปรดดูข้อมูลที่หัวข้อตำแหน่งของยานพาหนะ ในเอกสารประกอบของ Fleet Engine |
จัดรูปแบบแผนที่
รูปแบบเครื่องหมายและเส้นประกอบจะกำหนดรูปลักษณ์ขององค์ประกอบ ติดตามตำแหน่งบนแผนที่ คุณสามารถใช้ ตัวเลือกการจัดรูปแบบที่กำหนดเองเพื่อเปลี่ยนการจัดรูปแบบเริ่มต้นให้ตรงกับรูปแบบ ของเว็บแอปพลิเคชัน
ควบคุมการแสดงสถานที่ที่ติดตาม
ผู้ให้บริการตำแหน่งที่กำหนดไว้ล่วงหน้าใน Fleet Engine จะปฏิบัติตามกฎระดับการเข้าถึงเหล่านี้ สำหรับออบเจ็กต์สถานที่ที่ติดตามบนแผนที่ หากคุณสร้าง URL ที่กำหนดเองหรือ ผู้ให้บริการตำแหน่ง คุณสามารถแก้ไขกฎการเปิดเผยได้
มองเห็นยานพาหนะได้เฉพาะในระหว่างการเดินทางเท่านั้น: การเดินทาง จะเห็นรถที่ใช้ร่วมกัน ตั้งแต่เวลาที่มอบหมายให้กับการเดินทางไปยัง เวลาที่ต้องส่งคืน หากการเดินทางถูกยกเลิก ยานพาหนะจะแสดงให้เห็นนานขึ้น
เครื่องหมายตำแหน่งอื่นๆ ทั้งหมดจะแสดงเสมอ: เครื่องหมายตำแหน่งอื่นๆ ทั้งหมด สำหรับต้นทาง จุดหมาย และจุดอ้างอิงจะแสดงบนแผนที่เสมอ สำหรับ เช่น การแชร์เส้นทางการส่งไปยังจุดรับหรือการนำส่งสำหรับการจัดส่ง ตำแหน่งจะแสดงบนแผนที่เสมอ ไม่ว่าสถานะใด หรือการจัดส่ง
ขั้นตอนถัดไป
โปรดดูเอกสารประกอบสำหรับแพลตฟอร์มที่คุณต้องการแชร์เส้นทาง ดังนี้