Data-driven styling (beta)

FeatureLayer 接口

google.maps.FeatureLayer接口

一个接口,表示包含特定 FeatureType 地图项的地图层,其样式可被客户端替换,或者附加了事件。

featureType
类型FeatureType
与此 FeatureLayer 关联的 FeatureType
isAvailable
类型boolean
FeatureLayer是否可用,这意味着此地图是否提供以数据为依据的样式(在 Google Cloud Console 地图样式中启用了此FeatureLayer的矢量图块)。如果为 false(或变为 false),则此 FeatureLayer 上的样式将还原为默认值,并且不会触发事件。
style optional
FeatureLayerFeature 的样式。设置样式后会应用样式。如果样式函数更新,您必须重新设置样式属性。对地图图块应用 FeatureStyleFunction 时,它必须返回一致的结果,并且应针对性能进行优化。不支持异步函数。如果您使用 FeatureStyleOptions,则该图层的所有地图项都将使用同一 FeatureStyleOptions 设置样式。将样式设为 null 可移除之前设置的样式。如果此 FeatureLayer 不可用,则设置样式将不执行任何操作并记录错误。
addListener
addListener(eventName, handler)
参数
  • eventNamestring 观测到的事件。
  • handler:用于处理事件的函数。Function
返回值MapsEventListener 生成的事件监听器。
将给定的监听器函数添加到给定的事件名称。返回此监听器可与 event.removeListener 配合使用的标识符。

FeatureType 常量

google.maps.FeatureType 常量

特征类型的标识符。

通过调用 const {FeatureType} = await google.maps.importLibrary("maps") 访问。请参阅 Maps JavaScript API 中的库

ADMINISTRATIVE_AREA_LEVEL_1 表示国家/地区级别以下的一级行政实体。
ADMINISTRATIVE_AREA_LEVEL_2 表示国家/地区级别以下的二级行政实体。
COUNTRY 表示国家政治实体。
LOCALITY 表示合并的城市或城镇政治实体。
POSTAL_CODE 表示邮政编码,用于国家/地区内的地址邮寄。

FeatureStyleFunction 类型定义符

google.maps.FeatureStyleFunction类型定义符

用于设置 FeatureLayer 样式的函数。

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

FeatureStyleFunctionOptions 接口

google.maps.FeatureStyleFunctionOptions接口

传递给 FeatureStyleFunction 的选项。

feature
类型Feature
Feature 会传递到 FeatureStyleFunction 中以设置样式。

FeatureStyleOptions 接口

google.maps.FeatureStyleOptions接口

这些选项用于指定应如何在地图上修改 Feature 的样式。

fillColor optional
类型string optional
十六进制 RGB 字符串(如“#00FF00”,表示绿色)。仅适用于多边形几何图形。
fillOpacity optional
类型number optional
填充不透明度,介于 0.0 和 1.0 之间。仅适用于多边形几何图形。
strokeColor optional
类型string optional
十六进制 RGB 字符串(如“#00FF00”,表示绿色)。
strokeOpacity optional
类型number optional
描边不透明度介于 0.0 和 1.0 之间。仅适用于线和多边形几何图形。
strokeWeight optional
类型number optional
描边宽度(以像素为单位)。仅适用于线和多边形几何图形。

功能接口

google.maps.Feature接口

表示矢量地图图块功能的接口。这些是 FeatureStyleFunction 的输入。请勿保存对特定 Feature 对象的引用,因为此类引用不稳定。

featureType
类型FeatureType
FeatureFeatureType

PlaceFeature 接口

google.maps.PlaceFeature接口

一个表示地点 ID 为特征的接口,其中包含 FeatureType.ADMINISTRATIVE_AREA_LEVEL_1FeatureType.ADMINISTRATIVE_AREA_LEVEL_2FeatureType.COUNTRYFeatureType.LOCALITYFeatureType.POSTAL_CODE 类型的特征。

此接口扩展了 Feature

placeId
类型string
继承的设置featureType
fetchPlace
fetchPlace()
参数:无
返回值Promise<Place>
获取此 PlaceFeaturePlace。在生成的 Place 对象中,系统将填充 iddisplayName 属性。(后续可通过 Place.fetchFields() 请求获取更多字段,前提是普通地点 API 启用和结算。)请勿从 FeatureStyleFunction 调用此方法,因为仅支持同步 FeatureStyleFunctions。如果提取 Place 时出错,promise 会被拒绝。

FeatureMouseEvent 接口

google.maps.FeatureMouseEvent接口

此对象是从 FeatureLayer 上的鼠标事件返回的。

此接口扩展了 MapMouseEvent

features
类型Array<Feature>
此鼠标事件中的 Feature
继承的设置domEventlatLng
继承的设置stop