سفارشی‌سازی نشانگرها

این سند نحوه سفارشی‌سازی نشانگرهای خودرو و مکان را در نقشه‌ای که برای برنامه تحت وب ردیابی محموله برای مصرف‌کنندگان استفاده می‌کنید پوشش می‌دهد.

با JavaScript Consumer SDK، می‌توانید ظاهر و حس دو نوع نشانگر اضافه‌شده به نقشه را سفارشی‌سازی کنید:

این کار را به یکی از دو روش زیر انجام می‌دهید:

  • ساده‌ترین: یک شیء MarkerOptions را برای اعمال به همه نشانگرهای همان نوع مشخص کنید. سپس Consumer SDK سبک را در دو موقعیت اعمال می‌کند: قبل‌از افزودن نشانگرها به نقشه، و زمانی که داده‌های استفاده‌شده برای نشانگرها تغییر کرده باشد.
  • پیشرفته‌تر: تابع سفارشی‌سازی را مشخص کنید. عملکردهای سفارشی‌سازی امکان سبک‌دهی به نشانگرها براساس داده‌ها و همچنین افزودن تعامل به نشانگرها، مانند مدیریت کلیک را فراهم می‌کند. به‌طور خاص، Consumer SDK داده‌های مربوط به نوع شیء را که نشانگر نشان می‌دهد به تابع سفارشی‌سازی ارسال می‌کند: خودرو یا مقصد. این کار سپس اجازه می‌دهد سبک نشانگر براساس وضعیت فعلی خود عنصر نشانگر تغییر کند؛ برای مثال، تعداد توقف‌های برنامه‌ریزی‌شده باقی‌مانده تا مقصد. حتی می‌توانید به داده‌های منابع خارج از Fleet Engine بپیوندید و نشانگر را براساس آن اطلاعات سبک‌بندی کنید.

مثال ساده: استفاده از MarkerOptions

مثال زیر نحوه پیکربندی سبک نشانگر خودرو را با شیء MarkerOptions نشان می‌دهد. این مثال ماتی نشانگر را روی ‎٪۵۰ تنظیم می‌کند.

JavaScript

deliveryVehicleMarkerCustomization = {
  opacity: 0.5
};

TypeScript

deliveryVehicleMarkerCustomization = {
  opacity: 0.5
};

مثال پیشرفته: استفاده از تابع سفارشی‌سازی

مثال زیر نشان می‌دهد که چگونه می‌توان سبک نشانگر خودرو را پیکربندی کرد تا تعداد توقف‌های باقی‌مانده برای خودرو را قبل‌از رسیدن به توقف برای تکلیف زمان‌بندی‌شده نمایش دهد.

JavaScript

deliveryVehicleMarkerCustomization =
  (params) => {
    var stopsLeft = params.taskTrackingInfo.remainingStopCount;
    params.marker.setLabel(`${stopsLeft}`);
  };

TypeScript

deliveryVehicleMarkerCustomization =
  (params: ShipmentMarkerCustomizationFunctionParams) => {
    const stopsLeft = params.taskTrackingInfo.remainingStopCount;
    params.marker.setLabel(`${stopsLeft}`);
  };

افزودن مدیریت کلیک به نشانگرها

می‌توانید مدیریت کلیک را به هر نشانگری اضافه کنید، مانند مثال زیر برای نشانگر خودرو.

JavaScript

deliveryVehicleMarkerCustomization =
  (params) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

TypeScript

deliveryVehicleMarkerCustomization =
  (params: ShipmentMarkerCustomizationFunctionParams) => {
    if (params.isNew) {
      params.marker.addListener('click', () => {
        // Perform desired action.
      });
    }
  };

نمایش اطلاعات تکمیلی برای نشانگرها

می‌توانید از InfoWindow برای نمایش اطلاعات بیشتر درباره نشانگر مکان یا خودرو استفاده کنید. مثال زیر یک InfoWindow ایجاد می‌کند و آن را به نشانگر خودرو پیوست می‌کند:

JavaScript

// 1. Create an info window.
const infoWindow = new google.maps.InfoWindow(
    {disableAutoPan: true});

locationProvider.addListener('update', e => {
  const stopsCount =
      e.taskTrackingInfo.remainingStopCount;
  infoWindow.setContent(
      `Your vehicle is ${stopsCount} stops away.`);

  // 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});

locationProvider.addListener('update', (e: google.maps.journeySharing.FleetEngineShipmentLocationProviderUpdateEvent) => {
  const stopsCount =
      e.taskTrackingInfo.remainingStopCount;
  infoWindow.setContent(
      `Your vehicle is ${stopsCount} stops away.`);

  // 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();

قدم بعدی چیست