ก่อนปรับแต่งเส้นประกอบของเส้นทาง (หรือเครื่องหมาย) คุณต้องเริ่มต้นตัวเลือกการปรับแต่ง UI ก่อน
เริ่มต้นตัวเลือกการกำหนดค่า UI
Callback ที่แนะนำซึ่งใช้เพื่อตั้งค่าตัวเลือกการปรับแต่ง UI ในตอนแรกจะประกาศใน GMTCMapViewDelegate
การเรียกกลับ mapViewDidInitialize
จะทริกเกอร์เมื่อออบเจ็กต์ GMTCMapView
พร้อมแสดงผลแผนที่
เริ่มต้นเครื่องมือประสานงานรูปแบบแล้ว แต่ไม่มีองค์ประกอบ UI
Swift
/** ViewController.swift */
class ViewController: UIViewController, GMTCMapViewDelegate {
// MARK: - GMTCMapViewDelegate
func mapViewDidInitialize(_ mapview: GMTCMapView) {
// Set the UI customization options here.
}
}
Objective-C
/** ViewController.m */
@interface ViewController () <GMTCMapViewDelegate>
#pragma mark GMTCMapViewDelegate
- (void)mapViewDidInitialize:(GMTCMapView *)mapview {
// Set the UI customization options here.
}
ปรับแต่งเส้นประกอบ
การตั้งค่าการปรับแต่งเส้นประกอบทำได้โดยใช้ GMTCConsumerMapStyleCoordinator#setPolylineStyleOptions(_:polylineType:)
ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าตัวเลือกรูปแบบเส้น
ประเภทเส้นประกอบ
คุณปรับแต่งประเภทเส้นประกอบต่อไปนี้ได้
GMTCPolylineType.activeRoute
: เส้นทางที่ยานพาหนะกำลังใช้เพื่อไปยังจุดหมายถัดไปของผู้ขับขี่ ไม่ว่าจะเป็นจุดรับหรือจุดส่งGMTCPolylineType.remainingRoute
: ส่วนของการเดินทางที่เหลืออยู่หลังจากขับครบGMTCPolylineType.activeRoute
แล้ว
โฆษณาทั้ง 2 ประเภทนี้จะแสดงตลอดเส้นทางที่แชร์
สมบัติของเส้นประกอบ
พร็อพเพอร์ตี้ที่คุณปรับแต่งได้สำหรับเส้นประกอบแต่ละเส้นคือพร็อพเพอร์ตี้ย่อยของพร็อพเพอร์ตี้ที่มีให้ใน Google Maps
PolylineOptions
พร็อพเพอร์ตี้ SDK ของผู้บริโภค
GMTCPolylineStyleOptions
มีคุณสมบัติต่อไปนี้
- สร้างโดยใช้โปรแกรมเริ่มต้น
- จะเปลี่ยนแปลงไม่ได้หรือเปลี่ยนแปลงได้หากต้องการระบุค่าที่กำหนดเองให้กับพร็อพเพอร์ตี้ใดๆ
- มีค่าเริ่มต้น
คุณปรับแต่งพร็อพเพอร์ตี้ต่อไปนี้ได้
color
width
isVisible
: หากต้องการปิดใช้เส้นประกอบ ให้ตั้งค่าisVisible
เป็นfalse
isTrafficEnabled
: ระบบจะตั้งค่าพร็อพเพอร์ตี้นี้เป็นfalse
โดยค่าเริ่มต้น
ตัวอย่าง
Swift
/** MapViewController.swift */
private func updatePolylineUIOptions() {
// Get the GMTCConsumerMapStyleCoordinator
let consumerMapStyleCoordinator = mapView.consumerMapStyleCoordinator
// The polyline type that you would like to set custom UI options for.
let customizablePolylineType = GMTCPolylineType.activeRoute
// Initializing polyline options with default values (immutable version).
let polylineStyleOptions = GMTCPolylineStyleOptions()
consumerMapStyleCoordinator.setPolylineStyleOptions(
polylineStyleOptions, polylineType: customizablePolylineType)
// Initializing polyline options with custom values (mutable version).
let mutablePolylineStyleOptions = GMTCMutablePolylineStyleOptions()
mutablePolylineStyleOptions.isVisible = true
mutablepolylineStyleOptions.strokeWidth = 8.0
mutablepolylineStyleOptions.strokeColor = .blue
mutablepolylineStyleOptions.zIndex = 1000
mutablepolylineStyleOptions.isGeodesic = true
mutablePolylineStyleOptions.isTrafficEnabled = true
mutablePolylineStyleOptions.setTrafficColorFor(.slow, color: .yellow)
mutablePolylineStyleOptions.setTrafficColorFor(.trafficJam, color: .purple)
consumerMapStyleCoordinator.setPolylineStyleOptions(
mutablePolylineStyleOptions, polylineType: customizablePolylineType)
// Reset polyline options to default values.
consumerMapStyleCoordinator.setPolylineStyleOptions(
nil, polylineType: customizablePolylineType)
}
Objective-C
/** MapViewController.m */
- (void)updatePolylineUIOptions {
// Get the GMTCConsumerMapStyleCoordinator
GMTCConsumerMapStyleCoordinator *consumerMapStyleCoordinator = [_mapView consumerMapStyleCoordinator];
// The polyline type that you would like to set custom UI options for.
GMTCPolylineType customizablePolylineType = GMTCPolylineTypeActiveRoute;
// Initializing polyline options with default values (immutable version).
GMTCPolylineStyleOptions *polylineStyleOptions = [[GMTCPolylineStyleOptions alloc] init];
[consumerMapStyleCoordinator setPolylineStyleOptions:polylineStyleOptions
polylineType:customizablePolylineType];
// Initializing polyline options with custom values (mutable version).
GMTCMutablePolylineStyleOptions *mutablePolylineStyleOptions = [[GMTCMutablePolylineStyleOptions alloc] init];
mutablePolylineStyleOptions.isVisible = YES;
mutablepolylineStyleOptions.strokeWidth = 8.0;
mutablepolylineStyleOptions.strokeColor = [UIColor blueColor];
mutablepolylineStyleOptions.zIndex = 1000;
mutablepolylineStyleOptions.isGeodesic = YES;
mutablePolylineStyleOptions.isTrafficEnabled = YES;
[mutablePolylineStyleOptions setTrafficColorForSpeed:GMTSSpeedTypeSlow color:[UIColor yellowColor]];
[mutablePolylineStyleOptions setTrafficColorForSpeed:GMTSSpeedTypeTrafficJam color:[UIColor purpleColor]];
[consumerMapStyleCoordinator setPolylineStyleOptions:mutablePolylineStyleOptions
polylineType:customizablePolylineType];
// Reset polyline options to default values.
[consumerMapStyleCoordinator setPolylineStyleOptions:nil
polylineType:customizablePolylineType];
}
เส้นประกอบที่คำนึงถึงสภาพการจราจร
เลเยอร์การจราจรของเส้นประกอบจะปิดอยู่โดยค่าเริ่มต้น เมื่อเปิดใช้โดยใช้ polylineStyleOptions.isTrafficEnabled = true
ส่วนที่แทนถนนที่มีการจราจรที่ไม่ใช่ปกติจะวาดเป็นเส้นทาง
สภาพการจราจรจะแสดงเป็นความเร็วอย่างใดอย่างหนึ่งต่อไปนี้
GMTSSpeedType.noData
GMTSSpeedType.normal
GMTSSpeedType.slow
GMTSSpeedType.trafficJam
คุณปรับแต่งสีที่แสดงถึงการจัดประเภทความเร็วแต่ละประเภทได้โดยใช้ setTrafficColorFor(_:color:)