เอกสารนี้ครอบคลุมวิธีปรับแต่งรูปลักษณ์ของแผนที่ รวมถึงควบคุมระดับการเข้าถึงข้อมูลและตัวเลือก Viewport โดยคุณสามารถทำได้ดังนี้
- ใช้การจัดรูปแบบแผนที่ในระบบคลาวด์
- ตั้งค่าตัวเลือกรูปแบบแผนที่ในโค้ดของคุณเองโดยตรง
จัดรูปแบบแผนที่ด้วยการจัดรูปแบบแผนที่ในระบบคลาวด์
หากต้องการใช้รูปแบบแผนที่กับแผนที่การแชร์การเดินทางของผู้ใช้ JavaScript ให้ระบุ
mapIdและ
อื่นๆ
mapOptions
เมื่อสร้าง JourneySharingMapView
ตัวอย่างต่อไปนี้แสดงวิธีใช้รูปแบบแผนที่ด้วยรหัสแผนที่
JavaScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
mapId: 'YOUR_MAP_ID'
}
// Any other styling options.
});
TypeScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
mapId: 'YOUR_MAP_ID'
}
// Any other styling options.
});
จัดรูปแบบแผนที่ในโค้ดของคุณเองโดยตรง
นอกจากนี้ คุณยังปรับแต่งการจัดรูปแบบแผนที่ได้ด้วยการตั้งค่าตัวเลือกแผนที่เมื่อสร้าง JourneySharingMapView ตัวอย่างต่อไปนี้แสดงวิธีจัดรูปแบบแผนที่โดยใช้ตัวเลือกแผนที่ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวเลือกแผนที่ที่ตั้งค่าได้ที่
mapOptions
ในเอกสารอ้างอิง Maps JavaScript API ของ Google Maps
JavaScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
styles: [
{
"featureType": "road.arterial",
"elementType": "geometry",
"stylers": [
{ "color": "#CCFFFF" }
]
}
]
}
});
TypeScript
const mapView = new google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
mapOptions: {
styles: [
{
"featureType": "road.arterial",
"elementType": "geometry",
"stylers": [
{ "color": "#CCFFFF" }
]
}
]
}
});
ควบคุมระดับการเข้าถึงข้อมูลงานของ SDK
คุณสามารถควบคุมการมองเห็นออบเจ็กต์งานบางรายการบนแผนที่ได้โดยใช้กฎการมองเห็น
ระดับการเข้าถึงเริ่มต้นของข้อมูลงาน
โดยค่าเริ่มต้น ข้อมูลของงานที่มอบหมายให้ยานพาหนะจะแสดงเมื่อยานพาหนะอยู่ห่างจากงานไม่เกิน 5 ป้าย ระดับการเข้าถึงจะสิ้นสุดลงเมื่อมีการทำงานเสร็จสมบูรณ์หรือยกเลิกงาน
ตารางนี้แสดงระดับการเข้าถึงเริ่มต้นสำหรับงานแต่ละประเภท คุณสามารถปรับแต่งระดับการเข้าถึงของงานหลายประเภท แต่ไม่ใช่ทั้งหมด ดูรายละเอียดเพิ่มเติมเกี่ยวกับประเภทงาน ได้ที่หัวข้อประเภทงานในคู่มืองานที่กำหนดเวลาไว้
| ประเภทงาน | ระดับการเข้าถึงเริ่มต้น | ปรับแต่งได้ไหม | คำอธิบาย |
|---|---|---|---|
| งานที่ยานพาหนะไม่พร้อมให้บริการ | ไม่แสดง | ไม่ได้ | ใช้สำหรับพักของคนขับและการเติมน้ำมัน หากเส้นทางไปยังงานจัดส่งมีป้ายหยุดยานพาหนะอื่นด้วย ระบบจะไม่แสดงป้ายหยุดนั้นหากมีเฉพาะงานที่ยานพาหนะไม่พร้อมให้บริการ ระบบจะยังคงแสดงเวลาถึงโดยประมาณ และเวลาเสร็จสมบูรณ์ของงานโดยประมาณสำหรับงานจัดส่ง เอง |
| งานยานพาหนะที่เปิดอยู่ | แสดง | ได้ | ระดับการเข้าถึงจะสิ้นสุดลงเมื่อมีการทำงานเสร็จสมบูรณ์หรือยกเลิกงาน คุณสามารถปรับแต่งระดับการเข้าถึงของงานยานพาหนะที่เปิดอยู่ได้ ดูหัวข้อ ปรับแต่งระดับการเข้าถึงของงานยานพาหนะที่เปิดอยู่ |
| งานยานพาหนะที่ปิดอยู่ | ไม่แสดง | ไม่ได้ | คุณปรับแต่งระดับการเข้าถึงของงานยานพาหนะที่ปิดอยู่ไม่ได้ |
ปรับแต่งระดับการเข้าถึงของงานยานพาหนะที่เปิดอยู่
อินเทอร์เฟซ TaskTrackingInfo มีองค์ประกอบข้อมูลงานจำนวนหนึ่ง
ที่สามารถแสดงได้ด้วย Consumer SDK
| องค์ประกอบข้อมูลงานที่ปรับแต่งได้ | |
|---|---|
|
เส้นประกอบเส้นทาง เวลาถึงโดยประมาณ เวลาเสร็จสมบูรณ์ของงานโดยประมาณ |
ระยะทางขับขี่ที่เหลือไปยังงาน จำนวนป้ายหยุดที่เหลือ ตำแหน่งของยานพาหนะ |
ตัวเลือกการมองเห็นต่องาน
คุณสามารถปรับแต่งการกำหนดค่าระดับการเข้าถึงต่องานได้โดยการตั้งค่า TaskTrackingViewConfig เมื่อสร้างหรืออัปเดตงานภายใน Fleet Engine ใช้ตัวเลือกระดับการเข้าถึงต่อไปนี้เพื่อสร้างเกณฑ์ในการกำหนดระดับการเข้าถึงขององค์ประกอบงาน
| ตัวเลือกระดับการเข้าถึง | ||
|---|---|---|
|
จำนวนป้ายหยุดที่เหลือ ระยะเวลาจนกว่าจะถึงเวลาถึงโดยประมาณ ระยะทางขับขี่ที่เหลือ |
แสดงเสมอ ไม่แสดง |
|
ตัวอย่างเช่น สมมติว่าการปรับแต่งตัวอย่างจะปรับระดับการมองเห็นสำหรับองค์ประกอบข้อมูล 3 รายการโดยใช้เกณฑ์ที่แสดงในตารางต่อไปนี้ องค์ประกอบอื่นๆ ทั้งหมดจะเป็นไปตามกฎระดับการเข้าถึงเริ่มต้น
| องค์ประกอบข้อมูลที่จะปรับ | การมองเห็น | เกณฑ์ |
|---|---|---|
| เส้นประกอบเส้นทาง | แสดง | ยานพาหนะอยู่ห่างไม่เกิน 3 ป้าย |
| เวลาถึงโดยประมาณ | แสดง | ระยะทางขับขี่ที่เหลือน้อยกว่า 5,000 เมตร |
| จำนวนป้ายหยุดที่เหลือ | ไม่แสดง | ยานพาหนะอยู่ห่างไม่เกิน 3 ป้าย |
ตัวอย่างต่อไปนี้แสดงการกำหนดค่านี้
"taskTrackingViewConfig": {
"routePolylinePointsVisibility": {
"remainingStopCountThreshold": 3
},
"estimatedArrivalTimeVisibility": {
"remainingDrivingDistanceMetersThreshold": 5000
},
"remainingStopCountVisibility": {
"never": true
}
}
กฎระดับการเข้าถึงของเส้นประกอบเส้นทางและตำแหน่งของยานพาหนะ
เส้นประกอบเส้นทางจะแสดงไม่ได้หากตำแหน่งของยานพาหนะไม่แสดงด้วย เนื่องจากตำแหน่งของยานพาหนะสามารถอนุมานได้จากจุดสิ้นสุดของเส้นประกอบ
หลักเกณฑ์เหล่านี้จะช่วยให้คุณระบุตัวเลือกระดับการเข้าถึงของเส้นประกอบเส้นทางและตำแหน่งของยานพาหนะร่วมกันได้อย่างถูกต้อง
| ตัวเลือกระดับการเข้าถึงเดียวกัน | เกณฑ์การมองเห็น | คำแนะนำ |
|---|---|---|
| ตัวเลือกเส้นประกอบเส้นทางตั้งค่าเป็นแสดงเสมอ | ตั้งค่าตำแหน่งของยานพาหนะเป็นแสดงเสมอ | |
| ตำแหน่งของยานพาหนะตั้งค่าเป็นไม่แสดง | ตั้งค่าเส้นประกอบเส้นทางเป็นไม่แสดง | |
ตัวเลือกระดับการเข้าถึงคือตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้
|
ตั้งค่าตัวเลือกเส้นประกอบเส้นทางเป็นค่าที่น้อยกว่าหรือเท่ากับค่าที่ตั้งไว้ สำหรับตำแหน่งของยานพาหนะ เช่น "taskTrackingViewConfig": {
"routePolylinePointsVisibility": {
"remainingStopCountThreshold": 3
},
"vehicleLocationVisibility": {
"remainingStopCountThreshold": 5
},
}
|
|
| ตัวเลือกระดับการเข้าถึงที่แตกต่างกัน | เกณฑ์การมองเห็น | คำแนะนำ |
| ตำแหน่งของยานพาหนะแสดงอยู่ | กรณีนี้จะเกิดขึ้นเมื่อตรงตามตัวเลือกระดับการเข้าถึงของตำแหน่งของยานพาหนะและ เส้นประกอบ เช่น "taskTrackingViewConfig": {
"routePolylinePointsVisibility": {
"remainingStopCountThreshold": 3
},
"vehicleLocationVisibility": {
"remainingDrivingDistanceMetersThreshold": 3000
},
}ในตัวอย่างนี้ ตำแหน่งของยานพาหนะจะแสดงก็ต่อเมื่อจำนวนป้ายหยุดที่เหลือมีอย่างน้อย 3 ป้ายและระยะทางขับขี่ที่เหลือมีอย่างน้อย 3, 000 เมตร |
ปิดใช้การปรับให้พอดีอัตโนมัติ
คุณสามารถหยุดไม่ให้แผนที่ปรับ Viewport ให้พอดีกับยานพาหนะและเส้นทางที่คาดการณ์ไว้โดยอัตโนมัติได้ด้วยการปิดใช้การปรับให้พอดีอัตโนมัติ ตัวอย่างต่อไปนี้แสดงวิธีปิดใช้การปรับให้พอดีอัตโนมัติเมื่อกำหนดค่ามุมมองแผนที่การแชร์การเดินทาง
JavaScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
automaticViewportMode:
google.maps.journeySharing
.AutomaticViewportMode.NONE,
...
});
TypeScript
const mapView = new
google.maps.journeySharing.JourneySharingMapView({
element: document.getElementById('map_canvas'),
locationProviders: [locationProvider],
automaticViewportMode:
google.maps.journeySharing
.AutomaticViewportMode.NONE,
...
});