react-native/Libraries/Geolocation/Geolocation.js

138 lines
3.9 KiB
JavaScript
Raw Normal View History

/**
* Copyright (c) 2015-present, Facebook, Inc.
* All rights reserved.
*
* This source code is licensed under the BSD-style license found in the
* LICENSE file in the root directory of this source tree. An additional grant
* of patent rights can be found in the PATENTS file in the same directory.
*
2015-03-09 10:04:44 +00:00
* @providesModule Geolocation
2015-03-25 18:12:57 +00:00
* @flow
*/
'use strict';
const NativeEventEmitter = require('NativeEventEmitter');
const RCTLocationObserver = require('NativeModules').LocationObserver;
const invariant = require('fbjs/lib/invariant');
const logError = require('logError');
const warning = require('fbjs/lib/warning');
const LocationEventEmitter = new NativeEventEmitter(RCTLocationObserver);
var subscriptions = [];
var updatesEnabled = false;
2015-04-24 23:10:46 +00:00
type GeoOptions = {
timeout: number;
maximumAge: number;
enableHighAccuracy: bool;
distanceFilter: number;
2015-04-24 23:10:46 +00:00
}
/**
* The Geolocation API follows the web spec:
* https://developer.mozilla.org/en-US/docs/Web/API/Geolocation
*
* ### iOS
* You need to include the `NSLocationWhenInUseUsageDescription` key
* in Info.plist to enable geolocation. Geolocation is enabled by default
* when you create a project with `react-native init`.
*
* ### Android
* To request access to location, you need to add the following line to your
* app's `AndroidManifest.xml`:
*
* `<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />`
*
*/
2015-03-09 10:04:44 +00:00
var Geolocation = {
2015-04-24 23:10:46 +00:00
/*
* Invokes the success callback once with the latest location info. Supported
* options: timeout (ms), maximumAge (ms), enableHighAccuracy (bool)
* On Android, this can return almost immediately if the location is cached or
* request an update, which might take a while.
2015-04-24 23:10:46 +00:00
*/
2015-03-25 18:12:57 +00:00
getCurrentPosition: function(
geo_success: Function,
geo_error?: Function,
2015-04-24 23:10:46 +00:00
geo_options?: GeoOptions
2015-03-26 17:06:50 +00:00
) {
invariant(
typeof geo_success === 'function',
'Must provide a valid geo_success callback.'
);
RCTLocationObserver.getCurrentPosition(
geo_options || {},
geo_success,
geo_error || logError
);
2015-03-09 10:04:44 +00:00
},
2015-04-24 23:10:46 +00:00
/*
* Invokes the success callback whenever the location changes. Supported
* options: timeout (ms), maximumAge (ms), enableHighAccuracy (bool), distanceFilter(m)
2015-04-24 23:10:46 +00:00
*/
watchPosition: function(success: Function, error?: Function, options?: GeoOptions): number {
2015-03-09 10:04:44 +00:00
if (!updatesEnabled) {
RCTLocationObserver.startObserving(options || {});
updatesEnabled = true;
}
var watchID = subscriptions.length;
2015-03-09 10:04:44 +00:00
subscriptions.push([
LocationEventEmitter.addListener(
2015-03-09 10:04:44 +00:00
'geolocationDidChange',
success
),
error ? LocationEventEmitter.addListener(
2015-03-09 10:04:44 +00:00
'geolocationError',
error
) : null,
]);
return watchID;
2015-03-09 10:04:44 +00:00
},
2015-03-25 18:12:57 +00:00
clearWatch: function(watchID: number) {
var sub = subscriptions[watchID];
if (!sub) {
// Silently exit when the watchID is invalid or already cleared
// This is consistent with timers
return;
}
2015-03-25 18:12:57 +00:00
2015-03-09 10:04:44 +00:00
sub[0].remove();
2015-03-25 18:12:57 +00:00
// array element refinements not yet enabled in Flow
var sub1 = sub[1]; sub1 && sub1.remove();
subscriptions[watchID] = undefined;
var noWatchers = true;
for (var ii = 0; ii < subscriptions.length; ii++) {
if (subscriptions[ii]) {
noWatchers = false; // still valid subscriptions
}
}
if (noWatchers) {
2015-03-09 10:04:44 +00:00
Geolocation.stopObserving();
}
2015-03-09 10:04:44 +00:00
},
stopObserving: function() {
if (updatesEnabled) {
RCTLocationObserver.stopObserving();
updatesEnabled = false;
for (var ii = 0; ii < subscriptions.length; ii++) {
2015-03-25 18:12:57 +00:00
var sub = subscriptions[ii];
if (sub) {
warning('Called stopObserving with existing subscriptions.');
2015-03-25 18:12:57 +00:00
sub[0].remove();
// array element refinements not yet enabled in Flow
var sub1 = sub[1]; sub1 && sub1.remove();
}
}
subscriptions = [];
}
}
};
2015-03-09 10:04:44 +00:00
module.exports = Geolocation;