JSPM

react-native-geocoding

0.5.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 19456
  • Score
    100M100P100Q135965F
  • License MIT

A React Native module to transform a description of a location (i.e. street address, town name, etc.) into geographic coordinates (i.e. latitude and longitude) and vice versa.

Package Exports

  • react-native-geocoding

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (react-native-geocoding) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

react-native-geocoding

A geocoding module for React Native to transform a description of a location (i.e. street address, town name, etc.) into geographic coordinates (i.e. latitude and longitude) and vice versa.

This module uses Google Maps Geocoding API and requires an API key for purposes of quota management. Please check this link out to obtain your API key.

Install

npm install --save react-native-geocoding

Example

import Geocoder from 'react-native-geocoding';

// Initialize the module (needs to be done only once)
Geocoder.init("xxxxxxxxxxxxxxxxxxxxxxxxx"); // use a valid API key
// With more options
// Geocoder.init("xxxxxxxxxxxxxxxxxxxxxxxxx", {language : "en"}); // set the language

// Search by address
Geocoder.from("Colosseum")
        .then(json => {
            var location = json.results[0].geometry.location;
            console.log(location);
        })
        .catch(error => console.warn(error));

// Search by address, with a biased geo-bounds
Geocoder.from("Pyramid", {
        southwest: {lat: 36.05, lng: -115.25},
        northeast: {lat: 36.16, lng: -115.10}})
        .then(json => {
            var location = json.results[0].geometry.location;
            console.log(location);
        })
        .catch(error => console.warn(error));

// Search by geo-location (reverse geo-code)
Geocoder.from(41.89, 12.49)
        .then(json => {
                var addressComponent = json.results[0].address_components[0];
            console.log(addressComponent);
        })
        .catch(error => console.warn(error));

// Works as well :
// ------------

// location object
Geocoder.from({
    latitude : 41.89,
    longitude : 12.49
});

// latlng object
Geocoder.from({
    lat : 41.89,
    lng : 12.49
});

// array
Geocoder.from([41.89, 12.49]);

Error Codes

Name Code Description
NOT_INITIATED 0 Module hasn't been initiated. Call init function, and pass it your app's api key as parameter.
INVALID_PARAMETERS 1 Parameters are invalid.
FETCHING 2 Error wile fetching to server. The error's 'origin' property contains the fetch error.
PARSING 3 Error while parsing server response. The error's 'origin' property contains the response.
SERVER 4 Error from the server. The error's 'origin' property contains the response's body.

Release Notes

See CHANGELOG.md