@rnmapbox/maps 10.0.0-beta.33 → 10.0.0-beta.34

package/docs/Logger.md

@@ -1,23 +1,22 @@
-## Logger
-###
+# Logger
 
-### methods
-#### setLogLevel(LogLevel)
+## methods
+### setLogLevel(LogLevel)
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `LogLevel` | `String` | `Yes` | required level of logging, can be `"error" | "warning" | "info" | "debug" | "verbose"` |
 
-##### Description
+#### Description
 sets the amount of logging
 
-#### setLogCallback(LogCallback)
+### setLogCallback(LogCallback)
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `LogCallback` | `function` | `Yes` | callback taking a log object `{ message: String, level: LogLevel, tag: String }` as param. If callback return falsy value then default logging will take place.  |
 
-##### Description
+#### Description
 overwrite logging - good to mute specific errors/ warnings

package/docs/MapView.md

@@ -1,15 +1,15 @@
 <!-- This file was autogenerated from MapView.js do not modify -->
-## <MapboxGL.MapView />
-### MapView backed by Mapbox Native GL
+# <MapboxGL.MapView />
+MapView backed by Mapbox Native GL
 
-### props
+## props
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | 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 |
 | styleURL | `string` | `none` | `false` | Style URL for map - notice, if non is set it _will_ default to `MapboxGL.StyleURL.Street` |
 | styleJSON | `string` | `none` | `false` | StyleJSON for map - according to TileJSON specs: https://github.com/mapbox/tilejson-spec |
-| preferredFramesPerSecond | `number` | `none` | `false` | iOS: The preferred frame rate at which the map view is rendered.<br/>The default value for this property is MGLMapViewPreferredFramesPerSecondDefault,<br/>which will adaptively set the preferred frame rate based on the capability of<br/>the user’s device to maintain a smooth experience. This property can be set to arbitrary integer values.<br/><br/>Android: The maximum frame rate at which the map view is rendered, but it can't excess the ability of device hardware.<br/>This property can be set to arbitrary integer values. |
+| preferredFramesPerSecond | `number` | `none` | `false` | iOS: The preferred frame rate at which the map view is rendered.<br/>The default value for this property is MGLMapViewPreferredFramesPerSecondDefault,<br/>which will adaptively set the preferred frame rate based on the capability of<br/>the user’s device to maintain a smooth experience. This property can be set to arbitrary integer values.<br/><br/>Android: The maximum frame rate at which the map view is rendered, but it can't exceed the ability of device hardware.<br/>This property can be set to arbitrary integer values. |
 | localizeLabels | `bool` | `false` | `false` | Automatically change the language of the map labels to the system’s preferred language,<br/>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 |
@@ -27,7 +27,7 @@
 | compassViewMargins | `object` | `none` | `false` | Add margins to the compass with x and y values |
 | scaleBarEnabled | `bool` | `true` | `false` | [`mapbox` (v10) implementation only] Enable/Disable the scale bar from appearing on the map |
 | scaleBarPosition | `custom` | `none` | `false` | [`mapbox` (v10) implementation only] Adds scale bar offset, e.g. `{top: 8, left: 8}` will put the scale bar in top-left corner of the map |
-| surfaceView | `bool` | `false` | `false` | [Android only] Enable/Disable use of GLSurfaceView insted of TextureView. |
+| surfaceView | `bool` | `false` | `false` | [Android only] Enable/Disable use of GLSurfaceView instead of TextureView. |
 | 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` | <v10 only<br/><br/>This event is triggered whenever the currently displayed map region is about to change. |
@@ -49,12 +49,12 @@
 | regionWillChangeDebounceTime | `number` | `10` | `false` | The emitted frequency of regionwillchange events |
 | regionDidChangeDebounceTime | `number` | `500` | `false` | The emitted frequency of regiondidchange events |
 
-### methods
-#### getPointInView(coordinate)
+## methods
+### getPointInView(coordinate)
 
 Converts a geographic coordinate to a point in the given view’s coordinate system.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `coordinate` | `Array` | `Yes` | A point expressed in the map view's coordinate system. |
@@ -66,11 +66,11 @@ const pointInView = await this._map.getPointInView([-37.817070, 144.949901]);
 ```
 
 
-#### getCoordinateFromView(point)
+### getCoordinateFromView(point)
 
 Converts a point in the given view’s coordinate system to a geographic coordinate.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `point` | `Array` | `Yes` | A point expressed in the given view’s coordinate system. |
@@ -82,11 +82,11 @@ const coordinate = await this._map.getCoordinateFromView([100, 100]);
 ```
 
 
-#### getVisibleBounds()
+### getVisibleBounds()
 
-The coordinate bounds(ne, sw) visible in the users’s viewport.
+The coordinate bounds (ne, sw) visible in the user’s viewport.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 
@@ -98,11 +98,11 @@ const visibleBounds = await this._map.getVisibleBounds();
 ```
 
 
-#### queryRenderedFeaturesAtPoint(coordinate[, filter][, layerIDs])
+### queryRenderedFeaturesAtPoint(coordinate[, filter][, layerIDs])
 
 Returns an array of rendered map features that intersect with a given point.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `coordinate` | `Array` | `Yes` | A point expressed in the map view’s coordinate system. |
@@ -116,11 +116,11 @@ this._map.queryRenderedFeaturesAtPoint([30, 40], ['==', 'type', 'Point'], ['id1'
 ```
 
 
-#### queryRenderedFeaturesInRect(bbox[, filter][, layerIDs])
+### queryRenderedFeaturesInRect(bbox[, filter][, layerIDs])
 
 Returns an array of rendered map features that intersect with the given rectangle,<br/>restricted to the given style layers and filtered by the given predicate.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `bbox` | `Array` | `Yes` | A rectangle expressed in the map view’s coordinate system. |
@@ -134,31 +134,31 @@ this._map.queryRenderedFeaturesInRect([30, 40, 20, 10], ['==', 'type', 'Point'],
 ```
 
 
-#### setCamera()
+### setCamera()
 
 Map camera will perform updates based on provided config. Deprecated use Camera#setCamera.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 
 
 
-#### takeSnap(writeToDisk)
+### takeSnap([writeToDisk])
 
 Takes snapshot of map with current tiles and returns a URI to the image
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
-| `writeToDisk` | `Boolean` | `Yes` | If true will create a temp file, otherwise it is in base64 |
+| `writeToDisk` | `Boolean` | `No` | If true will create a temp file, otherwise it is in base64 |
 
 
-#### getZoom()
+### getZoom()
 
 Returns the current zoom of the map view.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 
@@ -170,11 +170,11 @@ const zoom = await this._map.getZoom();
 ```
 
 
-#### getCenter()
+### getCenter()
 
 Returns the map's geographical centerpoint
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 
@@ -186,21 +186,21 @@ const center = await this._map.getCenter();
 ```
 
 
-#### queryTerrainElevation(coordinate)
+### queryTerrainElevation(coordinate)
 
 Queries the currently loaded data for elevation at a geographical location.<br/>The elevation is returned in meters relative to mean sea-level.<br/>Returns null if terrain is disabled or if terrain data for the location hasn't been loaded yet.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `coordinate` | `Array` | `Yes` | the coordinates to query elevation at |
 
 
-#### setSourceVisibility(visible, sourceId[, sourceLayerId])
+### setSourceVisibility(visible, sourceId[, sourceLayerId])
 
 Sets the visibility of all the layers referencing the specified `sourceLayerId` and/or `sourceId`
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `visible` | `boolean` | `Yes` | Visibility of the layers |
@@ -214,11 +214,11 @@ await this._map.setSourceVisibility(false, 'composite', 'building')
 ```
 
 
-#### showAttribution()
+### showAttribution()
 
 Show the attribution and telemetry action sheet.<br/>If you implement a custom attribution button, you should add this action to the button.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 

package/docs/MapboxGL.md

@@ -1,84 +1,83 @@
-## MapboxGL
-###
+# MapboxGL
 
-### methods
-#### setAccessToken(accessToken)
+## methods
+### setAccessToken(accessToken)
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `accessToken` | `String` | `Yes` | required acessToken to pull mapbox tiles, can be `null` if other tiles are used |
 
-##### Description
+#### Description
 sets the accessToken, which is required when you want to use mapbox tiles
 not required when using other tiles
 
-#### setWellKnownTileServer(tileServer)
+### setWellKnownTileServer(tileServer)
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `tileServer` | `String` | `Yes` | tile server |
 
-##### Description
+#### Description
 No-op on non MapLibre implemntations. Use MapboxGL.TileServer.Mapbox to consume mapbox tiles with maplibre. *Note*: Consuming mapbox with MapLibre has different pricing than with the official SDK. Other values: MapboxGL.TileServer.MapLibre, MapboxGL.TileServer.MapTiler
 
-#### getAccessToken()
+### getAccessToken()
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `accessToken` | `String` | `Yes` | required acessToken to pull mapbox tiles, can be `null` if other tiles are used |
 
-##### Description
+#### Description
 gets the accessToken
 
 
-#### addCustomHeader(headerName, headerValue)
+### addCustomHeader(headerName, headerValue)
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `headerName` | `String` | `Yes` | name for customHeader |
 | `headerValue` | `String` | `Yes` | value for customHeader |
 
-##### Description
+#### Description
 also see [CustomHttpHeaders](/docs/CustomHttpHeaders.md)
 
 
-#### removeCustomHeader(headerName)
+### removeCustomHeader(headerName)
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `headerName` | `String` | `Yes` | name of customHeader to be removed |
 
-##### Description
+#### Description
 also see [CustomHttpHeaders](/docs/CustomHttpHeaders.md)
 
-#### setTelemetryEnabled(telemetryEnabled)
+### setTelemetryEnabled(telemetryEnabled)
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `telemetryEnabled` | `Boolean` | `Yes` |  |
 
-##### Description
+#### Description
 If mapbox' telemetry should be enabled or not
 
-### Android only
-#### requestAndroidLocationPermissions()
-##### Description
+## Android only
+### requestAndroidLocationPermissions()
+#### Description
 Opens Android Location Permission prompt.
 Returns a Promise which resolves into a boolean.
 Either permission was granted or denied.
 
 
-#### setConnected(connected)
-##### arguments
+### setConnected(connected)
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `connected` | `Boolean` | `Yes` | whether or not mapbox is told to be connected or not |
 
-#### Description
+### Description
 If you want to fully block online map - maybe to force offline maps

package/docs/MarkerView.md

@@ -1,14 +1,19 @@
-<!-- This file was autogenerated from MarkerView.js do not modify -->
-## <MapboxGL.MarkerView />
-### MarkerView allows you to place a interactive react native marker to the map.<br/><br/>If you have static view consider using PointAnnotation or SymbolLayer they'll offer much better performance<br/>.<br/>This is based on [MakerView plugin](https://docs.mapbox.com/android/plugins/overview/markerview/) on Android<br/>and PointAnnotation on iOS.
+<!-- This file was autogenerated from MarkerView.tsx do not modify -->
+# <MapboxGL.MarkerView />
+MarkerView allows you to place a interactive react native marker to the map.
 
-### props
+If you have static view consider using PointAnnotation or SymbolLayer they'll offer much better performance
+.
+This is based on [MakerView plugin](https://docs.mapbox.com/android/plugins/overview/markerview/) on Android
+and PointAnnotation on iOS.
+
+## props
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
-| coordinate | `array` | `none` | `true` | The center point (specified as a map coordinate) of the marker.<br/>See also #anchor. |
+| coordinate | `tuple` | `none` | `true` | The center point (specified as a map coordinate) of the marker.<br/>See also #anchor. |
 | anchor | `shape` | `{ x: 0.5, y: 0.5 }` | `false` | Specifies the anchor being set on a particular point of the annotation.<br/>The anchor point is specified in the continuous space [0.0, 1.0] x [0.0, 1.0],<br/>where (0, 0) is the top-left corner of the image, and (1, 1) is the bottom-right corner.<br/>Note this is only for custom annotations not the default pin view.<br/>Defaults to the center of the view. |
 | &nbsp;&nbsp;x | `number` | `none` | `true` | `x` of anchor |
 | &nbsp;&nbsp;y | `number` | `none` | `true` | `y` of anchor |
-| children | `element` | `none` | `true` | Expects one child - can be container with multiple elements |
+| children | `ReactReactElement` | `none` | `true` | Expects one child - can be container with multiple elements |
 
 

package/docs/NativeUserLocation.md

@@ -1,8 +1,8 @@
 <!-- This file was autogenerated from NativeUserLocation.js do not modify -->
-## <MapboxGL.NativeUserLocation />
-### 
+# <MapboxGL.NativeUserLocation />
 
-### props
+
+## props
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | androidRenderMode | `enum` | `none` | `false` | Android render mode.<br/><br/> - normal: just a circle<br/> - compass: triangle with heading<br/> - gps: large arrow<br/><br/>@platform android |

package/docs/OfflineManager.md

@@ -1,14 +1,16 @@
 <!-- This file was autogenerated from offlineManager.js do not modify -->
-## <MapboxGL.offlineManager />
-### OfflineManager implements a singleton (shared object) that manages offline packs.<br/>All of this class’s instance methods are asynchronous, reflecting the fact that offline resources are stored in a database.<br/>The shared object maintains a canonical collection of offline packs.
+# <MapboxGL.offlineManager />
+OfflineManager implements a singleton (shared object) that manages offline packs.
+All of this class’s instance methods are asynchronous, reflecting the fact that offline resources are stored in a database.
+The shared object maintains a canonical collection of offline packs.
 
 
-### methods
-#### createPack(options[, progressListener][, errorListener])
+## methods
+### createPack(options[, progressListener][, errorListener])
 
 Creates and registers an offline pack that downloads the resources needed to use the given region offline.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `options` | `OfflineCreatePackOptions` | `Yes` | Create options for a offline pack that specifices zoom levels, style url, and the region to download. |
@@ -31,11 +33,11 @@ await MapboxGL.offlineManager.createPack({
 ```
 
 
-#### invalidatePack(name)
+### invalidatePack(name)
 
 Invalidates the specified offline pack. This method checks that the tiles in the specified offline pack match those from the server. Local tiles that do not match the latest version on the server are updated.This is more efficient than deleting the offline pack and downloading it again. If the data stored locally matches that on the server, new data will not be downloaded.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `name` | `String` | `Yes` | Name of the offline pack. |
@@ -47,11 +49,11 @@ await MapboxGL.offlineManager.invalidatePack('packName')
 ```
 
 
-#### deletePack(name)
+### deletePack(name)
 
 Unregisters the given offline pack and allows resources that are no longer required by any remaining packs to be potentially freed.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `name` | `String` | `Yes` | Name of the offline pack. |
@@ -63,11 +65,11 @@ await MapboxGL.offlineManager.deletePack('packName')
 ```
 
 
-#### invalidateAmbientCache()
+### invalidateAmbientCache()
 
 Forces a revalidation of the tiles in the ambient cache and downloads a fresh version of the tiles from the tile server.<br/>This is the recommend method for clearing the cache.<br/>This is the most efficient method because tiles in the ambient cache are re-downloaded to remove outdated data from a device.<br/>It does not erase resources from the ambient cache or delete the database, which can be computationally expensive operations that may carry unintended side effects.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 
@@ -79,11 +81,11 @@ await MapboxGL.offlineManager.invalidateAmbientCache();
 ```
 
 
-#### clearAmbientCache()
+### clearAmbientCache()
 
 Erases resources from the ambient cache.<br/>This method clears the cache and decreases the amount of space that map resources take up on the device.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 
@@ -95,11 +97,11 @@ await MapboxGL.offlineManager.clearAmbientCache();
 ```
 
 
-#### migrateOfflineCache()
+### migrateOfflineCache()
 
 Migrates the offline cache from pre-v10 SDKs to the new v10 cache location
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 
@@ -111,11 +113,11 @@ await MapboxGL.offlineManager.migrateOfflineCache()
 ```
 
 
-#### setMaximumAmbientCacheSize(size)
+### setMaximumAmbientCacheSize(size)
 
 Sets the maximum size of the ambient cache in bytes. Disables the ambient cache if set to 0.<br/>This method may be computationally expensive because it will erase resources from the ambient cache if its size is decreased.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `size` | `Number` | `Yes` | Size of ambient cache. |
@@ -127,11 +129,11 @@ await MapboxGL.offlineManager.setMaximumAmbientCacheSize(5000000);
 ```
 
 
-#### resetDatabase()
+### resetDatabase()
 
 Deletes the existing database, which includes both the ambient cache and offline packs, then reinitializes it.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 
@@ -143,11 +145,11 @@ await MapboxGL.offlineManager.resetDatabase();
 ```
 
 
-#### getPacks()
+### getPacks()
 
 Retrieves all the current offline packs that are stored in the database.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 
@@ -159,11 +161,11 @@ const offlinePacks = await MapboxGL.offlineManager.getPacks();
 ```
 
 
-#### getPack(name)
+### getPack(name)
 
 Retrieves an offline pack that is stored in the database by name.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `name` | `String` | `Yes` | Name of the offline pack. |
@@ -175,11 +177,11 @@ const offlinePack = await MapboxGL.offlineManager.getPack();
 ```
 
 
-#### mergeOfflineRegions(path)
+### mergeOfflineRegions(path)
 
 Sideloads offline db
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `path` | `String` | `Yes` | Path to offline tile db on file system. |
@@ -191,11 +193,11 @@ await MapboxGL.offlineManager.mergeOfflineRegions(path);
 ```
 
 
-#### setTileCountLimit(limit)
+### setTileCountLimit(limit)
 
 Sets the maximum number of Mapbox-hosted tiles that may be downloaded and stored on the current device.<br/>The Mapbox Terms of Service prohibit changing or bypassing this limit without permission from Mapbox.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `limit` | `Number` | `Yes` | Map tile limit count. |
@@ -207,11 +209,11 @@ MapboxGL.offlineManager.setTileCountLimit(1000);
 ```
 
 
-#### setProgressEventThrottle(throttleValue)
+### setProgressEventThrottle(throttleValue)
 
 Sets the period at which download status events will be sent over the React Native bridge.<br/>The default is 500ms.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `throttleValue` | `Number` | `Yes` | event throttle value in ms. |
@@ -223,11 +225,11 @@ MapboxGL.offlineManager.setProgressEventThrottle(500);
 ```
 
 
-#### subscribe(packName, progressListener, errorListener)
+### subscribe(packName, progressListener, errorListener)
 
 Subscribe to download status/error events for the requested offline pack.<br/>Note that createPack calls this internally if listeners are provided.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `packName` | `String` | `Yes` | Name of the offline pack. |
@@ -243,11 +245,11 @@ MapboxGL.offlineManager.subscribe('packName', progressListener, errorListener)
 ```
 
 
-#### unsubscribe(packName)
+### unsubscribe(packName)
 
 Unsubscribes any listeners associated with the offline pack.<br/>It's a good idea to call this on componentWillUnmount.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 | `packName` | `String` | `Yes` | Name of the offline pack. |

package/docs/PointAnnotation.md

@@ -1,8 +1,14 @@
 <!-- This file was autogenerated from PointAnnotation.js do not modify -->
-## <MapboxGL.PointAnnotation />
-### PointAnnotation represents a one-dimensional shape located at a single geographical coordinate.<br/><br/>Consider using ShapeSource and SymbolLayer instead, if you have many points and you have static images,<br/>they'll offer much better performance.<br/><br/>If you need interactive views please use MarkerView,<br/>as with PointAnnotation on Android child views are rendered onto a bitmap for better performance.
+# <MapboxGL.PointAnnotation />
+PointAnnotation represents a one-dimensional shape located at a single geographical coordinate.
 
-### props
+Consider using ShapeSource and SymbolLayer instead, if you have many points and you have static images,
+they'll offer much better performance.
+
+If you need interactive views please use MarkerView,
+as with PointAnnotation on Android child views are rendered onto a bitmap for better performance.
+
+## props
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `none` | `true` | A string that uniquely identifies the annotation |
@@ -20,12 +26,12 @@
 | onDragEnd | `func` | `none` | `false` | This callback is fired once this annotation has stopped being dragged. |
 | onDrag | `func` | `none` | `false` | This callback is fired while this annotation is being dragged. |
 
-### methods
-#### refresh()
+## methods
+### refresh()
 
 On v10 and pre v10 android point annotation is rendered offscreen with a canvas into an image.<br/>To rerender the image from the current state of the view call refresh.<br/>Call this for example from Image#onLoad.
 
-##### arguments
+#### arguments
 | Name | Type | Required | Description  |
 | ---- | :--: | :------: | :----------: |
 

package/docs/RasterDemSource.md

@@ -1,8 +1,8 @@
 <!-- This file was autogenerated from RasterDemSource.js do not modify -->
-## <MapboxGL.RasterDemSource />
-### 
+# <MapboxGL.RasterDemSource />
 
-### props
+
+## props
 | Prop | Type | Default | Required | Description |
 | ---- | :--: | :-----: | :------: | :----------: |
 | id | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | A string that uniquely identifies the source. |