@rnmapbox/maps 10.0.0-beta.28

package/docs/CustomHttpHeaders.md

@@ -0,0 +1,87 @@
+## Custom http headers
+
+### Intro
+
+Custom headers are implemented using OkHttp interseptor for android and method swizzling for iOS.
+
+[Method swizzling](https://en.wikipedia.org/wiki/Monkey_patch) is done on the `[NSMutableURLRequest requestWithURL:]` to allow adding headers during runtime.
+
+### Prerequisites
+
+#### Android
+
+None
+
+#### IOS
+
+To enable this on iOS you need to call `[[MGLCustomHeaders sharedInstance] initHeaders]` pretty early in the lifecycle of the application. This will swizzle the custom method.
+Suggested location is `[AppDelegate application: didFinishLaunchingWithOptions:]`
+
+#### Working example (AppDelegate.m)
+
+```obj-c
+// (1) Include the header file
+#import "MGLCustomHeaders.h"
+
+@implementation AppDelegate
+
+- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
+{
+  RCTBridge *bridge = [[RCTBridge alloc] initWithDelegate:self launchOptions:launchOptions];
+  RCTRootView *rootView = [[RCTRootView alloc] initWithBridge:bridge
+                                                   moduleName:@"SampleApp"
+                                            initialProperties:nil];
+  // (2) Init headers, add swizzle method
+  [[MGLCustomHeaders sharedInstance] initHeaders];
+  // (3*) Optionally you can add some global headers here
+  [[MGLCustomHeaders sharedInstance] addHeader:@"IP" forHeaderName:@"X-For-Real"];
+
+  ...
+  return YES;
+}
+
+...
+
+@end
+```
+
+### Sending custom http headers with the tile requests
+
+You can configure sending of custom http headers to your tile server. This is to support custom authentication or custom metadata which can't be included in the url.
+
+You can add and remove headers at runtime.
+
+#### To add a header
+
+```javascript
+    MapboxGL.addCustomHeader('Authorization', '{auth header}');
+```
+
+#### To remove a header
+
+```javascript
+    MapboxGL.removeCustomHeader('Authorization');
+```
+
+#### Working example
+
+```javascript
+export default class HelloWorldApp extends Component {
+  componentDidMount() {
+    MapboxGL.addCustomHeader('Authorization', '{auth header}');
+  }
+
+  render() {
+    MapboxGL.addCustomHeader('X-Some-Header', 'my-value');
+    return (
+      <View style={styles.page}>
+        <View style={styles.container}>
+          <MapboxGL.MapView 
+            style={styles.map} 
+            styleURL={STYLE_URL} />
+        </View>
+      </View>
+    );
+  }
+}
+```

package/docs/FillExtrusionLayer.md

@@ -0,0 +1,433 @@
+<!-- This file was autogenerated from FillExtrusionLayer.js do not modify -->
+## <MapboxGL.FillExtrusionLayer />
+### FillExtrusionLayer is a style layer that renders one or more 3D extruded polygons on the map.
+
+### props
+| Prop | Type | Default | Required | Description |
+| ---- | :--: | :-----: | :------: | :----------: |
+| id | `string` | `none` | `true` | A string that uniquely identifies the source in the style to which it is added. |
+| sourceID | `string` | `MapboxGL.StyleSource.DefaultSourceID` | `false` | The source from which to obtain the data to style.<br/>If the source has not yet been added to the current style, the behavior is undefined.<br/>Inferred from parent source only if the layer is a direct child to it. |
+| sourceLayerID | `string` | `none` | `false` | Identifier of the layer within the source identified by the sourceID property from which the receiver obtains the data to style. |
+| aboveLayerID | `string` | `none` | `false` | Inserts a layer above aboveLayerID. |
+| belowLayerID | `string` | `none` | `false` | Inserts a layer below belowLayerID |
+| layerIndex | `number` | `none` | `false` | Inserts a layer at a specified index |
+| filter | `array` | `none` | `false` | Filter only the features in the source layer that satisfy a condition that you define |
+| minZoomLevel | `number` | `none` | `false` | The minimum zoom level at which the layer gets parsed and appears. |
+| maxZoomLevel | `number` | `none` | `false` | The maximum zoom level at which the layer gets parsed and appears. |
+| style | `union` | `none` | `false` | Customizable style attributes |
+
+
+### styles
+
+* <a href="#visibility">visibility</a><br/>
+* <a href="#fillextrusionopacity">fillExtrusionOpacity</a><br/>
+* <a href="#fillextrusioncolor">fillExtrusionColor</a><br/>
+* <a href="#fillextrusiontranslate">fillExtrusionTranslate</a><br/>
+* <a href="#fillextrusiontranslateanchor">fillExtrusionTranslateAnchor</a><br/>
+* <a href="#fillextrusionpattern">fillExtrusionPattern</a><br/>
+* <a href="#fillextrusionheight">fillExtrusionHeight</a><br/>
+* <a href="#fillextrusionbase">fillExtrusionBase</a><br/>
+* <a href="#fillextrusionverticalgradient">fillExtrusionVerticalGradient</a><br/>
+* <a href="#fillextrusionambientocclusionintensity">fillExtrusionAmbientOcclusionIntensity</a><br/>
+* <a href="#fillextrusionambientocclusionradius">fillExtrusionAmbientOcclusionRadius</a><br/>
+
+___
+
+#### visibility
+Name: `visibility`
+
+#### Description
+Whether this layer is displayed.
+
+#### Type
+`enum`
+#### Default Value
+`visible`
+
+#### Supported Values
+**visible** - The layer is shown.<br />
+**none** - The layer is not shown.<br />
+
+
+
+___
+
+#### fillExtrusionOpacity
+Name: `fillExtrusionOpacity`
+
+#### Description
+The opacity of the entire fill extrusion layer. This is rendered on a perLayer, not perFeature, basis, and dataDriven styling is not available.
+
+#### Type
+`number`
+#### Default Value
+`1`
+
+#### Minimum
+`0`
+
+
+#### Maximum
+`1`
+
+#### Expression
+
+Parameters: `zoom`
+___
+
+#### Name
+
+`fillExtrusionOpacityTransition`
+
+#### Description
+
+The transition affecting any changes to this layer’s fillExtrusionOpacity propery.
+
+#### Type
+
+`{ duration, delay }`
+
+#### Units
+`milliseconds`
+
+#### Default Value
+`{duration: 300, delay: 0}`
+
+
+___
+
+#### fillExtrusionColor
+Name: `fillExtrusionColor`
+
+#### Description
+The base color of the extruded fill. The extrusion's surfaces will be shaded differently based on this color in combination with the root `light` settings. If this color is specified as `rgba` with an alpha component, the alpha component will be ignored; use `fillExtrusionOpacity` to set layer opacity.
+
+#### Type
+`color`
+#### Default Value
+`#000000`
+
+
+#### Disabled By
+`fillExtrusionPattern`
+
+#### Expression
+
+Parameters: `zoom, feature, feature-state`
+___
+
+#### Name
+
+`fillExtrusionColorTransition`
+
+#### Description
+
+The transition affecting any changes to this layer’s fillExtrusionColor propery.
+
+#### Type
+
+`{ duration, delay }`
+
+#### Units
+`milliseconds`
+
+#### Default Value
+`{duration: 300, delay: 0}`
+
+
+___
+
+#### fillExtrusionTranslate
+Name: `fillExtrusionTranslate`
+
+#### Description
+The geometry's offset. Values are [x, y] where negatives indicate left and up (on the flat plane), respectively.
+
+#### Type
+`array<number>`
+#### Default Value
+`[0,0]`
+
+#### Units
+`pixels`
+
+
+#### Expression
+
+Parameters: `zoom`
+___
+
+#### Name
+
+`fillExtrusionTranslateTransition`
+
+#### Description
+
+The transition affecting any changes to this layer’s fillExtrusionTranslate propery.
+
+#### Type
+
+`{ duration, delay }`
+
+#### Units
+`milliseconds`
+
+#### Default Value
+`{duration: 300, delay: 0}`
+
+
+___
+
+#### fillExtrusionTranslateAnchor
+Name: `fillExtrusionTranslateAnchor`
+
+#### Description
+Controls the frame of reference for `fillExtrusionTranslate`.
+
+#### Type
+`enum`
+#### Default Value
+`map`
+
+#### Supported Values
+**map** - The fill extrusion is translated relative to the map.<br />
+**viewport** - The fill extrusion is translated relative to the viewport.<br />
+
+
+#### Requires
+`fillExtrusionTranslate`
+
+#### Expression
+
+Parameters: `zoom`
+
+___
+
+#### fillExtrusionPattern
+Name: `fillExtrusionPattern`
+
+#### Description
+Name of image in sprite to use for drawing images on extruded fills. For seamless patterns, image width and height must be a factor of two (2, 4, 8, ..., 512). Note that zoomDependent expressions will be evaluated only at integer zoom levels.
+
+#### Type
+`resolvedImage`
+
+
+#### Expression
+
+Parameters: `zoom, feature`
+___
+
+#### Name
+
+`fillExtrusionPatternTransition`
+
+#### Description
+
+The transition affecting any changes to this layer’s fillExtrusionPattern propery.
+
+#### Type
+
+`{ duration, delay }`
+
+#### Units
+`milliseconds`
+
+#### Default Value
+`{duration: 300, delay: 0}`
+
+
+___
+
+#### fillExtrusionHeight
+Name: `fillExtrusionHeight`
+
+#### Description
+The height with which to extrude this layer.
+
+#### Type
+`number`
+#### Default Value
+`0`
+
+#### Units
+`meters`
+
+#### Minimum
+`0`
+
+
+#### Expression
+
+Parameters: `zoom, feature, feature-state`
+___
+
+#### Name
+
+`fillExtrusionHeightTransition`
+
+#### Description
+
+The transition affecting any changes to this layer’s fillExtrusionHeight propery.
+
+#### Type
+
+`{ duration, delay }`
+
+#### Units
+`milliseconds`
+
+#### Default Value
+`{duration: 300, delay: 0}`
+
+
+___
+
+#### fillExtrusionBase
+Name: `fillExtrusionBase`
+
+#### Description
+The height with which to extrude the base of this layer. Must be less than or equal to `fillExtrusionHeight`.
+
+#### Type
+`number`
+#### Default Value
+`0`
+
+#### Units
+`meters`
+
+#### Minimum
+`0`
+
+
+#### Requires
+`fillExtrusionHeight`
+
+#### Expression
+
+Parameters: `zoom, feature, feature-state`
+___
+
+#### Name
+
+`fillExtrusionBaseTransition`
+
+#### Description
+
+The transition affecting any changes to this layer’s fillExtrusionBase propery.
+
+#### Type
+
+`{ duration, delay }`
+
+#### Units
+`milliseconds`
+
+#### Default Value
+`{duration: 300, delay: 0}`
+
+
+___
+
+#### fillExtrusionVerticalGradient
+Name: `fillExtrusionVerticalGradient`
+
+#### Description
+Whether to apply a vertical gradient to the sides of a fillExtrusion layer. If true, sides will be shaded slightly darker farther down.
+
+#### Type
+`boolean`
+#### Default Value
+`true`
+
+
+#### Expression
+
+Parameters: `zoom`
+
+___
+
+#### fillExtrusionAmbientOcclusionIntensity
+Name: `fillExtrusionAmbientOcclusionIntensity`
+
+#### Description
+Controls the intensity of ambient occlusion (AO) shading. Current AO implementation is a lowCost bestEffort approach that shades area near ground and concave angles between walls. Default value 0.0 disables ambient occlusion and values around 0.3 provide the most plausible results for buildings.
+
+#### Type
+`number`
+#### Default Value
+`0`
+
+#### Minimum
+`0`
+
+
+#### Maximum
+`1`
+
+#### Expression
+
+Parameters: `zoom`
+___
+
+#### Name
+
+`fillExtrusionAmbientOcclusionIntensityTransition`
+
+#### Description
+
+The transition affecting any changes to this layer’s fillExtrusionAmbientOcclusionIntensity propery.
+
+#### Type
+
+`{ duration, delay }`
+
+#### Units
+`milliseconds`
+
+#### Default Value
+`{duration: 300, delay: 0}`
+
+
+___
+
+#### fillExtrusionAmbientOcclusionRadius
+Name: `fillExtrusionAmbientOcclusionRadius`
+
+#### Description
+The radius of ambient occlusion (AO) shading, in meters. Current AO implementation is a lowCost bestEffort approach that shades area near ground and concave angles between walls where the radius defines only vertical impact. Default value 3.0 corresponds to hight of one floor and brings the most plausible results for buildings.
+
+#### Type
+`number`
+#### Default Value
+`3`
+
+#### Minimum
+`0`
+
+
+#### Expression
+
+Parameters: `zoom`
+___
+
+#### Name
+
+`fillExtrusionAmbientOcclusionRadiusTransition`
+
+#### Description
+
+The transition affecting any changes to this layer’s fillExtrusionAmbientOcclusionRadius propery.
+
+#### Type
+
+`{ duration, delay }`
+
+#### Units
+`milliseconds`
+
+#### Default Value
+`{duration: 300, delay: 0}`
+
+