react-native-place-picker

react-native-place-picker

HEADER

NPM Version Tests Passing GitHub Contributors Issues GitHub pull requests

How is it working?

This plugin is built only by create native page UIViewController for iOS or Activity for Android. and present the page in front of React Native Application without any special dependencies just native code

Installation

npm install react-native-place-picker
# or
yarn add react-native-place-picker

Expo

  • You need to add expo-dev-client and run expo run:ios or expo run:android

Info Expo managed app not yet supported 🚧

iOS

  • If you want to enable user current location button you have to add this to your Info.plist
<key>NSLocationWhenInUseUsageDescription</key>
<string>YOUR_PURPOSE_HERE</string>

Android ⚠️

  • Add to your AndroidManifest.xml you Google Map API Key or your application will crash
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="YOUR_KEY" />

Usage

Request

import { pickPlace } from 'react-native-place-picker';

pickPlace({
enableUserLocation: true,
enableGeocoding: true,
color: '#FF00FF',
//...etc
})
.then(console.log)
.catch(console.log);

// or

pickPlace().then(console.log).catch(console.log);

Result


{
/**
* @description Selected coordinate.
*/
coordinate: PlacePickerCoordinate;
/**
* @description Geocoded address for selected location.
* @if `enableGeocoding: true`
*/
address?: PlacePickerAddress;
/**
* @description Did cancel the place picker window without selecting.
*/
didCancel: boolean;
}

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT

Generated using TypeDoc