react-native-maps 0.26.1 → 0.28.1

package/README.md

@@ -2,6 +2,10 @@
 
 React Native Map components for iOS + Android
 
+
+# :warning: Maintainers Wanted [![Maintainers Wanted](https://img.shields.io/badge/maintainers-wanted-red.svg)](https://github.com/react-native-maps/react-native-maps/issues/3564)
+We are in need of more people or companies willing to help. If you have enough time and knowledge, and want to become a maintainer, please let us know [here](https://github.com/react-native-maps/react-native-maps/issues/3564).
+ 
 ## Installation
 
 See [Installation Instructions](docs/installation.md).
@@ -16,12 +20,6 @@ our best to stay compatible with older versions as much that is practical, and t
 of this requirement is set to `"react-native": "*"` explicitly for this reason. If you are using
 an older version of React Native with this module though, some features may be buggy.
 
-### Note about React requires
-
-Since react-native 0.25.0, `React` should be required from `node_modules`.
-React Native versions from 0.18 should be working out of the box, for lower
-versions you should add `react` as a dependency in your `package.json`.
-
 ## Component API
 
 [`<MapView />` Component API](docs/mapview.md)
@@ -108,8 +106,9 @@ import { Marker } from 'react-native-maps';
   region={this.state.region}
   onRegionChange={this.onRegionChange}
 >
-  {this.state.markers.map(marker => (
+  {this.state.markers.map((marker, index) => (
     <Marker
+      key={index}
       coordinate={marker.latlng}
       title={marker.title}
       description={marker.description}
@@ -121,7 +120,7 @@ import { Marker } from 'react-native-maps';
 ### Rendering a Marker with a custom view
 
 ```jsx
-<Marker coordinate={marker.latlng}>
+<Marker coordinate={{ latitude : latitude , longitude : longitude }}>
   <MyCustomMarkerView {...marker} />
 </Marker>
 ```
@@ -130,7 +129,7 @@ import { Marker } from 'react-native-maps';
 
 ```jsx
 <Marker
-  coordinate={marker.latlng}
+  coordinate={{ latitude : latitude , longitude : longitude }}
   image={require('../assets/pin.png')}
 />
 ```
@@ -280,26 +279,10 @@ import MapView, { PROVIDER_GOOGLE } from 'react-native-maps'
 
 Then add the AirGoogleMaps directory:
 
-https://github.com/react-native-community/react-native-maps/blob/1e71a21f39e7b88554852951f773c731c94680c9/docs/installation.md#ios
+https://github.com/react-native-maps/react-native-maps/blob/1e71a21f39e7b88554852951f773c731c94680c9/docs/installation.md#ios
 
 An unofficial step-by-step guide is also available at https://gist.github.com/heron2014/e60fa003e9b117ce80d56bb1d5bfe9e0
 
-## Examples
-
-To run examples:
-
-```bash
-npm i
-npm start
-
-#Android
-npm run run:android
-
-#iOS
-npm run build:ios
-npm run run:ios
-```
-
 ### MapView Events
 
 The `<MapView />` component and its child components have several events that you can subscribe to.
@@ -486,7 +469,7 @@ componentWillReceiveProps(nextProps) {
   if (this.props.coordinate !== nextProps.coordinate) {
     if (Platform.OS === 'android') {
       if (this.marker) {
-        this.marker._component.animateMarkerToCoordinate(
+        this.marker.animateMarkerToCoordinate(
           nextProps.coordinate,
           duration
         );
@@ -523,7 +506,7 @@ componentWillReceiveProps(nextProps) {
   if (this.props.coordinate !== nextProps.coordinate) {
     if (Platform.OS === 'android') {
       if (this.marker) {
-        this.marker._component.animateMarkerToCoordinate(
+        this.marker.animateMarkerToCoordinate(
           nextProps.coordinate,
           duration
         );
@@ -612,8 +595,8 @@ Pass an array of coordinates to focus a map region on said coordinates.
 
 * Make sure that you have [properly installed](docs/installation.md) react-native-maps.
 * Check in the logs if there is more informations about the issue.
-* Try setting the style of the MapView to an absolute position with top, left, right and bottom values set.
-* Make sure you have enabled Google Maps API in ![Google developer console](https://console.developers.google.com/apis/library)
+* Try setting the style of the MapView to an absolute position with top, left, right and bottom  values set.
+*   Make sure you have enabled Google Maps API in [Google developer console](https://console.developers.google.com/apis/library)
 
 ```javascript
 const styles = StyleSheet.create({
@@ -652,6 +635,29 @@ Good:
 </View>
 ```
 
+### Children Components Not Re-Rendering
+Components that aren't declared by this library (Ex: Markers, Polyline) must not be children of the MapView component due to MapView's unique rendering methodology. Have your custom components / views outside the MapView component and position absolute to ensure they only re-render as needed.
+Example:
+Bad:
+
+```jsx
+  <View style={StyleSheet.absoluteFillObject}>
+    <MapView style={StyleSheet.absoluteFillObject}>
+      <View style={{ position: 'absolute', top: 100, left: 50 }}/>
+    </MapView>
+  </View>
+```
+
+Good:
+
+```jsx
+  <View style={StyleSheet.absoluteFillObject}>
+    <MapView style={StyleSheet.absoluteFillObject} />
+    <View style={{ position: 'absolute', top: 100, left: 50 }}/>
+  </View>
+```
+
+Source: https://github.com/react-native-maps/react-native-maps/issues/1901
 
 License
 --------

package/docs/examples-setup.md

@@ -1,43 +1,17 @@
 # Examples Setup
 
-## iOS
-
-1. If you don't have bundler gem installed:
-
-```
-gem install bundler
-```
-
-2. Install dependencies and open the workspace:
-
 ```
+cd example/
 npm install
-npm run build:ios
-npm run run:ios
 ```
 
-or
-
+## iOS
 ```
-yarn install
-yarn build:ios
-yarn run:ios
+npx pod-install
+npx react-native run-ios
 ```
 
 ## android
-
-1. Start your emulator
-
-2. Install dependencies and run the example:
-
-```
-npm install
-npm run run:android
-```
-
-or
-
-```
-yarn install
-yarn run:android
 ```
+npx react-native run-android
+```

package/docs/geojson.md

@@ -4,7 +4,16 @@
 
 | Prop      | Type | Default                                                | Note |
 | --------- | ---- | ------------------------------------------------------ | ---- |
-| `geojson` |      | [Geojson](https://geojson.org/) description of object. |
+| `geojson` |  `GeoJSON`    |  | [Geojson](https://geojson.org/) description of object. |
+| `strokeColor` | `String`     | stroke color in GeoJson if present else `#000` | The stroke color to use for the path.  |
+| `fillColor` | `String`     | fill color in GeoJson | The fill color to use for the path. |
+| `strokeWidth` | `Number`     | stroke width in Geojson if present else `1` | The stroke width to use for the path. |
+| `lineDashPhase` | `Number`     |  |  (iOS only) The offset (in points) at which to start drawing the dash pattern. Use this property to start drawing a dashed line partway through a segment or gap. For example, a phase value of 6 for the patter 5-2-3-2 would cause drawing to begin in the middle of the first gap. |
+| `lineDashPattern` | `Array<Number>`     |  | An array of numbers specifying the dash pattern to use for the path. The array contains one or more numbers that indicate the lengths (measured in points) of the  line segments and gaps in the pattern. The values in the array alternate, starting with the first line segment length, followed by the first gap length, followed by the second line segment length, and so on. |
+| `lineCap` |  `'butt' | 'round' | 'square'`     |  |  The line cap style to apply to the open ends of the path. Possible values are `butt`, `round` or `square`.  Note: lineCap is not yet supported for GoogleMaps provider on iOS. |
+| `lineJoin` | `'miter'| 'round' | 'bevel'`     |  |  The line join style to apply to corners of the path. Possible values are `miter`, `round` or `bevel`. |
+| `miterLimit` | `Number`     |  | The limiting value that helps avoid spikes at junctions between connected line segments. The miter limit helps you avoid spikes in paths that use the `miter` `lineJoin` style. If the ratio of the miter length—that is, the diagonal length of the miter join—to the line thickness exceeds the miter limit, the joint is converted to a bevel join. The default miter limit is 10, which results in the conversion of miters whose angle at the joint is less than 11 degrees. | 
+| `zIndex` | `Number`     |  | Layer level of the z-index value |
 
 ## Example
 
@@ -28,7 +37,12 @@ const myPlace = {
 
 const Map = props => (
   <MapView>
-    <Geojson geojson={myPlace} />
+    <Geojson 
+      geojson={myPlace} 
+      strokeColor="red"
+      fillColor="green"
+      strokeWidth={2}
+    />
   </MapView>
 );
 ```

package/docs/installation.md

@@ -4,6 +4,11 @@ Install the library from npm:
 
 ```sh
 npm install react-native-maps --save-exact
+```
+
+or 
+
+```sh
 yarn add react-native-maps -E
 ```
 
@@ -100,9 +105,6 @@ post_install do |installer|
         config.build_settings['CLANG_ENABLE_MODULES'] = 'No'
       end
     end
-    if target.name == "React"
-      target.remove_from_project
-    end
   end
 end
 ```
@@ -121,6 +123,9 @@ and open the produced workspace file (`.xcworkspace`) in XCode to build your pro
 cd ios
 pod install
 ```
+### App store submission
+
+The app's `Info.plist` file must contain a `NSLocationWhenInUseUsageDescription` with a user-facing purpose string explaining clearly and completely why your app needs the location, otherwise Apple will reject your app submission.
 
 ### Enabling Google Maps on iOS (React Native all versions)
 
@@ -220,7 +225,7 @@ ext {
     buildToolsVersion   = "xxx"
     minSdkVersion       = xxx
     supportLibVersion   = "xxx"
-    playServicesVersion = "xxx" // or set latest version
+    playServicesVersion = "17.0.0" // or find latest version
     androidMapsUtilsVersion = "xxx"
 }
 ```
@@ -233,16 +238,19 @@ buildscript {
         compileSdkVersion = xxx
         targetSdkVersion = xxx
         supportLibVersion = "xxx"
-        playServicesVersion = "xxx" // or set latest version
+        playServicesVersion = "17.0.0" // or find latest version
         androidMapsUtilsVersion = "xxx"
     }
 }
 ...
 ```
+You can find the latest `playServicesVersion` by checking [https://developers.google.com/android/guides/releases](https://developers.google.com/android/guides/releases) and searching for `gms:play-services-maps:`
+
+You can find the latest `androidMapsUtilsVersion` by checking [https://mvnrepository.com/artifact/com.google.maps.android/android-maps-utils](https://mvnrepository.com/artifact/com.google.maps.android/android-maps-utils)
 
 3.2 (React Native all versions) If you do **not** have *project-wide properties* defined and have a
 different play-services version than the one included in this library,
-use the following instead (switch 10.0.1 for the desired version):
+use the following instead (switch 17.0.0 and/or 17.2.1 for the desired versions):
 
 ```groovy
 ...
@@ -252,8 +260,8 @@ dependencies {
        exclude group: 'com.google.android.gms', module: 'play-services-base'
        exclude group: 'com.google.android.gms', module: 'play-services-maps'
    }
-   implementation 'com.google.android.gms:play-services-base:10.0.1'
-   implementation 'com.google.android.gms:play-services-maps:10.0.1'
+   implementation 'com.google.android.gms:play-services-base:17.2.1'
+   implementation 'com.google.android.gms:play-services-maps:17.0.0'
 }
 ```
 
@@ -267,6 +275,9 @@ dependencies {
    <meta-data
      android:name="com.google.android.geo.API_KEY"
      android:value="Your Google maps API Key Here"/>
+  
+   <!-- You will also only need to add this uses-library tag -->
+   <uses-library android:name="org.apache.http.legacy" android:required="false"/>
 </application>
 ```
 > Note: As shown above, `com.google.android.geo.API_KEY` is the
@@ -322,7 +333,16 @@ project from the URLs below:
 - [Google Maps SDK Android](https://console.developers.google.com/apis/library/maps-android-backend.googleapis.com/)
 - [Google Maps SDK iOS (if required)](https://console.developers.google.com/apis/library/maps-ios-backend.googleapis.com)
 
-For reference, you may read the relevant issue reports: ([#118](https://github.com/react-native-community/react-native-maps/issues/118), [#176](https://github.com/react-native-community/react-native-maps/issues/176), [#684](https://github.com/react-native-community/react-native-maps/issues/684)).
+For reference, you may read the relevant issue reports: ([#118](https://github.com/react-native-maps/react-native-maps/issues/118), [#176](https://github.com/react-native-maps/react-native-maps/issues/176), [#684](https://github.com/react-native-maps/react-native-maps/issues/684)).
+
+### The map background is gray (Google Maps)
+
+If you get grey screen on android device create google_maps_api.xml in android/app/src/main/res/values.
+```xml
+<resources>
+  <string name="google_maps_key" templateMergeStrategy="preserve" translatable="false">(api key here)</string>
+</resources>
+```
 
 ### No map whatsoever
 
@@ -367,7 +387,7 @@ export default () => (
 If your XCode project uses dynamic frameworks (e.g. you also have Swift
 code in your project), you cannot install `Google-Maps-iOS-Utils` with
 CocoaPods. The issue and a workaround for it has been documented
-[here](https://github.com/googlemaps/google-maps-ios-utils/blob/master/Swift.md).
+[here](https://github.com/googlemaps/google-maps-ios-utils/blob/b721e95a500d0c9a4fd93738e83fc86c2a57ac89/Swift.md).
 
 ### Runtime errors on iOS (Apple Maps)
 
@@ -470,7 +490,7 @@ import com.airbnb.android.react.maps.MapsPackage;
 
 ### Trouble with Google Play services
 
-- Make sure that your emulator has Google Play (Go to Anroid studio -> Virtual Devices -> Check that you have icon in "Play Store" column)
+- Make sure that your emulator has Google Play (Go to Android studio -> Virtual Devices -> Check that you have icon in "Play Store" column)
 - Click to bottom dots icon in the emulator
 - Go to Google Play Tab and click Update
 

package/docs/mapview.md

@@ -9,14 +9,17 @@
 | `initialRegion` | `Region` |  | The initial region to be displayed by the map.  Use this prop instead of `region` only if you don't want to control the viewport of the map besides the initial region.<br/><br/> Changing this prop after the component has mounted will not result in a region change.<br/><br/> This is similar to the `initialValue` prop of a text input.
 | `camera` | `Camera` |  | The camera view the map should display. If you use this, the `region` property is ignored.
 | `initialCamera` | `Camera` |  | Like `initialRegion`, use this prop instead of `camera` only if you don't want to control the viewport of the map besides the initial camera setting.<br/><br/> Changing this prop after the component has mounted will not result in a region change.<br/><br/> This is similar to the `initialValue` prop of a text input.
-| `mapPadding` | `EdgePadding` |  | Adds custom padding to each side of the map. Useful when map elements/markers are obscured. **Note** Google Maps only.
-| `paddingAdjustmentBehavior` | 'always'\|'automatic'\|'never' | 'never' | Indicates how/when to affect padding with safe area insets (`GoogleMaps` in iOS only)
+| `mapPadding` | `EdgePadding` |  | Adds custom padding to each side of the map. Useful when map elements/markers are obscured.
+| `paddingAdjustmentBehavior` | 'always' \| 'automatic' \| 'never' | 'never' | Indicates how/when to affect padding with safe area insets (`GoogleMaps` in iOS only)
 | `liteMode` | `Boolean` | `false` | Enable lite mode. **Note**: Android only.
-| `mapType` | `String` | `"standard"` | The map type to be displayed. <br/><br/> - standard: standard road map (default)<br/> - none: no map **Note** Not available on MapKit<br/> - satellite: satellite view<br/> - hybrid: satellite view with roads and points of interest overlayed<br/> - terrain: (Android only) topographic view<br/> - mutedStandard: more subtle, makes markers/lines pop more (iOS 11.0+ only)
-| `customMapStyle` | `Array` |  | Adds custom styling to the map component. See [README](https://github.com/react-native-community/react-native-maps#customizing-the-map-style) for more information.
+| `mapType` | `String` | `"standard"` | The map type to be displayed. <br/><br/> - standard: standard road map (default)<br/> - none: no map **Note** Not available on MapKit<br/> - satellite: satellite view<br/> - hybrid: satellite view with roads and points of interest overlayed<br/> - terrain: topographic view<br/> - mutedStandard: more subtle, makes markers/lines pop more (iOS 11.0+ only)
+| `customMapStyle` | `Array` |  | Adds custom styling to the map component. See [README](https://github.com/react-native-maps/react-native-maps#customizing-the-map-style) for more information.
 | `showsUserLocation` | `Boolean` | `false` | If `true` the app will ask for the user's location. **NOTE**: You need to add `NSLocationWhenInUseUsageDescription` key in Info.plist to enable geolocation, otherwise it is going to *fail silently*! You will also need to add an explanation for why you need the users location against `NSLocationWhenInUseUsageDescription` in Info.plist. Otherwise Apple may reject your app submission.
+| `userLocationPriority` | 'balanced'\|'high'\|'low'\|'passive' | 'high' | Set power priority of user location tracking. See [Google APIs documentation](https://developers.google.com/android/reference/com/google/android/gms/location/LocationRequest.html). **Note:** Android only.
+| `userLocationUpdateInterval` | `Number` | 5000 | Interval of user location updates in milliseconds. See [Google APIs documentation](https://developers.google.com/android/reference/com/google/android/gms/location/LocationRequest.html). **Note:** Android only.
+| `userLocationFastestInterval` | `Number` | 5000 | Fastest interval the application will actively acquire locations. See [Google APIs documentation](https://developers.google.com/android/reference/com/google/android/gms/location/LocationRequest.html). **Note:** Android only.
 | `userLocationAnnotationTitle` | `String` | | The title of the annotation for current user location. This only works if `showsUserLocation` is true. There is a default value `My Location` set by MapView. **Note**: iOS only.
-| `followsUserLocation` | `Boolean` | `false` | If `true` the map will focus on the user's location. This only works if `showsUserLocation` is true and the user has shared their location. **Note**: iOS only.
+| `followsUserLocation` | `Boolean` | `false` | If `true` the map will focus on the user's location. This only works if `showsUserLocation` is true and the user has shared their location. **Note**: Apple Maps only.
 | `showsMyLocationButton` | `Boolean` | `true` | If `false` hide the button to move map to the current user's location.
 | `showsPointsOfInterest` | `Boolean` | `true` | If `false` points of interest won't be displayed on the map.
 | `showsCompass` | `Boolean` | `true` | If `false` compass won't be displayed on the map.
@@ -38,10 +41,12 @@
 | `loadingEnabled` | `Boolean` | `false` | If `true` a loading indicator will show while the map is loading.
 | `loadingIndicatorColor` | `Color` | `#606060` | Sets loading indicator color, default to `#606060`.
 | `loadingBackgroundColor` | `Color` | `#FFFFFF` | Sets loading background color, default to `#FFFFFF`.
+| `tintColor` | `color` | `null` | Sets the tint color of the map. (Changes the color of the position indicator) Defaults to system blue. **Note:** iOS (Apple maps) only.
 | `moveOnMarkerPress` | `Boolean` | `true` | `Android only` If `false` the map won't move when a marker is pressed.
 | `legalLabelInsets` | `EdgeInsets` | | If set, changes the position of the "Legal" label link from the OS default. **Note:** iOS only.
 | `kmlSrc` | `string` | | The URL from KML file. **Note:** Google Maps and Markers only (either Android or iOS with `PROVIDER_GOOGLE`).
 | `compassOffset` | `Point` | | If set, changes the position of the compass. **Note:** iOS Maps only.
+| `isAccessibilityElement` | `Boolean` | `false` | Determines whether the MapView captures VoiceOver touches or forwards them to children. When `true`, map markers are not visible to VoiceOver.  **Note:** iOS Maps only.
 
 
 ## Events
@@ -52,9 +57,9 @@ To access event data, you will need to use `e.nativeEvent`. For example, `onPres
 |---|---|---|
 | `onMapReady` |  | Callback that is called once the map is fully loaded.
 | `onKmlReady` | `KmlContainer` | Callback that is called once the kml is fully loaded.
-| `onRegionChange` | `Region` | Callback that is called continuously when the region changes, such as when a user is dragging the map.
-| `onRegionChangeComplete` | `Region` | Callback that is called once when the region changes, such as when the user is done moving the map.
-| `onUserLocationChange` | `{ coordinate: Location }` | Callback that is called when the underlying map figures our users current location (coordinate also includes isFromMockProvider value for Android API 18 and above). Make sure **showsUserLocation** is set to *true* and that the provider is `"google"`.
+| `onRegionChange` | (`Region`, `{isGesture: boolean}`) | Callback that is called continuously when the region changes, such as when a user is dragging the map. The second parameter is an object containing more details about the move. `isGesture` property indicates if the move was from the user (true) or an animation (false). **Note**: `isGesture` is supported by Google Maps only.
+| `onRegionChangeComplete` | (`Region`, `{isGesture: boolean}`) | Callback that is called once when the region changes, such as when the user is done moving the map.  The second parameter is an object containing more details about the move. `isGesture` property indicates if the move was from the user (true) or an animation (false). **Note**: `isGesture` is supported by Google Maps only.
+| `onUserLocationChange` | `{ coordinate: Location }` | Callback that is called when the underlying map figures our users current location (coordinate also includes isFromMockProvider value for Android API 18 and above). Make sure **showsUserLocation** is set to *true*.
 | `onPress` | `{ coordinate: LatLng, position: Point }` | Callback that is called when user taps on the map.
 | `onDoublePress` | `{ coordinate: LatLng, position: Point }` | Callback that is called when user double taps on the map.
 | `onPanDrag` | `{ coordinate: LatLng, position: Point }` | Callback that is called when user presses and drags the map. **NOTE**: for iOS `scrollEnabled` should be set to false to trigger the event
@@ -88,7 +93,7 @@ To access event data, you will need to use `e.nativeEvent`. For example, `onPres
 | `setMapBoundaries` | `northEast: LatLng`, `southWest: LatLng` | The boundary is defined by the map's center coordinates, not the device's viewport itself. **Note:** Google Maps only.
 | `setIndoorActiveLevelIndex` | `levelIndex: Number` |
 | `fitToElements` | `animated: Boolean` |
-| `fitToSuppliedMarkers` | `markerIDs: String[], options: { edgePadding: EdgePadding, animated: Boolean }` | If you need to use this in `ComponentDidMount`, make sure you put it in a timeout or it will cause performance problems.
+| `fitToSuppliedMarkers` | `markerIDs: String[], options: { edgePadding: EdgePadding, animated: Boolean }` | If you need to use this in `ComponentDidMount`, make sure you put it in a timeout or it will cause performance problems. **Note** edgePadding is Google Maps only
 | `fitToCoordinates` | `coordinates: Array<LatLng>, options: { edgePadding: EdgePadding, animated: Boolean }` | If called in `ComponentDidMount` in android, it will cause an exception. It is recommended to call it from the MapView `onLayout` event.
 | `pointForCoordinate` | `coordinate: LatLng` | Converts a map coordinate to a view coordinate (`Point`). Returns a `Promise<Point>`.
 | `coordinateForPoint` | `point: Point` | Converts a view coordinate (`Point`) to a map coordinate. Returns a `Promise<Coordinate>`.
@@ -114,10 +119,10 @@ type Camera = {
        longitude: number,
    },
    pitch: number,
-   heading: number
+   heading: number,
 
    // Only on iOS MapKit, in meters. The property is ignored by Google Maps.
-   altitude: number.
+   altitude: number,
 
    // Only when using Google Maps.
    zoom: number
@@ -221,7 +226,7 @@ type IndoorBuilding {
 
 ```
 type IndoorLevel {
-  activeLevelIndex: Number,
+  index: Number,
   name: String,
   shortName: String,
 }

package/docs/marker.md

@@ -22,6 +22,8 @@
 | `tracksInfoWindowChanges` | `Boolean` | false | Sets whether this marker should track view changes in info window. Enabling it will let marker change content of info window after first render pass, but will lead to decreased performance, so it's recommended to disable it whenever you don't need it. **Note**: iOS Google Maps only.
 | `stopPropagation` | `Boolean` | false | Sets whether this marker should propagate `onPress` events. Enabling it will stop the parent `MapView`'s `onPress` from being called. **Note**: iOS only. Android does not propagate `onPress` events. See [#1132](https://github.com/react-community/react-native-maps/issues/1132) for more information.
 | `opacity` | `Float` | 1.0 | The marker's opacity between 0.0 and 1.0.
+| `isPreselected` | `Boolean` | false | When true, the marker will be pre-selected. Setting this to true allows the user to drag the marker without needing to tap on it once to focus on it. **Note**: iOS Apple Maps only.
+| `key` | `String` | | If no key or non-unique `key` is specified, the `<Marker />` will be reused, therefore there is an animation when the position is changed. If you want to disable the animation, add a `key` prop with a unique value like `key_${item.longitude}_${item.latitude}`. **Note**: iOS only.
 
 ## Events
 

package/docs/overlay.md

@@ -7,6 +7,7 @@
 | `image` | `ImageSource` | A custom image to be used as the overlay. Only required local image resources and uri (as for images located in the net) are allowed to be used.
 | `bounds` | `Array<LatLng>` |  | The coordinates for the image (left-top corner, right-bottom corner). ie.```[[lat, long], [lat, long]]```
 | `tappable` | `Bool` | `false` | `Android only` Boolean to allow an overlay to be tappable and use the onPress function.
+| `opacity` | `Number` | `1.0` | `Google maps only` The opacity of the overlay.
 
 ## Events
 

package/index.d.ts

@@ -164,6 +164,21 @@ declare module "react-native-maps" {
     position: Point;
   };
 
+  export type IndoorBuilding = {
+    underground: boolean,
+    activeLevelIndex: number,
+    levels: Array<IndoorLevel>,
+  }
+
+  export type IndoorLevel = {
+    index: number,
+    name: string,
+    shortName: string,
+  }
+
+  export interface IndoorBuildingEvent
+    extends NativeSyntheticEvent<{IndoorBuilding:IndoorBuilding}> {}
+
   /**
    * onKmlReady parameter
    */
@@ -182,6 +197,9 @@ declare module "react-native-maps" {
     provider?: "google" | null;
     customMapStyle?: MapStyleElement[];
     customMapStyleString?: string;
+    userLocationPriority?: "balanced" | "high" | "low" | "passive";
+    userLocationUpdateInterval?: number;
+    userLocationFastestInterval?: number;
     showsUserLocation?: boolean;
     userLocationAnnotationTitle?: string;
     showsMyLocationButton?: boolean;
@@ -212,10 +230,12 @@ declare module "react-native-maps" {
     initialCamera?: Camera;
     liteMode?: boolean;
     mapPadding?: EdgePadding;
+    paddingAdjustmentBehavior?: "always" | "automatic" | "never";
     maxDelta?: number;
     minDelta?: number;
     legalLabelInsets?: EdgeInsets;
     compassOffset?: { x: number; y: number };
+    tintColor?: string;
 
     onMapReady?: () => void;
     onKmlReady?: (values: KmlMapEvent) => void;
@@ -240,6 +260,7 @@ declare module "react-native-maps" {
     onMarkerDragStart?: (event: MapEvent) => void;
     onMarkerDrag?: (event: MapEvent) => void;
     onMarkerDragEnd?: (event: MapEvent) => void;
+    onIndoorBuildingFocused?: (event: IndoorBuildingEvent) => void;
 
     minZoomLevel?: number;
     maxZoomLevel?: number;
@@ -274,9 +295,10 @@ declare module "react-native-maps" {
     takeSnapshot(options?: SnapshotOptions): Promise<string>;
     pointForCoordinate(coordinate: LatLng): Promise<Point>;
     coordinateForPoint(point: Point): Promise<LatLng>;
+    setIndoorActiveLevelIndex(index:number): void;
   }
 
-  export class MapViewAnimated extends MapView {}
+  export class Animated extends MapView {}
 
   // =======================================================================
   //  Marker
@@ -331,6 +353,11 @@ declare module "react-native-maps" {
      * __iOS only__
      */
     redrawCallout(): void;
+    /**
+     * Causes a redraw of the marker. Useful when there are updates to the
+     * marker and `tracksViewChanges` comes with a cost that is too high.
+     */
+    redraw(): void
     /**
      * Animates marker movement.
      * __Android only__
@@ -437,9 +464,12 @@ declare module "react-native-maps" {
 
   export interface MapUrlTileProps extends ViewProperties {
     urlTemplate: string;
+    minimumZ?: number;
     maximumZ?: number;
     zIndex?: number;
     tileSize?: number;
+    shouldReplaceMapContent?:boolean;
+    flipY?: boolean;
   }
 
   export class UrlTile extends React.Component<MapUrlTileProps, any> {}
@@ -507,6 +537,26 @@ declare module "react-native-maps" {
 
   export class Heatmap extends React.Component<MapHeatmapProps, any> {}
 
+  // =======================================================================
+  //  Geojson
+  // =======================================================================
+
+  import GeoJSON from 'geojson';
+
+  export interface GeojsonProps {
+    geojson: GeoJSON.GeoJSON;
+    strokeColor?: string;
+    fillColor?: string;
+    strokeWidth?: number;
+    lineDashPhase?: number;
+    lineDashPattern?:number[];
+    lineCap?:'butt'|'round' | 'square';
+    lineJoin?: 'miter'| 'round' | 'bevel';
+    miterLimit?: number;
+  }
+
+  export class Geojson extends React.Component<GeojsonProps, any> {}
+
   // =======================================================================
   //  Constants
   // =======================================================================

package/lib/android/build/.transforms/795f4668561a5e5fed7842cba126755c.bin

@@ -0,0 +1 @@
+o/classes

package/lib/android/build/.transforms/a2ed50c0e5828e7fca34c8792030e939.bin

@@ -0,0 +1 @@
+o/classes

package/lib/android/build/.transforms/fc62f36b98804f83d3e39bc95624124c.bin

@@ -0,0 +1 @@
+o/classes

package/lib/android/build/generated/source/buildConfig/debug/com/airbnb/android/react/maps/BuildConfig.java

@@ -5,6 +5,11 @@ package com.airbnb.android.react.maps;
 
 public final class BuildConfig {
   public static final boolean DEBUG = Boolean.parseBoolean("true");
+  public static final String LIBRARY_PACKAGE_NAME = "com.airbnb.android.react.maps";
+  /**
+   * @deprecated APPLICATION_ID is misleading in libraries. For the library package name use LIBRARY_PACKAGE_NAME
+   */
+  @Deprecated
   public static final String APPLICATION_ID = "com.airbnb.android.react.maps";
   public static final String BUILD_TYPE = "debug";
   public static final String FLAVOR = "";

package/lib/android/build/generated/source/buildConfig/release/com/airbnb/android/react/maps/BuildConfig.java

@@ -5,6 +5,11 @@ package com.airbnb.android.react.maps;
 
 public final class BuildConfig {
   public static final boolean DEBUG = false;
+  public static final String LIBRARY_PACKAGE_NAME = "com.airbnb.android.react.maps";
+  /**
+   * @deprecated APPLICATION_ID is misleading in libraries. For the library package name use LIBRARY_PACKAGE_NAME
+   */
+  @Deprecated
   public static final String APPLICATION_ID = "com.airbnb.android.react.maps";
   public static final String BUILD_TYPE = "release";
   public static final String FLAVOR = "";

package/lib/android/build/intermediates/{manifests/aapt/release → aapt_friendly_merged_manifests/debug/aapt}/AndroidManifest.xml

@@ -3,8 +3,8 @@
     package="com.airbnb.android.react.maps" >
 
     <uses-sdk
-        android:minSdkVersion="16"
-        android:targetSdkVersion="25" />
+        android:minSdkVersion="21"
+        android:targetSdkVersion="29" />
 
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

package/lib/android/build/intermediates/aapt_friendly_merged_manifests/debug/aapt/output.json

@@ -0,0 +1 @@
+[{"outputType":{"type":"AAPT_FRIENDLY_MERGED_MANIFESTS"},"apkData":{"type":"MAIN","splits":[],"versionCode":-1,"enabled":true,"outputFile":"react-native-maps-debug.aar","fullName":"debug","baseName":"debug"},"path":"AndroidManifest.xml","properties":{"packageId":"com.airbnb.android.react.maps","split":""}}]

package/lib/android/build/intermediates/aapt_friendly_merged_manifests/{debug/processDebugManifest → release}/aapt/AndroidManifest.xml

@@ -3,8 +3,8 @@
     package="com.airbnb.android.react.maps" >
 
     <uses-sdk
-        android:minSdkVersion="16"
-        android:targetSdkVersion="28" />
+        android:minSdkVersion="21"
+        android:targetSdkVersion="29" />
 
     <uses-permission android:name="android.permission.INTERNET" />
     <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

package/lib/android/build/intermediates/aapt_friendly_merged_manifests/release/aapt/output.json

@@ -0,0 +1 @@
+[{"outputType":{"type":"AAPT_FRIENDLY_MERGED_MANIFESTS"},"apkData":{"type":"MAIN","splits":[],"versionCode":-1,"enabled":true,"outputFile":"react-native-maps-release.aar","fullName":"release","baseName":"release"},"path":"AndroidManifest.xml","properties":{"packageId":"com.airbnb.android.react.maps","split":""}}]