MapboxGL.MapView

整理自官方文档，错误之处欢迎指正。

<MapboxGL.MapView />

props 属性

Prop	Type	Default	Required
contentInset	union	none	false

The distance from the edges of the map view’s frame to the edges of the map view’s logical viewport.
从地图视图框架的边缘到地图视图逻辑视口边缘的距离。

style	any	none	false

Style for wrapping React Native View
所在RN视图的样式

styleURL	string	MapboxGL.StyleURL.Street	false

Style URL for map
地图的样式URL

localizeLabels	bool	false	false

Automatically change the language of the map labels to the system’s preferred language,this is not something that can be toggled on/off
自动将地图标签的语言更改为系统的首选语言，这不能切换为打开/关闭

zoomEnabled	bool	none	false

Enable/Disable zoom on the map
在地图上启用/禁用缩放

scrollEnabled	bool	true	false

Enable/Disable scroll on the map
在地图上启用/禁用滚动

pitchEnabled	bool	true	false

Enable/Disable pitch on map
在地图上启用/禁用倾斜

rotateEnabled	bool	true	false

Enable/Disable rotation on map
在地图上启用/禁用旋转

attributionEnabled	bool	true	false

是否显示属性说明
The Mapbox terms of service, which governs the use of Mapbox-hosted vector tiles and styles,
requires these copyright notices to accompany any map that features Mapbox-designed styles, OpenStreetMap data, or other Mapbox data such as satellite or terrain data.
If that applies to this map view, do not hide this view or remove any notices from it.

You are additionally required to provide users with the option to disable anonymous usage and location sharing (telemetry).
If this view is hidden, you must implement this setting elsewhere in your app. See our website for Android and iOS for implementation details.

Enable/Disable attribution on map. For iOS you need to add MGLMapboxMetricsEnabledSettingShownInApp=YES
to your Info.plist
Mapbox服务条款，管理Mapbox托管的矢量切片和样式的使用，这些版权声明随附任何具有Mapbox设计样式，OpenStreetMap数据，或其他Mapbox数据，例如卫星或地形数据。如果这适用于此地图视图，请勿隐藏此视图或从中删除任何通知。
您还需要为用户提供禁用匿名使用和位置共享(遥测)的选项。如果此视图被隐藏，你必须在你的应用程序的其他地方实现此设置。

logoEnabled	bool	true	false

Enable/Disable the logo on the map.
启用/禁用地图上的 logo 。

compassEnabled	bool	none	false

Enable/Disable the compass from appearing on the map
启用/禁用指南针显示在地图上

surfaceView	bool	false	false

[Android only] Enable/Disable use of GLSurfaceView insted of TextureView.
[仅Android]启用/禁用TextureView的GLSurfaceView实例。

onPress	func	none	false

Map press listener, gets called when a user presses the map
地图按下侦听器，当用户按下地图时被调用

onLongPress	func	none	false

Map long press listener, gets called when a user long presses the map
地图长按侦听器，当用户长按地图时调用

onRegionWillChange	func	none	false

This event is triggered whenever the currently displayed map region is about to change.
只要当前显示的地图区域即将更改，就会触发此事件。

onRegionIsChanging	func	none	false

This event is triggered whenever the currently displayed map region is changing.
只要当前显示的地图区域发生变化，就会触发此事件。

onRegionDidChange	func	none	false

This event is triggered whenever the currently displayed map region finished changing
只要当前显示的地图区域完成更改，就会触发此事件

onWillStartLoadingMap	func	none	false

This event is triggered when the map is about to start loading a new map style.
当地图即将开始加载新的地图样式时，会触发此事件。

onDidFinishLoadingMap	func	none	false

This is triggered when the map has successfully loaded a new map style.
当地图成功加载新的地图样式时，会触发此事件。

onDidFailLoadingMap	func	none	false

This event is triggered when the map has failed to load a new map style.
当地图加载新地图样式失败时，会触发此事件。

onWillStartRenderingFrame	func	none	false

This event is triggered when the map will start rendering a frame.
当贴图开始渲染帧时，会触发此事件。

onDidFinishRenderingFrame	func	none	false

This event is triggered when the map finished rendering a frame.
此事件在地图完成渲染帧时触发。

onDidFinishRenderingFrameFully	func	none	false

This event is triggered when the map fully finished rendering a frame.
当地图完全完成渲染帧时，会触发此事件。

onWillStartRenderingMap	func	none	false

This event is triggered when the map will start rendering the map.
当地图开始渲染地图时，会触发此事件。

onDidFinishRenderingMap	func	none	false

This event is triggered when the map finished rendering the map.
此事件在地图完成渲染地图时触发。

onDidFinishRenderingMapFully	func	none	false

This event is triggered when the map fully finished rendering the map.
当地图完全完成渲染地图时，会触发此事件。

onDidFinishLoadingStyle	func	none	false

This event is triggered when a style has finished loading.
当样式加载完成时触发此事件。

regionWillChangeDebounceTime	number	10	false

The emitted frequency of region will change events

regionDidChangeDebounceTime	number	500	false

The emitted frequency of region did change events

methods 方法

getPointInView(coordinate)

Converts a geographic coordinate to a point in the given view’s coordinate system.
将地理坐标转换为给定视图坐标系中的点。

arguments

Name	Type	Required	Description
coordinate	Array	Yes	A point expressed in the map view's coordinate system.

在地图视图的坐标系中表示的点。

const pointInView = await this._map.getPointInView([-37.817070, 144.949901]);

getCoordinateFromView(point)

Converts a point in the given view’s coordinate system to a geographic coordinate.
将给定视图坐标系中的点转换为地理坐标。

arguments

Name	Type	Required	Description
point	Array	Yes	A point expressed in the given view’s coordinate system.

const coordinate = await this._map.getCoordinateFromView([100, 100]);

getVisibleBounds()

The coordinate bounds(ne, sw) visible in the users’s viewport.
在用户视口中可见的坐标边界(ne，sw)。

arguments

Name	Type	Required	Description

const visibleBounds = await this._map.getVisibleBounds();

queryRenderedFeaturesAtPoint(coordinate[, filter][, layerIDs])

Returns an array of rendered map features that intersect with a given point.
返回与给定点相交的渲染地图要素的数组。

arguments

Name	Type	Required	Description
coordinate	Array	Yes	A point expressed in the map view’s coordinate system.
filter	Array	No	A set of strings that correspond to the names of layers defined in the current style. Only the features contained in these layers are included in the returned array.
layerIDs	Array	No	A array of layer id's to filter the features by

this._map.queryRenderedFeaturesAtPoint([30, 40], ['==', 'type', 'Point'], ['id1', 'id2'])

queryRenderedFeaturesInRect(bbox[, filter][, layerIDs])

Returns an array of rendered map features that intersect with the given rectangle,restricted to the given style layers and filtered by the given predicate.
返回与给定矩形相交、仅限于给定样式图层并由给定谓词过滤的渲染地图要素数组。

arguments

Name	Type	Required	Description
bbox	Array	Yes	A rectangle expressed in the map view’s coordinate system.
filter	Array	No	A set of strings that correspond to the names of layers defined in the current style. Only the features contained in these layers are included in the returned array.
layerIDs	Array	No	A array of layer id's to filter the features by

this._map.queryRenderedFeaturesInRect([30, 40, 20, 10], ['==', 'type', 'Point'], ['id1', 'id2'])

fitBounds(northEastCoordinates, southWestCoordinates[, padding][, duration])

Map camera transitions to fit provided bounds
映射摄影机过渡以适应提供的边界

arguments

Name	Type	Required	Description
northEastCoordinates	Array	Yes	North east coordinate of bound
southWestCoordinates	Array	Yes	South west coordinate of bound
padding	Number	No	Camera padding for bound
duration	Number	No	Duration of camera animation

this.map.fitBounds([lng, lat], [lng, lat])
this.map.fitBounds([lng, lat], [lng, lat], 20, 1000) // padding for all sides
this.map.fitBounds([lng, lat], [lng, lat], [verticalPadding, horizontalPadding], 1000)
this.map.fitBounds([lng, lat], [lng, lat], [top, right, bottom, left], 1000)

flyTo(coordinates[, duration])

Map camera will fly to new coordinate
地图相机将飞到新坐标

arguments

Name	Type	Required	Description
coordinates	Array	Yes	Coordinates that map camera will jump too
duration	Number	No	Duration of camera animation

this.map.flyTo([lng, lat])
this.map.flyTo([lng, lat], 12000)

moveTo(coordinates[, duration])

Map camera will move to new coordinate at the same zoom level
地图相机将移动到相同缩放级别的新坐标

arguments

Name	Type	Required	Description
coordinates	Array	Yes	Coordinates that map camera will move too
duration	Number	No	Duration of camera animation

this.map.moveTo([lng, lat], 200) // eases camera to new location based on duration
this.map.moveTo([lng, lat]) // snaps camera to new location without any easing

zoomTo(zoomLevel[, duration])

Map camera will zoom to specified level
地图相机将缩放到指定级别

arguments

Name	Type	Required	Description
zoomLevel	Number	Yes	Zoom level that the map camera will animate too
duration	Number	No	Duration of camera animation

this.map.zoomTo(16)
this.map.zoomTo(16, 100)

setCamera(config)

Map camera will perform updates based on provided config. Deprecated use Camera#setCamera.

arguments

Name	Type	Required	Description
config	n/a	Yes	undefined

takeSnap(writeToDisk)

Takes snapshot of map with current tiles and returns a URI to the image
拍摄包含当前切片的地图快照，并将URI返回到图像

arguments

Name	Type	Required	Description
writeToDisk	Boolean	Yes	If true will create a temp file, otherwise it is in base64

getZoom()

Returns the current zoom of the map view.
返回地图视图的当前缩放。

arguments

Name	Type	Required	Description

const zoom = await this._map.getZoom();

getCenter()

Returns the map's geographical centerpoint
返回地图的地理中心点

arguments

Name	Type	Required	Description

const center = await this._map.getCenter();

showAttribution()

Show the attribution and telemetry action sheet.
If you implement a custom attribution button, you should add this action to the button.
显示属性和遥测操作表。
如果实现自定义属性按钮，则应将此操作添加到按钮。

arguments

Name	Type	Required	Description