يتناول هذا المستند كيفية تخصيص مظهر ومظهر المسارات للمركبات التي يتم تتبعها على الخريطة. يتم رسم المسارات على الخريطة باستخدام الخطوط المتعددة. لكل زوج من
الإحداثيات في مسار المركبة النشط أو المتبقّي، تنشئ المكتبة عنصر
google.maps.Polyline
.
يمكنك تصميم عناصر Polyline
من خلال تحديد تخصيصات الخطوط المتعددة التي تطبّقها المكتبة بعد ذلك في حالتَين:
- قبل إضافة الكائنات إلى الخريطة
- عند تغيير البيانات المستخدمة للكائنات
تصميم الخطوط المتعددة
مثلما يمكنك تخصيص العلامات، يمكنك توجيه الخطوط المتعددة بطرق مختلفة:
تنسيق الخطوط المتعددة للمسار حسب النوع: استخدِم
PolylineOptions
للتطبيق على جميع عناصرPolyline
المطابقة عند إنشائها أو تعديلها. للحصول على مثال، اطّلِع على تنسيق الخطوط المتعددة حسب النوع.خطوط متعددة لمسارات الأنماط استنادًا إلى البيانات: حدِّد وظيفة تخصيص استنادًا إلى البيانات الواردة من تتبُّع الأسطول أو من مصادر خارجية:
البيانات من تتبُّع الأسطول: تُرسِل ميزة تتبُّع الأسطول بيانات الخطوط المتعددة إلى دالة customisation، بما في ذلك بيانات حالة المركبة الحالية. ويمكنك تصميم الخطوط المتعددة استنادًا إلى هذه البيانات، بما في ذلك تلوين عنصر
Polyline
بلون أغمق أو جعله أكثر سمكًا عندما تتحرك السيارة بشكل أبطأ.المصادر الخارجية: يمكنك دمج بيانات تتبُّع الأسطول مع بيانات من مصادر خارج Fleet Engine وتنسيق عنصر
Polyline
استنادًا إلى تلك المعلومات.
للحصول على مثال، راجِع نمط الخطوط المتعددة استنادًا إلى البيانات.
التحكّم في مستوى رؤية الخطوط المتعددة للمسار: يمكنك إخفاء الخطوط المتعددة أو إظهارها باستخدام السمة
visible
. لمعرفة التفاصيل، يُرجى الاطّلاع على التحكّم في مستوى رؤية الخطوط المتعددة في هذا الدليل.عرض معلومات إضافية لمركبة أو علامة موقع جغرافي: يمكنك عرض معلومات إضافية باستخدام السمة
infowindow
. لمعرفة التفاصيل، يمكنك الاطّلاع على عرض معلومات إضافية حول مركبة أو علامة موقع جغرافي في هذا الدليل.
خيارات تخصيص الخطوط المتعددة
تتوفّر خيارات التخصيص التالية في كلٍّ من
FleetEngineVehicleLocationProviderOptions
وFleetEngineDeliveryVehicleLocationProviderOptions
.
يمكنك ضبط تخصيصات لحالات المسار المختلفة في
رحلة المركبة:
المسار الذي سبق أن سلكته: استخدِم
takenPolylineCustomization
- مرجع الرحلات عند الطلب، المهام المجدوَلة.مسار التنقّل النشط: استخدِم
activePolylineCustomization
- الرحلات عند الطلب، المهام المُجدوَلة.المسار الذي لم يتم السفر إليه بعد: استخدِم
remainingPolylineCustomization
، مرجع الرحلات عند الطلب، المهام المجدوَلة.
تصميم الخطوط المتعددة لمسار حسب النوع
لتنسيق الخطوط المتعددة حسب النوع، عليك تغيير نمط عناصر Polyline
باستخدام PolylineOptions
.
يوضّح المثال التالي كيفية ضبط نمط عنصر Polyline
باستخدام PolylineOptions
. اتّبِع هذا النمط لتخصيص تصميم أي عنصر
Polyline
باستخدام أي من تخصيصات الخطوط المتعددة للمسارات المدرَجة في
خيارات تخصيص الخطوط المتعددة في هذا الدليل.
مثال على الرحلات عند الطلب أو المهام المُجدوَلة
JavaScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
TypeScript
activePolylineCustomization = {
strokeWidth: 5,
strokeColor: 'black',
};
تحديد نمط الخطوط المتعددة لمسار باستخدام البيانات
لتنسيق الخطوط المتعددة للمسار باستخدام البيانات، غيِّر تنسيق عناصر Polyline
باستخدام دوال التخصيص.
يوضّح المثال التالي كيفية ضبط تنسيق مسار نشط باستخدام دالة تخصيص. اتّبِع هذا النمط لتخصيص تصميم أي عنصر Polyline
باستخدام أيٍّ من معلمات تخصيص الخطوط المتعددة المُدرَجة في خيارات تخصيص الخطوط المتعددة في هذا الدليل.
مثال على الرحلات عند الطلب
JavaScript
// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params) => {
const distance = params.vehicle.waypoints[0].distanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
TypeScript
// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params: VehiclePolylineCustomizationFunctionParams) => {
const distance = params.vehicle.waypoints[0].distanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
مثال على المهام المُجدوَلة
JavaScript
// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params) => {
const distance = params.deliveryVehicle.remainingDistanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
TypeScript
// Color the Polyline objects in green if the vehicle is nearby.
activePolylineCustomization =
(params: DeliveryVehiclePolylineCustomizationFunctionParams) => {
const distance = params.deliveryVehicle.remainingDistanceMeters;
if (distance < 1000) {
// params.polylines contains an ordered list of Polyline objects for
// the path.
for (const polylineObject of params.polylines) {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
مثال على تصميم الاستجابة لحركة المرور (الرحلات عند الطلب فقط)
يعرض Fleet Engine بيانات سرعة حركة المرور للمسارات النشطة والباقية للمركبة التي تتم متابعتها. يمكنك استخدام هذه المعلومات لتنسيق Polyline
العناصر وفقًا لسرعات حركة المرور:
JavaScript
// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
FleetEngineVehicleLocationProvider.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION;
// Or alter the objects further after the customization function has been
// run -- in this example, change the blue for normal to green:
activePolylineCustomization =
(params) => {
FleetEngineVehicleLocationProvider.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params);
for (const polylineObject of params.polylines) {
if (polylineObject.get('strokeColor') === '#05f') {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
TypeScript
// Color the Polyline objects according to their real-time traffic levels
// using '#05f' for normal, '#fa0' for slow, and '#f33' for traffic jam.
activePolylineCustomization =
FleetEngineVehicleLocationProvider.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION;
// Or alter the objects further after the customization function has been
// run -- in this example, change the blue for normal to green:
activePolylineCustomization =
(params: VehiclePolylineCustomizationFunctionParams) => {
FleetEngineVehicleLocationProvider.
TRAFFIC_AWARE_ACTIVE_POLYLINE_CUSTOMIZATION_FUNCTION(params);
for (const polylineObject of params.polylines) {
if (polylineObject.get('strokeColor') === '#05f') {
polylineObject.setOptions({strokeColor: 'green'});
}
}
};
التحكّم في مستوى ظهور الخطوط المتعددة
تكون جميع عناصر Polyline
مرئية تلقائيًا. ولجعل كائن Polyline
غير مرئي، اضبط السمة visible
على false
.
مثال على الرحلات عند الطلب أو المهام المُجدوَلة
JavaScript
remainingPolylineCustomization = {visible: false};
TypeScript
remainingPolylineCustomization = {visible: false};
عرض نافذة معلومات لمركبة أو علامة موقع جغرافي
يمكنك استخدام InfoWindow
لعرض معلومات إضافية عن
مركبة أو علامة موقع جغرافي.
يوضّح المثال التالي كيفية إنشاء InfoWindow
وإرفاقه بعلامة
مركبة.
مثال على الرحلات عند الطلب
JavaScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
// (Assumes a vehicle location provider.)
locationProvider.addListener('update', e => {
if (e.vehicle) {
const distance =
e.vehicle.remainingDistanceMeters;
infoWindow.setContent(
`Your vehicle is ${distance}m away from the next drop-off point.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
}
});
// 3. Close the info window.
infoWindow.close();
TypeScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
// (Assumes a vehicle location provider.)
locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineVehicleLocationProviderUpdateEvent) => {
if (e.vehicle) {
const distance =
e.vehicle.remainingDistanceMeters;
infoWindow.setContent(
`Your vehicle is ${distance}m away from the next drop-off.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
}
});
// 3. Close the info window.
infoWindow.close();
مثال على المهام المُجدوَلة
JavaScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
// (Assumes a delivery vehicle location provider.)
locationProvider.addListener('update', e => {
if (e.deliveryVehicle) {
const distance =
e.deliveryVehicle.remainingDistanceMeters;
infoWindow.setContent(
`Your vehicle is ${distance}m away from the next task.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
}
});
// 3. Close the info window.
infoWindow.close();
TypeScript
// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
{disableAutoPan: true});
// (Assumes a delivery vehicle location provider.)
locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineDeliveryVehicleLocationProviderUpdateEvent) => {
if (e.deliveryVehicle) {
const distance =
e.deliveryVehicle.remainingDistanceMeters;
infoWindow.setContent(
`Your vehicle is ${distance}m away from the next task.`);
// 2. Attach the info window to a vehicle marker.
// This property can return multiple markers.
const marker = mapView.vehicleMarkers[0];
infoWindow.open(mapView.map, marker);
}
});
// 3. Close the info window.
infoWindow.close();