react-native-geocoder

geocoding services for react native

Version table

Geocoder Version	RN
>=0.5.0	>= 0.47.0
>=0.4.6	>= 0.40.0
<0.4.5	<0.40.0

Install

npm install --save react-native-geocoder

iOS

1. In the XCode's "Project navigator", right click on Libraries folder under your project ➜ Add Files to <...>
2. Go to node_modules ➜ react-native-geocoder and add ios/RNGeocoder.xcodeproj file
3. Add libRNGeocoder.a to "Build Phases" -> "Link Binary With Libraries"

Android

1. In android/setting.gradle

...
include ':react-native-geocoder', ':app'
project(':react-native-geocoder').projectDir =newFile(rootProject.projectDir, '../node_modules/react-native-geocoder/android')

3. In android/app/build.gradle

...
dependencies {
...
compile project(':react-native-geocoder')
}

4. register module (in MainApplication.java)

importcom.devfd.RNGeocoder.RNGeocoderPackage; // <--- importpublicclassMainActivityextendsReactActivity {
......
@OverrideprotectedList<ReactPackage> getPackages() {
returnArrays.<ReactPackage>asList(
newMainReactPackage(),
newRNGeocoderPackage()); // <------ add this
}
......
}

Usage

import Geocoder from 'react-native-geocoder';
// Position Geocoding
var NY = {
lat: 40.7809261,
lng: -73.9637594
};
Geocoder.geocodePosition(NY).then(res => {
// res is an Array of geocoding object (see below)
})
.catch(err => console.log(err))
// Address Geocoding
Geocoder.geocodeAddress('New York').then(res => {
// res is an Array of geocoding object (see below)
})
.catch(err => console.log(err))

Fallback to google maps geocoding

Geocoding services might not be included in some Android devices (Kindle, some 4.1 devices, non-google devices). For those special cases the lib can fallback to the online google maps geocoding service

importGeocoderfrom'react-native-geocoder';// simply add your google keyGeocoder.fallbackToGoogle(MY_KEY);// use the lib as usualletret=awaitGeocoder.geocodePosition({lat, lng})// you get the same results

With async / await

try {
const res = await Geocoder.geocodePosition(NY);
...
const res = await Geocoder.geocodeAddress('London');
...
}
catch(err) {
console.log(err);
}

Geocoding object format

both iOS and Android will return the following object:

{position: {lat, lng},formattedAddress: String,// the full addressfeature: String|null,// ex Yosemite Park, Eiffel TowerstreetNumber: String|null,streetName: String|null,postalCode: String|null,locality: String|null,// city namecountry: String,countryCode: StringadminArea: String|nullsubAdminArea: String|null,subLocality: String|null}

Notes

iOS

iOS does not allow sending multiple geocoding requests simultaneously, hence if you send a second call, the first one will be cancelled.

Android

geocoding may not work on older android devices (4.1) and will not work if Google play services are not available.