تصميم خريطة

يتناول هذا المستند كيفية تخصيص شكل الخريطة وأسلوب عملها والتحكّم في إمكانية ظهور البيانات وخيارات إطار العرض. يمكنك إجراء ذلك بالطرق التالية:

  • استخدام تصميم الخرائط باستخدام السحابة الإلكترونية
  • ضبط خيارات نمط الخريطة مباشرةً في الرمز الخاص بك

تخصيص مظهر الخريطة باستخدام ميزة "تصميم الخرائط باستخدام السحابة الإلكترونية"

لتطبيق نمط خريطة على خريطة مشاركة رحلة المستهلك المستندة إلى 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 في مرجع واجهة برمجة تطبيقات Google Maps JavaScript.

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 محطات من المهمة. تنتهي إمكانية الاطّلاع على المهمة عند إكمالها أو إلغائها.

يعرض هذا الجدول مستوى العرض التلقائي لكل نوع من المهام. يمكنك تخصيص إذن الوصول إلى العديد من المهام، ولكن ليس كلها. لمزيد من التفاصيل حول أنواع المهام، يُرجى الاطّلاع على أنواع المهام في دليل المهام المُجدوَلة.

نوع المهمة مستوى الرؤية التلقائي قابلة للتخصيص؟ الوصف
مهام عدم التوفّر لا يظهر لا تُستخدَم هذه المعلومات لتحديد أوقات استراحة السائق والتزوّد بالوقود. إذا كان مسار مهمة توصيل يتضمّن أيضًا محطة مركبة أخرى، لن يتم عرض هذه المحطة إذا كانت تتضمّن مهام عدم توفّر فقط. سيظل وقت الوصول المتوقّع ووقت إكمال المهمة المقدَّر معروضَين لمهمة التسليم نفسها.
فتح مهام المركبة Visible نعم تنتهي إمكانية الاطّلاع على المهمة عند إكمالها أو إلغائها. يمكنك تخصيص مستوى عرض مهام المركبة المفتوحة. يمكنك الاطّلاع على تخصيص مستوى رؤية مهام المركبة المفتوحة.
مهام المركبة المغلقة لا يظهر لا لا يمكنك تخصيص إذن الوصول إلى مهام المركبة المغلقة.

تخصيص مستوى رؤية مهام المركبة المفتوحة

توفّر واجهة TaskTrackingInfo عددًا من عناصر بيانات المهام التي يمكن إظهارها باستخدام حزمة تطوير البرامج (SDK) الخاصة بالمستهلكين.

عناصر بيانات المهام القابلة للتخصيص

خطوط متعددة للمسار

الوقت المقدَّر للوصول

الوقت المقدَّر لإكمال المهمة

المسافة المتبقية للوصول إلى المهمة

عدد التوقفات المتبقية

الموقع الجغرافي للمركبة

خيارات مستوى الظهور لكل مهمة

يمكنك تخصيص إعدادات مستوى العرض لكل مهمة على حدة من خلال ضبط TaskTrackingViewConfig عند إنشاء مهمة أو تعديلها في Fleet Engine. استخدِم خيارات الظهور التالية لإنشاء معايير تحدّد ما إذا كان عنصر مهمة سيظهر أم لا:

خيارات مستوى الظهور

عدد التوقفات المتبقية

المدة حتى وقت الوصول المقدَّر

المسافة المتبقية للقيادة

مرئي دائمًا

غير مرئية مطلقًا

لتوضيح ذلك، لنفترض أنّ عملية تخصيص نموذجية تعدّل مستوى العرض لثلاثة عناصر بيانات باستخدام المعايير الموضّحة في الجدول التالي. تخضع جميع العناصر الأخرى لقواعد مستوى العرض التلقائية.

عنصر البيانات المطلوب تعديله مستوى الرؤية المعيار
خطوط متعدّدة للمسار إظهار المركبة على بُعد 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 متر على الأقل.

إيقاف ميزة "الملاءمة التلقائية"

يمكنك إيقاف الملاءمة التلقائية لكي لا يتم ضبط إطار العرض تلقائيًا على المركبة والمسار المتوقّع. يوضّح المثال التالي كيفية إيقاف الملاءمة التلقائية عند ضبط عرض الخريطة لميزة "مشاركة الرحلة".

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,
  ...
});

الخطوات التالية