تخصيص العلامات

توفّر الفئة ConsumerMapStyle طرقًا لضبط القيم والحصول عليها مع إمكانية التخصيص الديناميكي للعلامات والخطوط المتعدّدة. يمكنك عرض هذه الفئة بشكل غير متزامن باستخدام الطريقة ConsumerController.getConsumerMapStyle().

يستمر تخصيص واجهة المستخدم في جميع عمليات تدوير الجهاز ويظل ساريًا حتى تفصل ConsumerController.

تخصيص محدّدات المواقع

لضبط نوع العلامة وسماتها، استخدِم الطريقة ConsumerMapStyle.setMarkerStyleOptions(). تلغي خيارات محدّد الموقع المخصّص القيم التلقائية التي توفّرها حزمة SDK للمستهلك. لاستعادة القيم التلقائية، يمكنك استدعاء setMarkerStyleOptions() باستخدام null للمَعلمة MarkerOptions. يمكنك استرداد MarkerOptions النشط باستخدام getMarkerStyleOptions().

اختيار نوع العلامة

يمكنك استخدام رموز العلامات التالية وتخصيصها:

• ‫TRIP_PICKUP_POINT: تظهر أثناء تتبُّع رحلة
• ‫TRIP_DROPOFF_POINT: تظهر أثناء تتبُّع رحلة
• TRIP_INTERMEDIATE_DESTINATION

• ‫TRIP_VEHICLE: تظهر أثناء تتبُّع رحلة

  تعدّل حزمة تطوير البرامج (SDK) للمستهلك اتجاه الرمز TRIP_VEHICLE أثناء تتبُّع الرحلة لمحاكاة سلوك المركبة الفعلية أثناء تنقّلها على المسار.

تحديد خيارات العلامات

يمكنك تخصيص محدّدات المواقع لتطبيق المستهلك باتّباع الخطوات التالية:

1. استخدِم السمات لكل علامة توفّرها "خرائط Google"‏ MarkerOptions.

2. أنشئ MarkerOptions باستخدام الدالة الإنشائية.

3. حدِّد الخصائص المخصّصة باستخدام طرق نمط "Setter".

4. يمكنك استخدام عنصر في واجهة المستخدم الخاص بك من خلال محاكاة الأنماط التي يوفّرها المُنشئ MarkerOptions.

5. لإيقاف علامة، اضبط السمة visible على false. يمكنك بعد ذلك استخدام عنصر في واجهة المستخدم الخاص بك في مكانه.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة "خرائط Google" MarkerOptions.

أمثلة على تخصيصات العلامات

// Initializing marker options.
consumerController
    .getConsumerMapStyle()
    .addOnSuccessListener(
        consumerMapStyle -> {
          consumerMapStyle.setMarkerStyleOptions(
              MarkerType.TRIP_VEHICLE,
              new MarkerOptions()
                  .visible(false));
        });

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null);

// Initializing marker options.
consumerController
  .getConsumerMapStyle()
  .addOnSuccessListener({ consumerMapStyle ->
    consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, MarkerOptions().visible(false))
  })

// Reset marker options to default values.
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE, null)

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

• تخصيص الخطوط المتعدّدة للمسار