開始使用

選取平台： Android iOS JavaScript

請按照下列步驟設定資料集資料導向樣式。

取得 API 金鑰並啟用 API

您需要擁有已連結帳單帳戶的 Cloud 專案，並啟用 Maps SDK for iOS 和 Maps Datasets API，才能使用資料集資料導向樣式。詳情請參閱：

建立地圖 ID

mapID 是一組不重複識別碼，代表單一 Google 地圖例項。您可隨時在 Google Cloud Console 中建立地圖 ID，並更新與地圖 ID 相關聯的樣式。

Google Cloud 控制台的螢幕截圖

建立新地圖樣式

如要建立新地圖樣式，請按照「管理地圖樣式」一文中的說明建立樣式。完成後，請將樣式與新建立的地圖 ID 建立關聯。

更新地圖初始化程式碼

這個步驟需要將地圖 ID 與已啟用一或多個地圖項目圖層的樣式建立關聯。如要確認 Cloud 控制台中的地圖 ID 設定正確無誤，請查看「地圖管理」下方的設定方式。

Swift

// A map ID using a style with one or more feature layers enabled

let mapID = GMSMapID(identifier: "YOUR_MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7))

Objective-C

// A map ID using a style with one or more feature layers enabled

GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]];

檢查地圖功能

如要使用資料集資料導向樣式，就必須在 Google Cloud 控制台啟用相關功能，並與地圖 ID 建立關聯。由於地圖 ID 可能會變更，您可以在 GMSMapView 上呼叫 mapView.mapCapabilities，確認特定功能 (例如資料導向樣式) 是否可用，再進行呼叫。

您也可以訂閱 GMSViewDelegate，偵測地圖功能的變更。本例說明如何使用這個通訊協定，檢查資料導向樣式需求。

Swift

class SampleViewController: UIViewController {

  private lazy var mapView: GMSMapView = GMSMapView(frame: .zero, mapID: GMSMapID(identifier: "YOUR_MAP_ID"), camera: GMSCameraPosition(latitude: 40, longitude: -80, zoom: 7))

  override func loadView() {
    self.view = mapView
    mapView.delegate = self
  }
}

extension SampleViewController: GMSMapViewDelegate {
  func mapView(_ mapView: GMSMapView, didChange mapCapabilities: GMSMapCapabilityFlags) {
    if (!mapCapabilities.contains(.dataDrivenStyling)) {
      // Data-driven styling is *not* available, add a fallback.
      // Existing feature layers are also unavailable.
    }
  }
}

Objective-C

@interface SampleViewController: UIViewController <GMSMapViewDelegate>
@end

@implementation SampleViewController
- (void)loadView {
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:[GMSMapID mapIDWithIdentifier:@"MAP_ID"] camera:[GMSCameraPosition cameraWithLatitude:40 longitude:-80 zoom:7]];
  mapView.delegete = self;
  self.view = mapView;
}

- (void)mapView:(GMSMapView *)mapView didChangeMapCapabilities:(GMSMapCapabilityFlags)mapCapabilities {
  if (!(mapCapabilities & GMSMapCapabilityFlagsDataDrivenStyling)) {
    // Data-driven styling is *not* available, add a fallback.
    // Existing feature layers are also unavailable.
  }
}
@end

後續步驟