React Native Google's Panorama/StreetView component for iOS and Android.


yarn add react-native-streetview

Link the native dependencies:

react-native link react-native-streetview


  1. Install GoogleMaps SDK for iOS using CocoaPods:

  2. Add your API key to AppDelegate:

    Go to to check your credentials.

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
    	[GMSServices provideAPIKey:@"YOUR-API-KEY-HERE"];


  1. Install Google Play services using SDK Manager in Android Studio

  2. Add your API key to Manifest file (android\app\src\main\AndroidManifest.xml):

    Go to to check your credentials.

      <!-- You will only need to add this meta-data tag, but make sure it's a child of application -->

This installation should work in physical devices and iOS Simulator. For Genymotion, be sure to check Android installation about Google Play Services



import StreetView from 'react-native-streetview';

Add StreetView component

<View style={styles.container}>
      'latitude': -33.852,
      'longitude': 151.211

Use position absolute for layout

const styles = StyleSheet.create({
  container: {
    flex: 1
  streetView: {
    position: 'absolute',
    top: 0,
    left: 0,
    right: 0,
    bottom: 0,

Notice: if you are using react-navigation. There is a known bug where a black window appears upon dismissal
of StreetView's container screen - if it was deployed on full screen.
A workaround solution is to bound StreetView with some margins.
See issue 12


Prop Type Default Description
allGesturesEnabled bool true Enables user interaction (orientation, zoom, navigation)
coordinate shape null Request panorama near the coordinate
radius number 50 Specify a search radius, in meters, around the coordinate


The 'example' folder contains a fully working example for iOS and Android.
To run the example on iOS do the following:

$ cd example
$ yarn
$ cd ios
$ pod install

Edit AppDelegate.m to add your API key:
[GMSServices provideAPIKey:@"YOUR-API-KEY-HERE"];

$ react-native run-ios

To run the example on Android do the following:

$ cd example
$ yarn

Edit AndroidManifest.xml to add your API key:

$ react-native run-android

Roadmap and help?

This component was built to have Street View ability in our Home Renting app, Nester.
There is much to go forward, with camera and heading setup, markers, etc. We will gradually add those in the next releases.
Feel free to fork and submit PR's. We'll really appriciate any effort, especially on Android ;(