การปรับแต่งมาร์กเกอร์
ใน Consumer SDK เวอร์ชันก่อนหน้า คุณใช้ออบเจ็กต์ MarkerStyleOptions ของ Consumer SDK เพื่อปรับแต่งพร็อพเพอร์ตี้สไตล์ของมาร์กเกอร์ ใน Consumer SDK v1.0 คุณจะใช้ออบเจ็กต์ MarkerOptions จาก Maps SDK โดยตรง
// Centering the marker anchor at (0.5, 0.5) is recommended.
// For vehicle markers, set flat to true to allow the vehicle marker to freely
// rotate flat on the map (rather than always have it face the camera).
MarkerOptions vehicleMarkerOptions = new MarkerOptions()
.flat(true)
.anchor(0.5f, 0.5f)
.icon(vehicleIcon)
.zIndex(1.0f);
consumerMapStyle.setMarkerStyleOptions(MarkerType.TRIP_VEHICLE);
ConsumerMapStyle จะแสดงผลตัวเลือกสไตล์เริ่มต้นที่ SDK ระบุไว้สำหรับมาร์กเกอร์ประเภทหนึ่งๆ หากยังไม่ได้ตั้งค่าสไตล์ หรือหากตั้งค่าตัวเลือกสไตล์เป็น null
// ConsumerMapStyle returns the SDK-set default style options if none has been set yet.
MarkerOptions defaultPickupPointStyleOptions = consumerMapStyle.getMarkerStyleOptions(MarkerType.PICKUP_POINT);
// Setting the style to null reverts the style back to the SDK-set default properties.
consumerMapStyle.setMarkerStyleOptions(MarkerType.PICKUP_POINT, /* markerStyleOptions= */ null);
MarkerOptions defaultPickupPointStyleOptions = consumerMapStyle.getMarkerStyleOptions(MarkerType.PICKUP_POINT);
หากไม่ต้องการสร้างสไตล์ใหม่ตั้งแต่ต้น คุณสามารถแก้ไขสไตล์เริ่มต้นได้ ตัวอย่างต่อไปนี้จะแก้ไขเฉพาะไอคอนจุดรับ และใช้การตั้งค่าเริ่มต้นของ SDK สำหรับตัวเลือกมาร์กเกอร์อื่นๆ
// getMarkerStyleOptions returns the default pickup point style options, since
// the custom style hasn't been set yet.
MarkerOptions pickupPointStyleOptions =
consumerMapStyle.getMarkerStyleOptions(MarkerType.PICKUP_POINT);
// Modify the icon value and set the style.
consumerMapStyle.setMarkerStyleOptions(
pickupPointStyleOptions.icon(pickupPointIcon));
การปรับแต่งเส้นประกอบ
ใน Consumer SDK เวอร์ชันก่อนหน้า คุณใช้ ออบเจ็กต์ PolylineStyleOptions ของ Consumer SDK เพื่อปรับแต่งพร็อพเพอร์ตี้สไตล์ของเส้นประกอบ ใน Consumer SDK v1.0 คุณจะใช้ออบเจ็กต์ PolylineOptions จาก Maps SDK เพื่อปรับแต่งพร็อพเพอร์ตี้สไตล์ของเส้นประกอบพื้นฐาน และใช้ออบเจ็กต์ TrafficStyle เพื่อปรับแต่งสีการจราจรของเส้นประกอบ
เส้นประกอบการจราจรมีให้บริการใน Consumer SDK v1.0 เวอร์ชันอัลฟ่า หากการจราจรแสดงอยู่ สีของเส้นประกอบพื้นฐานจะถูกแทนที่ด้วยสีการจราจร การจราจรจะไม่แสดงโดยค่าเริ่มต้น ระบบจะป้อนค่าเริ่มต้นที่ SDK ระบุไว้ในช่องของ TrafficStyle ที่ไม่ได้ตั้งค่า
// PolylineOptions is from Maps SDK
PolylineOptions polylineOptions = new PolylineOptions()
.color(color)
.width(width)
.geodesic(geodesic)
.startCap(startCap)
.endCap(endCap)
.zIndex(zIndex);
consumerMapStyle.setPolylineStyleOptions(
PolylineType.ACTIVE_ROUTE, polylineOptions);
// TrafficStyle is from ConsumerSDK
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);
ConsumerMapStyle จะแสดงผลตัวเลือกสไตล์เริ่มต้นของ SDK สำหรับเส้นประกอบประเภทหนึ่งๆ หากยังไม่ได้ตั้งค่า หรือหากตั้งค่าตัวเลือกสไตล์เป็น null ซึ่งจะมีผลกับทั้ง PolylineOptions พื้นฐานและ TrafficStyle
// ConsumerMapStyle returns the SDK's default style options if none has been set yet.
PolylineOptions defaultActiveRouteStyleOptions = consumerMapStyle.getPolylineStyleOptions(PolylineType.ACTIVE_ROUTE);
// Setting the style to null reverts the style back to the SDK-set default properties.
consumerMapStyle.setPolylineStyleOptions(
PolylineType.ACTIVE_ROUTE, /* polylineStyleOptions= */ null);
PolylineOptions defaultActiveRouteStyleOptions =
consumerMapStyle.getPolylineStyleOptions(PolylineType.ACTIVE_ROUTE);
หากไม่ต้องการสร้างสไตล์ใหม่ตั้งแต่ต้น คุณสามารถแก้ไขสไตล์เริ่มต้นได้ ตัวอย่างต่อไปนี้จะแก้ไขเฉพาะสีของเส้นประกอบเส้นทางที่ใช้งานอยู่พื้นฐาน และใช้การตั้งค่าสไตล์เริ่มต้นของ SDK สำหรับตัวเลือกมาร์กเกอร์อื่นๆ
// Only customize the remaining route polyline color.
PolylineOptions remainingRouteStyleOptions =
consumerMapStyle.getPolylineStyleOptions(PolylineType.REMAINING_ROUTE);
consumerMapStyle.setPolylineStyleOptions(
remainingRouteStyleOptions.color(Color.DARK_BLUE));