ข้อมูลอ้างอิงฉบับย่อเกี่ยวกับ Consumer SDK สำหรับ JavaScript

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

SDK สำหรับผู้บริโภคใน JavaScript: ข้อมูลสำคัญ

  • ผลิตภัณฑ์: JavaScript Consumer SDK
  • หรือที่เรียกว่า Consumer SDK สำหรับ JavaScript, JavaScript สำหรับการเดินทางแบบออนดีมานด์ของบริการด้านการสัญจร, JavaScript SDK
  • หมวดหมู่: เส้นทาง
  • แพลตฟอร์ม: JavaScript (เบราว์เซอร์)
  • ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวม Consumer SDK ของ JavaScript

SDK ของผู้บริโภคสําหรับ JavaScript: กรณีที่ควรใช้

ใช้ Consumer SDK ของ JavaScript เมื่อ

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

อย่าใช้ Consumer SDK ของ JavaScript ในกรณีต่อไปนี้

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

JavaScript Consumer SDK: การตั้งค่า

JavaScript Consumer SDK: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: หากคุณไม่กำหนดวิวพอร์ตเริ่มต้น (ศูนย์กลางและการซูม) ให้กับแผนที่ JourneySharingMapView เหตุการณ์ 'ready' ของแผนที่อาจไม่เริ่มทำงาน วิธีแก้ไข: เรียกใช้ mapView.map.setCenter(...) และ mapView.map.setZoom(...) หลังจากสร้างมุมมองแผนที่ ดู /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey
  • ปัญหา: ข้อผิดพลาดจากคำขอข้อมูลการเดินทางแบบอะซิงโครนัสไม่แสดงขึ้นมา โดยจะมาถึงในรูปแบบเหตุการณ์ 'error' ในผู้ให้บริการตำแหน่งเท่านั้น คุณจึงจะไม่สังเกตเห็นเว้นแต่จะเพิ่ม Listener วิธีแก้ไข: เพิ่ม locationProvider.addListener('error', ...) และรวมการเรียกใช้ไลบรารีไว้ในบล็อก try...catch ดู /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey
  • ปัญหา: คลาส google.maps.journeySharing จะไม่พร้อมใช้งานเว้นแต่คุณจะโหลดไลบรารี journeySharing วิธีแก้ไข: เพิ่ม libraries=journeySharing ลงใน URL ของสคริปต์ Maps JavaScript API หรือโหลดคลาสด้วย await google.maps.importLibrary("journeySharing") ดู /maps/documentation/mobility/journey-sharing/on-demand/javascript/share-journey
  • ปัญหา: การเรียก Fleet Engine จากเบราว์เซอร์ (สภาพแวดล้อมที่มีความน่าเชื่อถือต่ำ) ต้องใช้ JWT ที่เซิร์ฟเวอร์แบ็กเอนด์ออกให้ คีย์ API เพียงอย่างเดียวไม่ให้สิทธิ์เข้าถึงข้อมูลการเดินทาง วิธีแก้ไข: ออก JWT จากแบ็กเอนด์และระบุ authTokenFetcher ที่แสดงผลโทเค็นและ expiresInSeconds ดู /maps/documentation/mobility/journey-sharing/on-demand/javascript/setup

JavaScript Consumer SDK: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว

  • ตัวเลือกการตั้งค่าเครื่องหมายและเส้นประกอบ JourneySharingMapView และ JourneySharingMapViewOptions (vehicleMarkerSetup, originMarkerSetup, destinationMarkerSetup, waypointMarkerSetup, anticipatedRoutePolylineSetup, takenRoutePolylineSetup และอื่นๆ): เลิกใช้งานแล้ว การแทนที่: ตัวเลือก MarkerCustomizationFunction และ PolylineCustomizationFunction ในผู้ให้บริการตำแหน่ง (เช่น vehicleMarkerCustomization) อาการ: มีกำหนดนำออกในรุ่นต่อๆ ไป ดูคำแนะนำในการย้ายข้อมูล
  • JourneySharingMapView.locationProvider และ JourneySharingMapViewOptions.locationProvider: เลิกใช้งานแล้ว การเปลี่ยนทดแทน: JourneySharingMapView.locationProviders และ JourneySharingMapViewOptions.locationProviders
  • พร็อพเพอร์ตี้รายการเครื่องหมายและเส้นประกอบ JourneySharingMapView (vehicleMarkers, originMarkers, destinationMarkers, waypointMarkers, anticipatedRoutePolylines, takenRoutePolylines และพร็อพเพอร์ตี้เครื่องหมายงาน): เลิกใช้งานแล้ว การแทนที่: MarkerCustomizationFunction และ PolylineCustomizationFunction Callback ในผู้ให้บริการตำแหน่ง ดูคำแนะนำในการย้ายข้อมูล

สิ่งที่คุณทำได้ด้วย Consumer SDK ของ JavaScript

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