يمكنك تخصيص الخطوط المتعددة للمسار باستخدام
طريقة ConsumerMapStyle.setPolylineStyleOptions
. في حال ضبط خطوط متعدّدة مخصّصة
ستلغي القيم التلقائية التي تقدّمها حزمة تطوير البرامج (SDK) الخاصة بالمستهلك.
لاستعادة القيم التلقائية، اتصل
setPolylineStyleOptions
مع null
للمعلمة PolylineOptions
.
لاسترداد قيمة PolylineOptions
النشطة، استخدِم
getPolylineStyleOptions
.
لمزيد من المعلومات، يُرجى مراجعة
ConsumerMapStyle.setPolylineStyleOptions
أنواع الخطوط المتعددة للمسار
يمكنك تخصيص أنواع الخطوط المتعددة للمسارات التالية:
ACTIVE_ROUTE
REMAINING_ROUTE
يتم عرض ACTIVE_ROUTE
وREMAINING_ROUTE
أثناء مشاركة الرحلة
مسار المركبة.
خصائص الخطوط المتعددة للمسار
توفّر "خرائط Google" خصائص قابلة للتخصيص متاحة لكل خط متعدد في
PolylineOptions
لإنشاء
PolylineOptions
، استخدِم الدالة الإنشائية الخاصة به.لتحديد السمات المخصّصة، استخدِم "Setter" (أداة الإعداد). والأسلوب. منذ توفر الطريقة القيم الافتراضية لكل خاصية، فأنت بحاجة فقط لتحديد أي قيم مخصصة.
لإيقاف الخطوط المتعددة، اضبط
visible
علىfalse
.
لمزيد من التفاصيل، يُرجى مراجعة
PolylineOptions
في مستندات مطوّري برامج Android
مثال
Java
// Initializing polyline style options.
consumerController
.getConsumerMapStyle()
.addOnSuccessListener(
consumerMapStyle -> {
consumerMapStyle.setPolylineStyleOptions(
PolylineType.ACTIVE_ROUTE,
new PolylineOptions()
.visible(false));
});
// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);
Kotlin
// Initializing polyline options.
consumerController
.getConsumerMapStyle()
.addOnSuccessListener({ consumerMapStyle ->
consumerMapStyle.setPolylineStyleOptions(
PolylineType.ACTIVE_ROUTE,
PolylineOptions().visible(false)
)
})
// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)
المسار نشط والمتبقي
عند تفعيل ميزة مشاركة الرحلة، يمكن لتطبيقك تخصيص تجربت ا المستخدم باستخدام الخطوط المتعددة لعرض المسار النشط والمتبقّي لمركبتك.
المسار النشط هو المسار الذي تسلكه المركبة الآن للوصول إليه النقطة التالية في رحلة المستهلك النشطة.
المسار المتبقي هو المسار الذي لا يزال يتعين على المركبة مروره المسار النشط. فعندما تكون نقطة طريق المسار النشطة هي آخر نقطة طريق للرحلة، المسار المتبقي غير موجود.
يمكنك تخصيص إذن الوصول إلى الخطوط المتعددة النشطة وتلك المتبقية والتحكّم فيها في تطبيقك. يكون المسار النشط مرئيًا والمسار المتبقي تلقائيًا. غير مرئية.
مثال
Java
// Initializing polyline options.
consumerController
.getConsumerMapStyle()
.addOnSuccessListener(
consumerMapStyle -> {
consumerMapStyle.setPolylineStyleOptions(
PolylineType.ACTIVE_ROUTE,
new PolylineOptions()
.color(Color.BLUE));
consumerMapStyle.setPolylineStyleOptions(
PolylineType.REMAINING_ROUTE,
new PolylineOptions()
.color(Color.BLACK)
.width(5)
.visible(true));
});
// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null);
consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null);
Kotlin
// Initializing polyline options.
consumerController
.getConsumerMapStyle()
.addOnSuccessListener({ consumerMapStyle ->
{
consumerMapStyle.setPolylineStyleOptions(
PolylineType.ACTIVE_ROUTE,
PolylineOptions().color(Color.BLUE)
)
consumerMapStyle.setPolylineStyleOptions(
PolylineType.REMAINING_ROUTE,
PolylineOptions().color(Color.BLACK).width(5).visible(true)
)
}
})
// Reset polyline options to default values.
consumerMapStyle.setPolylineStyleOptions(PolylineType.ACTIVE_ROUTE, null)
consumerMapStyle.setPolylineStyleOptions(PolylineType.REMAINING_ROUTE, null)
الخطوط المتعددة الواعية بحركة المرور
تكون طبقة حركة المرور للخط المتعدّد غير مفعّلة تلقائيًا. عند تفعيلها يرسم العارض أجزاءً فوق الخطوط المتعددة للمسار التي تمثل امتدادات حركة المرور غير العادية. ويتضمن إزاحة اعتمادًا على حالة حركة المرور. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على وثائق مطوّري برامج Android حول Polyline.
تمثل خرائط Google أحوال حركة المرور كإحدى أربعة أنواع للسرعة. يمكنك تخصيص لون كل نوع سرعة.
لتفعيل الخطوط المتعددة الواعية بحركة المرور، أنشئ كائن TrafficStyle
.
ثم مرِّره إلى ConsumerMapStyle
من خلال الاتصال برقم setPolylineTrafficStyle()
.
مثال
Java
// TrafficStyle is part of the Consumer SDK.
TrafficStyle trafficStyle = TrafficStyle.builder()
.setTrafficVisibility(true)
.setTrafficColor(SpeedType.NO_DATA, Color.GREY)
.setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
.setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
.setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
.build();
consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);
Kotlin
// TrafficStyle is part of the Consumer SDK.
val trafficStyle =
TrafficStyle.builder()
.setTrafficVisibility(true)
.setTrafficColor(SpeedType.NO_DATA, Color.GREY)
.setTrafficColor(SpeedType.NORMAL_VALUE, Color.BLUE)
.setTrafficColor(SpeedType.SLOW_VALUE, Color.ORANGE)
.setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
.build()
consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)