ภาพรวมสำหรับแชร์เส้นทางสำหรับการเดินทางแบบออนดีมานด์

เมื่อใช้การแชร์เส้นทางของ 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 แอปของผู้บริโภคส่งคำขอการเดินทาง เซิร์ฟเวอร์แบ็กเอนด์ของคุณได้รับคำขอการเดินทางแบบออนดีมานด์และ ดังต่อไปนี้:
  • สร้างการเดินทางใน Fleet Engine
  • กำหนดการเดินทางไปยังยานพาหนะใน Fleet Engine
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 คุณต้องดำเนินการต่อไปนี้ ดังต่อไปนี้:

  1. ใช้บริการสร้าง JSON Web Token (JWT) สำหรับ Fleet Engine บนเซิร์ฟเวอร์ของคุณ

  2. ใช้ตัวดึงข้อมูลโทเค็นการตรวจสอบสิทธิ์ในเว็บหรือแอปบนอุปกรณ์เคลื่อนที่ เพื่อตรวจสอบสิทธิ์การเข้าถึงข้อมูลตำแหน่ง

สำหรับ ข้อมูลเพิ่มเติมโปรดดูคู่มือการตั้งค่าสำหรับ Android iOS หรือ JavaScript

มุมมองแผนที่และเครื่องมือติดตามการเดินทาง

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

ตารางต่อไปนี้จะอธิบายองค์ประกอบเหล่านี้

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

ออบเจ็กต์ตำแหน่งที่ติดตาม

ผู้ให้บริการตำแหน่งจะติดตามตำแหน่งของวัตถุ เช่น จุดอ้างอิงและ ยานพาหนะ ตามที่อธิบายไว้ในตารางต่อไปนี้

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

จัดรูปแบบแผนที่

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

ควบคุมการแสดงสถานที่ที่ติดตาม

ผู้ให้บริการตำแหน่งที่กำหนดไว้ล่วงหน้าใน Fleet Engine จะปฏิบัติตามกฎระดับการเข้าถึงเหล่านี้ สำหรับออบเจ็กต์สถานที่ที่ติดตามบนแผนที่ หากคุณสร้าง URL ที่กำหนดเองหรือ ผู้ให้บริการตำแหน่ง คุณสามารถแก้ไขกฎการเปิดเผยได้

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

  • เครื่องหมายตำแหน่งอื่นๆ ทั้งหมดจะแสดงเสมอ: เครื่องหมายตำแหน่งอื่นๆ ทั้งหมด สำหรับต้นทาง จุดหมาย และจุดอ้างอิงจะแสดงบนแผนที่เสมอ สำหรับ เช่น การแชร์เส้นทางการส่งไปยังจุดรับหรือการนำส่งสำหรับการจัดส่ง ตำแหน่งจะแสดงบนแผนที่เสมอ ไม่ว่าสถานะใด หรือการจัดส่ง

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

โปรดดูเอกสารประกอบสำหรับแพลตฟอร์มที่คุณต้องการแชร์เส้นทาง ดังนี้