سبک‌دار کردن نقشه

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

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

سبک‌پردازی نقشه بااستفاده از فضای ابری سبک‌پردازی نقشه

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

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

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 در مرجع میانای برنامه‌سازی کاربردی جاوا اسکریپت در 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" }
        ]
      }
    ]
  }
});

کنترل نمایان بودن داده‌های تکلیف برای کیت توسعه نرم‌افزار

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

رؤیت‌پذیری پیش‌فرض داده‌های تکلیف

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

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

سفارشی‌سازی کردن نمایان بودن تکالیف خودرو باز

میانای 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,
  ...
});

قدم بعدی چیست

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