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