ภาพรวมการเดินทางตามคำขอของ SDK ของผู้บริโภค

ปรับแต่งประสบการณ์ของผู้บริโภคสำหรับการเดินทางแบบออนดีมานด์โดยอนุญาตให้ผู้บริโภค ติดตามการเดินทางสำหรับคำสั่งซื้อ การเดินทาง หรือบริการอื่นๆ ที่คุณมอบให้

แอปสำหรับผู้บริโภค หลังจากสิ้นสุดการเดินทาง

Consumer SDK คืออะไร

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

API เฉพาะแพลตฟอร์มของ Consumer SDK ช่วยให้คุณสร้างความสามารถ ในการแชร์การเดินทางในแอปพลิเคชันของคุณได้โดยตรง SDK สำหรับผู้บริโภคพร้อมให้บริการ สำหรับแพลตฟอร์มต่อไปนี้

เหตุผลที่ควรใช้ Consumer SDK

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

คุณใช้ Consumer SDK ทำอะไรได้บ้าง

คุณสามารถใช้ข้อมูลจาก Driver SDK และ Fleet Engine เพื่อสร้าง ประสบการณ์การใช้งานที่ปรับแต่งแล้วสำหรับผู้บริโภค ซึ่งรวมถึงฟีเจอร์ต่อไปนี้

  • ปรับแต่ง UI ของแผนที่ให้เหมาะกับความต้องการด้านการสร้างแบรนด์

  • ติดตามตำแหน่งปัจจุบันของยานพาหนะขณะที่เคลื่อนที่ไปตามเส้นทาง โดยระบบจะอัปเดตตำแหน่งเป็นระยะ

  • แสดงเวลาถึงโดยประมาณ (ETA) สำหรับสถานที่รับและส่ง

  • แสดงระยะทางที่เหลือ

  • แสดงสภาพการจราจรแบบเรียลไทม์บนเส้นทาง

วิธีการทำงานของ Consumer SDK

ในระดับสูง SDK สำหรับผู้บริโภคจะอาศัยกลไกต่อไปนี้

  • มีบทบาท Fleet Engine ที่เหมาะสมเพื่อให้แอปที่ผ่านการตรวจสอบสิทธิ์สามารถ ติดตามการเดินทางที่เชื่อมโยงกับคำสั่งซื้อของผู้บริโภค
  • ความสัมพันธ์ระหว่างผู้บริโภคกับการเดินทางที่ระบบแบ็กเอนด์ของคุณระบุ
  • คลาส TripModel และ JourneySharingSession SDK ที่จำลองข้อมูลการเดินทาง และแชร์เซสชันการเดินทางในแอปสำหรับผู้บริโภค

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

วิธีการทำงานของ Consumer SDK

ตารางนี้แสดงขั้นตอนการเดินทางที่แอปสำหรับผู้บริโภคทำตาม

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

  1. ใช้บริการสร้าง JSON Web Token (JWT) สำหรับ Fleet Engine ในเซิร์ฟเวอร์ ดูข้อมูลเพิ่มเติมได้ที่ออก JWT

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

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

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

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

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

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

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

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

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

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

ควบคุมระดับการเข้าถึงตำแหน่งที่ติดตาม

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

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

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

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

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