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