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

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

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

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

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

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

اختَر نوع العلامة.

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

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

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

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

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

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

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

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

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

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

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

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

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

Java

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

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