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

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

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

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

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