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

اختيار النظام الأساسي: Android‏ iOS‏ JavaScript‏

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

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

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

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

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

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

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

  • TRIP_VEHICLE: يتم عرضها أثناء تتبُّع رحلة

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

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

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

  1. استخدِم السمات الخاصة بكل علامة مقدَّمة من MarkerOptions في "خرائط Google".

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

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

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

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

لمزيد من المعلومات، اطّلِع على MarkerOptions في "خرائط Google".

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

جافا

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

Kotlin

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

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