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: การตั้งค่า
- การตรวจสอบสิทธิ์: คีย์ API, JSON Web Token (JWT)
- เปิดใช้ด้วย: Maps JavaScript API, บริการ Fleet Engine
- การระบุแหล่งที่มาของการใช้งาน: รหัสธุรกรรม Mobility (เบต้า) ที่ไม่บังคับ: ตั้งค่า
google.maps.Settings.getInstance().experienceIdsเป็นอาร์เรย์ของรหัสธุรกรรม Mobility (หรือรหัสที่เกี่ยวข้อง) ก่อนสร้างJourneySharingMapViewexperienceIdsพร้อมใช้งานในแชแนลv=betaของ Maps JavaScript API เท่านั้น - เริ่มต้นใช้งาน: ตั้งค่า Consumer SDK ของ JavaScript
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Consumer SDK ของ JavaScript
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Consumer SDK สำหรับ JavaScript
JavaScript Consumer SDK: สินค้าที่เกี่ยวข้อง
- มักใช้ร่วมกับ: บริการ Fleet Engine, Maps JavaScript API, Driver SDK สำหรับ Android, Driver SDK สำหรับ iOS
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และPolylineCustomizationFunctionCallback ในผู้ให้บริการตำแหน่ง ดูคำแนะนำในการย้ายข้อมูล
สิ่งที่คุณทำได้ด้วย Consumer SDK ของ JavaScript
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
- เพิ่มเส้นประกอบของเส้นทางที่ติดตามการเดินทางจาก Fleet Engine ไปยังแผนที่ในหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่
- อัปเดตความคืบหน้าของการเดินทางตามเส้นทางในแผนที่บนหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่สำหรับการเดินทางของ Fleet Engine
- เปลี่ยนรูปแบบของถนน เส้นประกอบ และรูปหลายเหลี่ยมในแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- แสดงหรือซ่อนองค์ประกอบในแผนที่ซึ่งติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- เปลี่ยนรูปแบบของไอคอนและป้ายกำกับข้อความบนแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- ใช้รูปแบบแผนที่ที่แตกต่างกันกับระดับการซูมที่แตกต่างกันในแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- เปลี่ยนความหนาแน่นของสถานที่บนแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine เวอร์ชันทดลอง หมายเหตุ: การรองรับการจัดรูปแบบแผนที่ในระบบคลาวด์ใน Consumer SDK เป็นเวอร์ชัน GA ส่วนการควบคุมความหนาแน่นของจุดที่น่าสนใจเป็นฟีเจอร์การจัดรูปแบบแผนที่ในระบบคลาวด์เวอร์ชันทดลอง (รองรับเฉพาะรูปแบบแผนที่แบบสว่างเท่านั้น)
- เปลี่ยนรูปแบบของอาคารในแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine เวอร์ชันทดลอง หมายเหตุ: การรองรับการจัดรูปแบบแผนที่ในระบบคลาวด์ใน Consumer SDK เป็นเวอร์ชัน GA ส่วนการปรับแต่งรูปแบบอาคาร 3 มิติและพื้นที่ทำงานเป็นฟีเจอร์การจัดรูปแบบแผนที่ในระบบคลาวด์เวอร์ชันทดลอง (รองรับเฉพาะรูปแบบแผนที่แบบ Light เท่านั้น)
- เปลี่ยนรูปแบบของจุดสังเกตบนแผนที่ที่ติดตามความคืบหน้าของการเดินทางจาก Fleet Engine เวอร์ชันทดลอง หมายเหตุ: การรองรับการจัดรูปแบบแผนที่ในระบบคลาวด์ใน Consumer SDK เป็นเวอร์ชัน GA ส่วนการปรับแต่งไอคอนจุดสังเกตเป็นฟีเจอร์การจัดรูปแบบแผนที่ในระบบคลาวด์เวอร์ชันทดลอง (รองรับเฉพาะรูปแบบแผนที่แบบสว่างเท่านั้น)
- ปรับแต่งเครื่องหมายบนแผนที่ซึ่งติดตามความคืบหน้าของการเดินทางจาก Fleet Engine
- ปรับแต่งเส้นประกอบของเส้นทางบนแผนที่ซึ่งติดตามความคืบหน้าของการเดินทางจาก Fleet Engine