ปรับแต่งเครื่องหมาย

เลือกแพลตฟอร์ม Android iOS JavaScript

ก่อนที่คุณจะปรับแต่งเครื่องหมาย (หรือเส้นประกอบ) คุณต้องเริ่มต้น ตัวเลือกการปรับแต่ง UI

เริ่มต้นตัวเลือกการกำหนดค่า UI

Callback ที่แนะนำซึ่งใช้เพื่อตั้งค่าตัวเลือกการปรับแต่ง UI ในตอนแรก มีการประกาศใน GMTCMapViewDelegate mapViewDidInitialize Callback จะถูกเรียกใช้เมื่อออบเจ็กต์ 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.
}

ปรับแต่งเครื่องหมาย

ตัวอย่างต่อไปนี้ใช้ GMTCMapView สำหรับการปรับแต่งรูปแบบเครื่องหมาย หากต้องการกำหนดประเภทเครื่องหมายและคุณสมบัติของเครื่องหมาย ให้ใช้ setMarkerStyleOptions(_:markerType:) ตัวเลือกตัวทำเครื่องหมายที่กำหนดเองจะลบล้าง ค่าเริ่มต้นที่ระบุโดย Consumer SDK

Swift

/** MapViewController.swift */

func updateMarkerUIOptions() {
  let customizableMarkerType = GMTCCustomizableMarkerType.tripVehicle
  let markerStyleOptions = GMTCMutableMarkerStyleOptions()
  markerStyleOptions.groundAnchor = groundAnchor
  markerStyleOptions.isVisible = true
  markerStyleOptions.icon = icon
  markerStyleOptions.zIndex = 100
  markerStyleOptions.isFlat = false
  let coordinator = self.mapView.consumerMapStyleCoordinator
  coordinator.setMarkerStyleOptions(markerStyleOptions, markerType: customizableMarkerType)
}

/** To restore the default values, call setMarkerStyleOptions(_:markerType:) using nil for the GMTCMarkerStyleOptions parameter.
Here is an example of retrieving the active GMTCMarkerStyleOptions. */

private func retrieveMarkerStyle(markerType: GMTCCustomizableMarkerType) {
  let styleCoordinator = mapView.consumerMapStyleCoordinator

  // The 'markerStyleOptions' contains the stored style options for this marker type.
  let markerStyleOptions = styleCoordinator.markerStyleOptions(for: markerType)
}

Objective-C


/** MapViewController.m */

- (void)updateMarkerUIOptions {
  // The marker type that you would like to set custom UI options for.
  GMTCCustomizableMarkerType customizableMarkerType = GMTCCustomizableMarkerTypeTripVehicle;

  GMTCMutableMarkerStyleOptions *markerStyleOptions =
      [[GMTCMutableMarkerStyleOptions alloc] init];
  markerStyleOptions.groundAnchor = groundAnchor;
  markerStyleOptions.isVisible = YES;
  markerStyleOptions.icon = icon;
  markerStyleOptions.zIndex = 100;
  markerStyleOptions.isFlat = NO;

  [[_mapView consumerMapStyleCoordinator] setMarkerStyleOptions:markerStyleOptions markerType:customizableMarkerType];
}

/** To restore the default values, call setMarkerStyleOptions:markerStyleOptions:markerType: using nil for the GMTCMarkerStyleOptions parameter.
Here is an example of retrieving the active GMTCMarkerStyleOptions. */

- (void)retrieveMarkerStyle:(GMTCCustomizableMarkerType)markerType {
  GMTCConsumerMapStyleCoordinator *styleCoordinator = _mapView.consumerMapStyleCoordinator;

  // The 'markerStyleOptions' contains the stored style options for this marker type.
  GMTCMarkerStyleOptions *markerStyleOptions = [styleCoordinator markerStyleOptionsForType:markerType];
}

ประเภทเครื่องหมาย

คุณปรับแต่งเครื่องหมายต่อไปนี้ได้

  • GMTCCustomizableMarkerType.unknown
  • GMTCCustomizableMarkerType.tripPickupPoint
  • GMTCCustomizableMarkerType.tripDropoffPoint
  • GMTCCustomizableMarkerType.tripVehicle
  • GMTCCustomizableMarkerType.intermediateDestination

ใช้ GMTCCustomizableMarkerType.tripPickupPoint GMTCCustomizableMarkerType.intermediateDestination และ GMTCCustomizableMarkerType.tripDropoffPoint เพื่อปรับแต่งจุดอ้างอิงระหว่าง ของ Google

ใช้ GMTCCustomizableMarkerType.tripVehicle เพื่อปรับแต่งไอคอนยานพาหนะ ระหว่างการแชร์การเดินทาง ไอคอนตัวทำเครื่องหมายไม่เปลี่ยนแปลง ตามประเภทยานพาหนะจริงสำหรับการเดินทาง

ตัวเลือกเครื่องหมาย

คุณสมบัติที่สามารถกำหนดค่าได้สำหรับเครื่องหมายแต่ละเครื่องหมายเป็นชุดย่อยของ ที่พักจาก Google Maps MarkerOptions SDK ของผู้บริโภค GMTCMarkerStyleOptions มีลักษณะดังต่อไปนี้

  • สร้างโดยใช้โปรแกรมเริ่มต้น
  • เปลี่ยนแปลงไม่ได้เมื่อสร้างแล้ว
  • หากมีค่าเริ่มต้น คุณเพียงต้องระบุค่าที่กำหนดเองใดก็ตาม

คุณปรับแต่งพร็อพเพอร์ตี้ต่อไปนี้ได้

  • groundAnchor
  • isVisible: หากต้องการปิดเครื่องหมาย ให้ตั้งค่า isVisible เป็น "เท็จ" ข้อมูลเพียงพอ มีไว้สำหรับใช้องค์ประกอบ UI ของคุณเองแทนที่องค์ประกอบนั้น
  • iconView
  • icon
  • zIndex
  • isFlat

ตัวอย่าง

Swift

/** MapViewController.swift */

private func updateMarkerUIOptions() {
  // Get the GMTCConsumerMapStyleCoordinator
  let consumerMapStyleCoordinator = mapView.consumerMapStyleCoordinator

  // The marker type that you would like to set custom UI options for.
  let customizableMarkerType = GMTCCustomizableMarkerType.tripVehicle

  // Initializing marker options.
  let markerStyleOptions = GMTCMutableMarkerStyleOptions()
  markerStyleOptions.groundAnchor = kGMSMarkerDefaultGroundAnchor
  markerStyleOptions.icon = icon
  markerStyleOptions.zIndex = 100
  markerStyleOptions.isFlat = false
  markerStyleOptions.isVisible = true

  consumerMapStyleCoordinator.setMarkerStyleOptions(markerStyleOptions, markerType: customizableMarkerType)

  // Reset marker options to default values.
  consumerMapStyleCoordinator.setMarkerStyleOptions(nil, markerType: customizableMarkerType)
}

Objective-C

/** MapViewController.m */

- (void)updateMarkerUIOptions {
  // Get the GMTCConsumerMapStyleCoordinator
  GMTCConsumerMapStyleCoordinator *consumerMapStyleCoordinator = [_mapView consumerMapStyleCoordinator];

  // The marker type that you would like to set custom UI options for.
  GMTCCustomizableMarkerType customizableMarkerType = GMTCCustomizableMarkerTypeTripVehicle;

  // Initializing marker options.
  GMTCMutableMarkerStyleOptions *markerStyleOptions =
      [[GMTCMutableMarkerStyleOptions alloc] init];
  markerStyleOptions.groundAnchor = kGMSMarkerDefaultGroundAnchor;
  markerStyleOptions.icon = icon;
  markerStyleOptions.zIndex = 100;
  markerStyleOptions.isFlat = NO;
  markerStyleOptions.isVisible = YES;

  [consumerMapStyleCoordinator setMarkerStyleOptions:markerStyleOptions markerType:customizableMarkerType];

  // Reset marker options to default values.
  [consumerMapStyleCoordinator setMarkerStyleOptions:nil markerType:customizableMarkerType];
}

การอัปเดตเวลาถึงโดยประมาณแบบไดนามิกสำหรับเครื่องหมายรับสินค้า

หากต้องการสร้างเครื่องหมายการรับสินค้าที่แสดงเวลาถึงโดยประมาณที่อัปเดตแบบไดนามิกเป็นระยะๆ อัปเดตตัวเลือกรูปแบบเครื่องหมายสำหรับ GMTCCustomizableMarkerType.tripPickupPoint

ตัวอย่าง

Swift

/** MapViewController.swift */

/// Updates the ETA every minute by creating a Timer that repeats every minute.
private func schedulePickupMarkerStyleUpdates() {
  Timer.scheduledTimer(
    timeInterval: 60.0,  // Update marker ETA every minute.
    target: self,
    selector: #selector(updatePickupMarkerETA),
    userInfo: nil,
    repeats: true)
}

/// Updates the marker options for GMTCCustomizableMarkerType.tripPickupPoint for the current time.
@objc private func updatePickupMarkerETA() {
  let consumerMapStyleCoordinator = mapView.consumerMapStyleCoordinator
  let previousOptions = consumerMapStyleCoordinator.markerStyleOptions(for: .tripPickupPoint)

  // Get updated ETA icon.
  let updatedETAIcon = pickupIconForCurrentTime()

  let markerStyleOptions = GMTCMutableMarkerStyleOptions()
  markerStyleOptions.groundAnchor = kGMSMarkerDefaultGroundAnchor
  markerStyleOptions.icon = updatedETAIcon
  markerStyleOptions.zIndex = 100
  markerStyleOptions.isFlat = false
  markerStyleOptions.isVisible = true

  consumerMapStyleCoordinator.setMarkerStyleOptions(markerStyleOptions, markerType: .tripPickupPoint)
}

Objective-C

/** MapViewController.m */

/** Updates the ETA every minute by creating an NSTimer that repeats every minute. */
- (void)schedulePickupMarkerStyleUpdates {
  [NSTimer scheduledTimerWithTimeInterval:60.0 // Update marker ETA every minute.
                                   target:self
                                 selector:@selector(updatePickupMarkerETA)
                                 userInfo:nil
                                  repeats:YES];
}

/** Updates the marker options for GMTCCustomizableMarkerTypeTripPickupPoint for the current time. */
- (void)updatePickupMarkerETA {
  GMTCConsumerMapStyleCoordinator *consumerMapStyleCoordinator = [_mapView consumerMapStyleCoordinator];
  GMTCMarkerStyleOptions *previousOptions = [consumerMapStyleCoordinator markerStyleOptionsForType:GMTCCustomizableMarkerTypeTripPickupPoint];

  // Get updated ETA icon.
  UIImage *updatedETAIcon = [self pickupIconForCurrentTime];

  GMTCMutableMarkerStyleOptions *markerStyleOptions =
                               [[GMTCMutableMarkerStyleOptions alloc] init];
  markerStyleOptions.groundAnchor = kGMSMarkerDefaultGroundAnchor;
  markerStyleOptions.icon = updatedETAIcon;
  markerStyleOptions.zIndex = 100;
  markerStyleOptions.isFlat = NO;
  markerStyleOptions.isVisible = YES;

  [consumerMapStyleCoordinator setMarkerStyleOptions:markerStyleOptions markerType:GMTCCustomizableMarkerTypeTripPickupPoint];
}

ขั้นตอนถัดไป