چندخطیهای مسیر را بااستفاده از روش
ConsumerMapStyle.setPolylineStyleOptions سفارشیسازی میکنید. اگر گزینههای چندخطی سفارشی تنظیم کنید، این گزینهها مقادیر پیشفرض ارائهشده توسط «کیت توسعه نرمافزار مصرفکننده» را لغو میکنند.
برای بازیابی مقادیر پیشفرض،
setPolylineStyleOptions
را با null برای پارامتر PolylineOptions فراخوانی کنید.
برای بازیابی PolylineOptions فعال، از
روش getPolylineStyleOptions استفاده کنید.
برای اطلاعات بیشتر، به
ConsumerMapStyle.setPolylineStyleOptions مراجعه کنید.
انواع چندخطی مسیر
میتوانید انواع چندخطی مسیر زیر را سفارشیسازی کنید:
ACTIVE_ROUTEREMAINING_ROUTE
ACTIVE_ROUTE و REMAINING_ROUTE هنگام دنبال کردن سفر نمایش داده میشوند و
مسیر خودرو را نشان میدهند.
ویژگیهای چندخطی مسیر
Google Maps ویژگیهای قابلسفارشیسازی را برای هر چندخطی در
PolylineOptions ارائه میدهد.
برای ساختن
PolylineOptions، از سازنده آن استفاده کنید.برای مشخص کردن ویژگیهای سفارشیشده، از روشهای سبک «Setter» استفاده کنید. ازآنجاییکه این روش مقادیر پیشفرضی را برای هر ویژگی ارائه میدهد، فقط باید مقادیر سفارشی را مشخص کنید.
برای خاموش کردن چندخطی،
visibleرا رویfalseتنظیم کنید.
برای جزئیات بیشتر،
PolylineOptions را در اسناد توسعهدهنده Android ببینید.
مثال
جاوا
// 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)
مسیر فعال و باقیمانده
با فعال کردن همرسانی مسیر، برنامهتان میتواند بااستفاده از چندخطیها، تجربه کاربر را سفارشیسازی کند تا مسیر فعال و باقیمانده را برای خودرو شما نشان دهد.
مسیر فعال مسیری است که خودرو درحالحاضر برای رسیدن به نقطهمسیر بعدی در سفر فعال مصرفکننده طی میکند.
مسیر باقیمانده مسیری است که خودرو هنوز باید پساز مسیر فعال طی کند. وقتی نقطهمسیر فعال آخرین نقطهمسیر سفر باشد، مسیر باقیمانده وجود ندارد.
میتوانید نمایان بودن چندخطیهای فعال و باقیمانده را در برنامهتان سفارشیسازی و کنترل کنید. بهطور پیشفرض، مسیر فعال نمایان است و مسیر باقیمانده نمایان نیست.
مثال
جاوا
// 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» برای چندخطی مراجعه کنید.
Google Maps وضعیت ترافیک را بهعنوان یکی از چهار نوع سرعت نشان میدهد. میتوانید رنگ را برای هر نوع سرعت سفارشیسازی کنید.
برای فعال کردن چندخطیهای آگاه از ترافیک، یک شیء TrafficStyle بسازید
و سپس آن را با فراخوانی setPolylineTrafficStyle() به ConsumerMapStyle ارسال کنید.
مثال
جاوا
// TrafficStyle is part of the Consumer SDK.
int orange = Color.rgb(255, 165, 0);
TrafficStyle trafficStyle = TrafficStyle.builder()
.setTrafficVisibility(true)
.setTrafficColor(SpeedType.NO_DATA, Color.GREY)
.setTrafficColor(SpeedType.NORMAL, Color.BLUE)
.setTrafficColor(SpeedType.SLOW, orange)
.setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
.build();
consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle);
Kotlin
// TrafficStyle is part of the Consumer SDK.
val orange = Color.rgb(255, 165, 0)
val trafficStyle =
TrafficStyle.builder()
.setTrafficVisibility(true)
.setTrafficColor(SpeedType.NO_DATA, Color.GRAY)
.setTrafficColor(SpeedType.NORMAL, Color.BLUE)
.setTrafficColor(SpeedType.SLOW, orange)
.setTrafficColor(SpeedType.TRAFFIC_JAM, Color.RED)
.build()
consumerMapStyle.setPolylineTrafficStyle(PolylineType.ACTIVE_ROUTE, trafficStyle)