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