React Native Maps — Best Practices & Complete Guide

react-native-maps 1.26.20+ / Expo SDK 54/55 / React Native 0.81.1+ / New Architecture Compatible

Critical Rules

1. Always use npx expo install react-native-maps — ensures version compatibility with your Expo SDK.
2. Never commit API keys — use environment variables via app.config.js with process.env.
3. Always restrict API keys — Android: package name + SHA-1; iOS: bundle identifier; API: Maps SDK only.
4. Always run npx expo prebuild --clean after changing map config in app.json/app.config.js.
5. Use initialRegion not region unless you need controlled map positioning — region causes re-renders on every pan.
6. Memoize marker arrays with useMemo — recreating marker elements every render causes lag.
7. Use React.memo for custom marker components — prevents unnecessary re-renders of all markers.
8. Use clustering for 50+ markers — install react-native-map-clustering to avoid frame drops.
9. Handle the null map ref — always check mapRef.current before calling methods like animateToRegion.
10. Request location permissions before enabling showsUserLocation — otherwise the map silently fails on iOS.

Version Compatibility