{"_id":"@aaronkyriesenbach/react-native-place-picker","name":"@aaronkyriesenbach/react-native-place-picker","dist-tags":{"latest":"3.2.0"},"versions":{"3.2.0":{"name":"@aaronkyriesenbach/react-native-place-picker","version":"3.2.0","description":"Pick place with single click","main":"build/index.js","types":"build/index.d.ts","scripts":{"build":"expo-module build","clean":"expo-module clean","lint":"expo-module lint","test":"expo-module test","prepare":"expo-module prepare","prepublishOnly":"expo-module prepublishOnly","expo-module":"expo-module","open:ios":"xed example/ios","open:android":"open -a \"Android Studio\" example/android"},"keywords":["react-native","expo","react-native-place-picker","ReactNativePlacePicker"],"repository":{"type":"git","url":"git+https://github.com/b0iq/react-native-place-picker.git"},"bugs":{"url":"https://github.com/b0iq/react-native-place-picker/issues"},"author":{"name":"b0iq","email":"contact@b0iq.com","url":"https://github.com/b0iq"},"license":"MIT","homepage":"https://github.com/b0iq/react-native-place-picker#readme","dependencies":{},"devDependencies":{"@types/react":"^18.3.7","expo-module-scripts":"^3.5.2","expo-modules-core":"^1.12.24"},"peerDependencies":{"expo":"*","react":"*","react-native":"*"},"packageManager":"yarn@1.22.22","_id":"@aaronkyriesenbach/react-native-place-picker@3.2.0","gitHead":"995af1af41ef1ec82fd4c2f2217461e8ef701bbb","_nodeVersion":"24.9.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-rUfMZaPoiKIQwoqUh/yNREbTvMYEpJe/h3/iCK4ti6wl5el1r517pnA2oBWa/wAx+XXMR7XRbaHlI9AXoDKxlQ==","shasum":"5a415050aae526ed9d9f3a3eb6baf05754f96d43","tarball":"https://registry.npmjs.org/@aaronkyriesenbach/react-native-place-picker/-/react-native-place-picker-3.2.0.tgz","fileCount":64,"unpackedSize":124544,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEAlqq8zKUIMTWBSSpGRY4iZQOlNLAE9iv90xFWXGXVbAiEAy3UZz+isTRdJ3ebUVI/vWCcqrz+GeZSuDYdR4wpCiTE="}]},"_npmUser":{"name":"aaronkyriesenbach","email":"npm.shimmy035@passmail.net"},"directories":{},"maintainers":[{"name":"aaronkyriesenbach","email":"npm.shimmy035@passmail.net"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/react-native-place-picker_3.2.0_1769297725495_0.2384143484915342"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-24T23:35:25.147Z","3.2.0":"2026-01-24T23:35:25.654Z","modified":"2026-01-24T23:35:25.821Z"},"maintainers":[{"name":"aaronkyriesenbach","email":"npm.shimmy035@passmail.net"}],"description":"Pick place with single click","homepage":"https://github.com/b0iq/react-native-place-picker#readme","keywords":["react-native","expo","react-native-place-picker","ReactNativePlacePicker"],"repository":{"type":"git","url":"git+https://github.com/b0iq/react-native-place-picker.git"},"author":{"name":"b0iq","email":"contact@b0iq.com","url":"https://github.com/b0iq"},"bugs":{"url":"https://github.com/b0iq/react-native-place-picker/issues"},"license":"MIT","readme":"
\n \n### Features\n\n- [x] π¨ Theme customization.\n- [x] π± UI written natively.\n- [x] πΊοΈ Location reverse-geocoding (coordinate -> address).\n- [x] π Searchable (users can search for location).\n- [x] π Device location.\n- [x] βοΈ Fully configurable.\n- [x] ποΈ Supporting Turbo Modules (New Arch) with backward compatibility.\n- [x] β‘ Renders on top of the app (Blazing Fast).\n- [x] π Well typed.\n- [x] π¦ Significantly small package.\n- [x] π No peer dependencies except React and React-Native [[1]](#extra).\n\n### How is it working?\n\n> 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\n\n## Installation\n\n```sh\nnpm install react-native-place-picker\n# or\nyarn add react-native-place-picker\n# or\npnpm add react-native-place-picker\n# or\nbun add react-native-place-picker\n```\n\n### Expo\n\n- You need to add `expo-dev-client` and run `expo run:ios` or `expo run:android`\n\n> **Info** Expo managed app not supported π§\n\n### iOS\n\n- If you want to enable user current location button you have to add this to your `Info.plist`\n\n```xml\nNSLocationWhenInUseUsageDescription\nYOUR_PURPOSE_HERE\n```\n\n### Android β οΈ\n\n- Add to your `AndroidManifest.xml` you Google Map API Key or your application will crash\n\n```xml\n\n```\n\n### Request\n\n```js\nimport { pickPlace } from \"react-native-place-picker\";\n\npickPlace({\n enableUserLocation: true,\n enableGeocoding: true,\n color: \"#FF00FF\",\n // Open at user's current location\n initialCoordinates: \"userLocation\",\n // Range selection (optional)\n enableRangeSelection: true,\n initialRadius: 2000,\n minRadius: 250,\n maxRadius: 10000,\n radiusColor: '#FF00FF33',\n radiusStrokeColor: '#FF00FF',\n radiusStrokeWidth: 2,\n //...etc\n})\n .then(console.log)\n .catch(console.log);\n\n// or with specific coordinates\n\npickPlace({\n initialCoordinates: { latitude: 25.2048, longitude: 55.2708 }\n}).then(console.log).catch(console.log);\n\n// or with defaults\n\npickPlace().then(console.log).catch(console.log);\n```\n\n### Result\n\n```ts\n\n{\n /**\n * @description Selected coordinate.\n */\n coordinate: PlacePickerCoordinate;\n /**\n * @description Geocoded address for selected location.\n * @if `enableGeocoding: true`\n */\n address?: PlacePickerAddress;\n /**\n * @description Did cancel the place picker window without selecting.\n */\n didCancel: boolean;\n}\n\n```\n\n### PlacePickerOptions\n\n| Property | Type | Description | Default |\n| -------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------- |\n| `presentationStyle` | `PlacePickerPresentationStyle` \\| string | Presentation style of the place picker window. **iOS only** | `'fullscreen'` |\n| `title` | `string` | The title of the place picker window. | `'Choose Place'` |\n| `searchPlaceholder` | `string` | Placeholder for the search bar in the place picker window. | `'Search...'` |\n| `color` | `string` | Primary color of the theme (map pin, shadow, etc.). | `'#FF0000'` |\n| `contrastColor` | `string` | Contrast color for the primary color. | `'#FFFFFF'` |\n| `locale` | `string` | Locale for the returned address. | `'en-US'` |\n| `initialCoordinates` | `PlacePickerCoordinate` \\| `\"userLocation\"` | Initial map position. Use `\"userLocation\"` to open at user's current location. | `{ latitude: 25.2048, longitude: 55.2708 }` |\n| `enableGeocoding` | `boolean` | geocoding for the selected address. | `true` |\n| `enableSearch` | `boolean` | search bar for searching specific positions. | `true` |\n| `enableUserLocation` | `boolean` | current user position button. Requires setup. | `true` |\n| `enableLargeTitle` | `boolean` | large navigation bar title of the UIViewController. **iOS only** | `true` |\n| `rejectOnCancel` | `boolean` | Reject and return nothing if the user dismisses the window without selecting a place. | `true` |\n| `enableRangeSelection` | `boolean` | Enable draggable radius selection overlay. | `false` |\n| `initialRadius` | `number` | Initial radius in meters when range selection is enabled. | `1000` |\n| `minRadius` | `number` | Minimum allowed radius in meters. | `100` |\n| `maxRadius` | `number` | Maximum allowed radius in meters. | `10000` |\n| `radiusColor` | `string` | Fill color of radius circle (falls back to `color` with alpha). | `''` |\n| `radiusStrokeColor` | `string` | Stroke color of radius circle (falls back to `color`). | `''` |\n| `radiusStrokeWidth` | `number` | Stroke width of radius circle in pixels. | `2` |\n\n### PlacePickerPresentationStyle\n\n| Enum Value | Description |\n| ------------ | -------------------------------------- |\n| `modal` | Presentation style as a modal window. |\n| `fullscreen` | Presentation style in fullscreen mode. |\n\n### PlacePickerAddress\n\n| Property | Type | Description |\n| ------------ | -------- | --------------------------- |\n| `name` | `string` | Name of the location. |\n| `streetName` | `string` | Street name of the address. |\n| `city` | `string` | City of the address. |\n| `state` | `string` | State of the address. |\n| `zipCode` | `string` | Zip code of the address. |\n| `country` | `string` | Country of the address. |\n\n### PlacePickerCoordinate\n\n| Property | Type | Description |\n| ----------- | -------- | -------------------------- |\n| `latitude` | `number` | Latitude of the location. |\n| `longitude` | `number` | Longitude of the location. |\n\n### PlacePickerResults\n\n| Property | Type | Description |\n| ------------ | ----------------------- | -------------------------------------------------------------- |\n| `coordinate` | `PlacePickerCoordinate` | Selected coordinate. |\n| `address` | `PlacePickerAddress` | Geocoded address for selected location (if `enableGeocoding`). |\n| `didCancel` | `boolean` | Indicates if the place picker was canceled without selecting. |\n| `radius` | `number` | Selected radius in meters (if range selection enabled). |\n| `radiusCoordinates` | `{ center, bounds }` | Center and bounds of the selected area. |\n\n## Contributing\n\nSee the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-8c23a3a86949b5a27f22ae6a81a7d98d"}
![\"NPM](\"https://badge.fury.io/js/react-native-place-picker.svg\"){kind=icon}
\n \n \n ![\"Tests](\"https://github.com/anuraghazra/github-readme-stats/workflows/Test/badge.svg\"){kind=icon}
\n \n \n ![\"GitHub](\"https://img.shields.io/github/contributors/b0iq/react-native-place-picker\")
\n \n \n ![](\"https://codecov.io/gh/b0iq/react-native-place-picker/branch/master/graph/badge.svg\"){kind=icon}
\n \n \n ![\"Issues\"](\"https://img.shields.io/github/issues/b0iq/react-native-place-picker?color=0088ff\")
\n \n \n ![\"GitHub](\"https://img.shields.io/github/issues-pr/b0iq/react-native-place-picker?color=0088ff\")
\n \n