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

اختيار النظام الأساسي: 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 أثناء مراقبة الرحلة لمحاكاة سلوك المركبة الفعلية أثناء تنقّلها في المسار.

ملاحظة: للحصول على نتائج الصور المتحركة الأكثر واقعية، استخدِم منظورًا من الأعلى لرمز TRIP_VEHICLE، مع توجيه مقدمة المركبة للأعلى.

ملاحظة: لا يتغيّر رمز العلامة حسب نوع المركبة الفعلي للرحلة.

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

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

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

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

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

   ملاحظة: بما أنّ حزمة تطوير البرامج (SDK) توفّر قيمًا تلقائية لكلّ سمة علامة، عليك تحديد السمات المخصّصة فقط للقيم التي تريد تغييرها.

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)

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

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