react-native-maps /react-native-maps
React Native Mapview component for iOS + Android
★ 16,017⑂ 4,957👁 210⑃ 1,564● 4,156▤ 390
+0
Daily
16,017
stars
4,957
forks
210
watchers
1,564
prs
4,156
issues
390
releases
README
react-native-maps
React Native Map components for iOS + Android
Contributing
This project is being maintained by a small group of people, and any help with issues and pull requests are always appreciated. If you are able and willing to contribute, please read the guidelines.
Installation
See Installation Instructions.
See Setup Instructions for the Included Example Project.
Compatibility
React Native Compatibility
Version Requirements:
Compatibility
Fabric (New Architecture)
| Version | React Native Requirement |
| ---------------- | ------------------------ |
| 1.26.1+ | = 0.81.1 |
| 1.26.0 and below | = 0.76 |
Old Architecture
| Version | React Native Requirement |
| --------------- | ------------------------ |
| 1.14.0 - 1.20.1 | = 0.74 |
| = 0.64.3 |
Component API
Component API
Component API
Component API
Component API
Component API
Component API
Component API
Component API
Component API
General Usage
js
import MapView from 'react-native-maps';
or
js
var MapView = require('react-native-maps');
This MapView component is built so that features on the map (such as Markers, Polygons, etc.) are
specified as children of the MapView itself. This provides an intuitive and react-like API for
declaratively controlling features on the map.
Rendering a Map with an initial region
MapView
jsx
Using a MapView while controlling the region as state
jsx
getInitialState() {
return {
region: {
latitude: 37.78825,
longitude: -122.4324,
latitudeDelta: 0.0922,
longitudeDelta: 0.0421,
},
};
}
onRegionChange(region) {
this.setState({ region });
}
render() {
return (
);
}
Rendering a list of markers on a map
jsx
import {Marker} from 'react-native-maps';
{this.state.markers.map((marker, index) = (
))}
;
Rendering a Marker with a custom image
1. You need to generate an png image with various resolution (lets call them custom_pin) - for more information go to Android, iOS
2. put all images in Android drawables and iOS assets dir
3. Now you can use the following code:
jsx
Note: You can also pass the image binary data like image={require('custom_pin.png')}, but this will not scale good with the different screen sizes.
Rendering a Marker with a custom view
Note: This has performance implications, if you wish for a simpler solution go with a custom image (save your self the headache)
jsx
Rendering a custom Marker with a custom Callout
jsx
import {Callout} from 'react-native-maps';
;
Draggable Markers
jsx
this.setState({ x: e.nativeEvent.coordinate })}
/
Using a custom Tile Overlay
Tile Overlay using tile server
jsx
import {UrlTile} from 'react-native-maps';
;
For Android: add the following line in your AndroidManifest.xml
xml
For IOS: configure App Transport Security in your app
Tile Overlay using Top issues
#5700Migration to Swift Package Manager due to Google Maps SDK deprecation of CocoaPods51 comments · 2025-08-19#5178Possible memory leak in Android40 comments · 2024-10-04#5728Android: Custom markers don't display fully with tracksViewChanges={false}32 comments · 2025-09-09#5778[Android] Markers showing default red pin when navigating back to MapView screen26 comments · 2025-10-15#5836Marker not rendering on Android with RN 0.81 + react-native-maps 1.26.x24 comments · 2026-01-13#5907Map Flickers on Navigation with Fabric Enabled14 comments · 2026-04-22#5814Android crash when navigating back from screen with MapView component13 comments · 2025-11-19#5520this.getNativeComponent undefined error and Cannot read property ‘bubblingEventTypes’ of null tell you how to fix in Fabric8 comments · 2025-05-26
Discussions
#6008Maps SDK for Android blank (epoch -1) in Play AAB only — works in debug and sideloaded release APK1 comments · 2026-09-19#5946No flat prop in NativeComponentMarker.0 comments · 2026-06-29#5903In android react-native map do not render markers and crash for react-native 0.84.01 comments · 2026-04-17#5869In android build react native map is not render tiles it simply renders a blank dull orange Screen2 comments · 2026-02-26#5829com.google.maps.api.android.lib6.phoenix0 comments · 2026-01-07#5825Animation Marker only works on iOS, on Android does not0 comments · 2025-12-25#5804React Native 0.81 - Precompiled iOS Builds1 comments · 2025-11-10#5802Google Android Maps SDK: Authorization failure1 comments · 2025-11-09
Latest release
v1.29.11 v1.29.11 2026-09-271.29.11 (2026-09-27) Bug Fixes ios: keep google marker icon when the marker is re-added to the map (5950) (b16c1af)