به یک نقشه سبک دهید

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

• از استایل‌دهی نقشه مبتنی بر ابر استفاده کنید
• گزینه‌های سبک نقشه را مستقیماً در کد خود تنظیم کنید

نقشه را با استفاده از سبک نقشه‌های مبتنی بر ابر، استایل دهید

برای اعمال یک سبک نقشه به نقشه اشتراک‌گذاری سفر مصرف‌کننده جاوا اسکریپت خود، هنگام ایجاد JourneySharingMapView یک mapId و هر mapOptions دیگری را مشخص کنید.

مثال‌های زیر نحوه اعمال یک سبک نقشه با شناسه نقشه را نشان می‌دهند.

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    mapId: 'YOUR_MAP_ID'
  }
  // Any other styling options.
});

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 در مرجع API جاوا اسکریپت Google Maps مراجعه کنید.

const mapView = new google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  mapOptions: {
    styles: [
      {
        "featureType": "road.arterial",
        "elementType": "geometry",
        "stylers": [
          { "color": "#CCFFFF" }
        ]
      }
    ]
  }
});

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

شما می‌توانید با استفاده از قوانین مربوط به قابلیت مشاهده، میزان دیده شدن اشیاء وظیفه خاص را روی نقشه کنترل کنید.

قابلیت مشاهده پیش‌فرض داده‌های وظیفه

به طور پیش‌فرض، داده‌های مربوط به وظایف محول شده به یک وسیله نقلیه زمانی قابل مشاهده هستند که وسیله نقلیه در فاصله ۵ ایستگاه از وظیفه قرار داشته باشد . این قابلیت مشاهده زمانی پایان می‌یابد که وظیفه تکمیل یا لغو شود.

این جدول میزان نمایش پیش‌فرض برای هر نوع وظیفه را نشان می‌دهد. شما می‌توانید میزان نمایش بسیاری از وظایف را سفارشی کنید، اما نه همه آنها را. برای جزئیات بیشتر در مورد انواع وظایف، به بخش انواع وظایف در راهنمای وظایف زمان‌بندی شده مراجعه کنید.

قابلیت مشاهده وظایف مربوط به وسایل نقلیه باز را سفارشی کنید

رابط TaskTrackingInfo تعدادی عنصر داده وظیفه را ارائه می‌دهد که می‌توانند با Consumer SDK قابل مشاهده شوند.

گزینه‌های دید برای هر وظیفه

شما می‌توانید پیکربندی قابلیت مشاهده را بر اساس هر وظیفه با تنظیم TaskTrackingViewConfig هنگام ایجاد یا به‌روزرسانی یک وظیفه در Fleet Engine سفارشی کنید. از گزینه‌های قابلیت مشاهده زیر برای ایجاد معیارهایی برای تعیین قابلیت مشاهده یک عنصر وظیفه استفاده کنید:

برای روشن شدن موضوع، فرض کنید یک نمونه سفارشی‌سازی، قابلیت مشاهده سه عنصر داده را با استفاده از معیارهای نشان داده شده در جدول زیر تنظیم می‌کند. سایر عناصر از قوانین پیش‌فرض قابلیت مشاهده پیروی می‌کنند.

مثال زیر این پیکربندی را نشان می‌دهد:

"taskTrackingViewConfig": {
  "routePolylinePointsVisibility": {
    "remainingStopCountThreshold": 3
  },
  "estimatedArrivalTimeVisibility": {
    "remainingDrivingDistanceMetersThreshold": 5000
  },
  "remainingStopCountVisibility": {
    "never": true
  }
}

خطوط چندخطی مسیر و قوانین دید موقعیت مکانی خودرو

خطوط چندخطی مسیر قابل مشاهده نیستند، مگر اینکه موقعیت مکانی وسیله نقلیه نیز قابل مشاهده باشد؛ در غیر این صورت، موقعیت مکانی وسیله نقلیه را می‌توان از انتهای یک خط چندخطی استنباط کرد.

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

    "taskTrackingViewConfig": {
      "routePolylinePointsVisibility": {
        "remainingStopCountThreshold": 3
      },
      "vehicleLocationVisibility": {
        "remainingStopCountThreshold": 5
      },
    }
    

  "taskTrackingViewConfig": {
    "routePolylinePointsVisibility": {
      "remainingStopCountThreshold": 3
    },
    "vehicleLocationVisibility": {
      "remainingDrivingDistanceMetersThreshold": 3000
    },
  }

غیرفعال کردن نصب خودکار

با غیرفعال کردن تطبیق خودکار، می‌توانید از تطبیق خودکار نقشه با نمای دید وسیله نقلیه و مسیر پیش‌بینی‌شده جلوگیری کنید. مثال زیر نحوه غیرفعال کردن تطبیق خودکار را هنگام پیکربندی نمای نقشه اشتراک‌گذاری سفر نشان می‌دهد.

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

const mapView = new
    google.maps.journeySharing.JourneySharingMapView({
  element: document.getElementById('map_canvas'),
  locationProviders: [locationProvider],
  automaticViewportMode:
      google.maps.journeySharing
          .AutomaticViewportMode.NONE,
  ...
});

قدم بعدی چیست؟

• نشانگرها را سفارشی کنید
• سفارشی‌سازی چندخطی‌ها