GMSFeatureLayer 类参考

GMSFeatureLayer 类参考

概览

一个类,表示同一 GMSFeatureType 的所有地图项的集合,其样式可以在客户端上替换。

每个 GMSFeatureType 都有一个对应的 GMSFeatureLayer

继承自 GMSDatasetFeatureLayer

公开成员函数

(实例类型)- initWithFeatureType
 创建用于测试的地图项图层实例。

属性

GMSFeatureTypefeatureType
 与此图层相关联的地图项类型。
BOOL 可用
 确定以数据为依据的 GMSFeatureLayer 是否可用。
GMSFeatureStyle *_Nullable(^)(T)样式
 要应用到此图层中所有地图项的样式块。

成员函数文档

- (instancetype) initWithFeatureType: (GMSFeatureType) featureType

创建用于测试的地图项图层实例。

此方法应仅用于单元测试。在生产环境中,GMSFeatureLayer 实例只能由 SDK 创建。


属性说明

- (GMSFeatureType) featureType [read, assign]

与此图层相关联的地图项类型。

与该图层相关的所有地图项都将是此类型。

- (BOOL) 可用 [read, assign]

确定以数据为依据的 GMSFeatureLayer 是否可用。

数据驱动型样式需要金属框架、有效的地图 ID 和应用地图项类型。如果为 NO,则 GMSFeatureLayer 的样式将恢复为默认值,并且不会触发事件。

- (GMSFeatureStyle* _Nullable(^ 样式)(T)) [read, write, assign]

要应用到此图层中所有地图项的样式块。

调用 setter 时,样式块将应用于视口中的所有可见地图项,并且将多次针对进入视口的后续地图项运行。

应用于地图图块时,该函数必须具有确定性,并且能够返回一致的结果。如果任何地图项的任何样式规范会发生变化,则必须重新设置 style。在未调用 style setter 的情况下更改样式块的行为将导致未定义的行为,包括过时和/或破碎的地图渲染。请参阅下面的示例:

 {.swift}
 var selectedPlaceIDs = Set<String>()
 var style = FeatureStyle(fill: .red, stroke: .clear, strokeWidth: 0)
 layer.style = { feature in
   selectedPlaceIDs.contains(feature.placeID) ? style : nil
 }
 selectedPlaceIDs.insert("foo")
 style = FeatureStyle(fill: .clear, stroke: .blue, strokeWidth: 1.5)
 layer.style = { feature in
   selectedPlaceIDs.contains(feature.placeID) ? style : nil
 }