Этот плагин предоставляет информацию о местоположении устройства, например, Широта и Долгота. Общие источники информации о местонахождении включают глобальной системы позиционирования (GPS) и местоположение, выведено из сети сигналов, таких как IP-адрес, RFID, WiFi и Bluetooth MAC-адреса и идентификаторы базовых станций сотовой GSM/CDMA. Нет никакой гарантии, что API возвращает фактическое местоположение устройства.
Этот API основан на Спецификации W3C Geolocation APIи выполняется только на устройствах, которые уже не обеспечивают реализацию.
Предупреждение: сбор и использование данных геопозиционирования поднимает вопросы важные конфиденциальности. Политика конфиденциальности вашего приложения должна обсудить, как приложение использует данные геопозиционирования, ли она совместно с другими сторонами и уровень точности данных (например, грубый, тонкий, почтовый индекс уровня, т.д.). Геолокации, как правило, считается конфиденциальной, потому, что она может выявить местонахождение пользователя и, если сохранены, история их путешествия. Таким образом помимо политики конфиденциальности приложения, следует решительно рассмотреть уведомления just-in-time, прежде чем приложение обращается к геолокации (если операционной системы устройства не так уже). Это уведомление должно обеспечивать ту же информацию, отметили выше, а также получения разрешения пользователя (например, путем представления выбора OK и Нет, спасибо). Для получения дополнительной информации пожалуйста, смотрите в руководстве конфиденциальности.
cordova plugin add cordova-plugin-geolocation
Возвращает текущее положение устройства для geolocationSuccess
обратного вызова с Position
объект в качестве параметра. Если есть ошибка, geolocationError
обратного вызова передается PositionError
объект.
navigator.geolocation.getCurrentPosition (geolocationSuccess, [geolocationError], [geolocationOptions]);
geolocationSuccess: обратный вызов, который передается в текущей позиции.
geolocationError: (необязательно) обратного вызова, который выполняется при возникновении ошибки.
geolocationOptions: (необязательно) параметры геопозиционирования.
onSuccess обратного вызова / / этот метод принимает позицию объекта, который содержит / / текущие GPS координаты / / var onSuccess = function(position) {alert (' Широта: ' + position.coords.latitude + «\n» + ' Долгота: ' + position.coords.longitude + «\n» + ' Высота: ' + position.coords.altitude + «\n» + ' точность: ' + position.coords.accuracy + «\n» + ' высоте точность: ' + position.coords.altitudeAccuracy + «\n» + ' заголовок: ' + position.coords.heading + «\n» + ' скорость: ' + position.coords.speed + «\n» + ' штампа времени: ' + position.timestamp + «\n»);}; onError обратного вызова получает объект PositionError / / функция onError(error) {alert (' код: ' + error.code + «\n» + ' сообщение: ' + error.message + «\n»);} navigator.geolocation.getCurrentPosition (onSuccess, onError);
Возвращает текущее положение устройства при обнаружении изменения в позиции. Когда устройство получает новое место, geolocationSuccess
обратного вызова выполняется с Position
объект в качестве параметра. Если есть ошибка, geolocationError
обратного вызова выполняется с PositionError
объект в качестве параметра.
var watchId = navigator.geolocation.watchPosition (geolocationSuccess, [geolocationError], [geolocationOptions]);
geolocationSuccess: обратный вызов, который передается в текущей позиции.
geolocationError: (необязательно) обратного вызова, который выполняется при возникновении ошибки.
geolocationOptions: параметры (необязательно) географического расположения.
navigator.geolocation.clearWatch
прекратить слежение за изменением в положении.onSuccess обратного вызова / / этот метод принимает «Position» объект, который содержит / / текущие GPS координаты / / функция onSuccess(position) {var элемент = document.getElementById('geolocation'); element.innerHTML = ' Широта: ' + position.coords.latitude + ' < br / >' + ' Долгота: ' + position.coords.longitude + ' < br / >' + ' < hr / >' + element.innerHTML; } / / onError обратного вызова получает объект PositionError / / функция onError(error) {alert (' код: ' + error.code + «\n» + ' сообщение: ' + error.message + «\n»);} Опции: Бросьте сообщение об ошибке, если обновление не получено каждые 30 секунд. var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {тайм-аут: 30000});
Необязательные параметры для настройки поиска географического расположенияPosition
.
{maximumAge: 3000, тайм-аут: 5000, enableHighAccuracy: true};
enableHighAccuracy: предоставляет подсказку, что приложению требуются наилучшие результаты. По умолчанию устройство пытается получить Position
с использованием методов на основе сети. Установка этого свойства значение true
указывает среде использовать более точные методы, например спутникового позиционирования. (Логическое значение)
время ожидания: максимальная длина времени (в миллисекундах), которое может пройти от вызова navigator.geolocation.getCurrentPosition
или geolocation.watchPosition
до соответствующих geolocationSuccess
выполняет обратный вызов. Если geolocationSuccess
обратного вызова не вызывается в течение этого времени, geolocationError
обратного вызова передается PositionError.TIMEOUT
код ошибки. (Обратите внимание, что при использовании в сочетании с geolocation.watchPosition
, geolocationError
обратный вызов может быть вызван на интервале каждые timeout
миллисекунд!) (Число)
maximumAge: принять кэшированное положение, возраст которых не превышает указанного времени в миллисекундах. (Число)
Эмуляторы Android 2.x не возвращать результат географического расположения, если enableHighAccuracy
параметр имеет значениеtrue
.
Остановить просмотр для изменения местоположения устройства ссылается watchID
параметр.
navigator.geolocation.clearWatch(watchID);
watchPosition
интервал, чтобы очистить. (Строка)Опции: наблюдать за изменениями в положении и использовать наиболее / / точная позиция приобретение доступным методом. var watchID = navigator.geolocation.watchPosition (onSuccess, onError, {enableHighAccuracy: true}); .. .later на... navigator.geolocation.clearWatch(watchID);
Содержит Position
координат и отметок времени, созданная API геопозиционирования.
CoOrds: набор географических координат. (Координаты)
штамп времени: штамп времени создания для coords
. (Дата)
A Coordinates
объект присоединен к Position
объект, который доступен для обратного вызова функций в запросы для текущей позиции. Он содержит набор свойств, которые описывают географические координаты позиции.
Широта: Широта в десятичных градусах. (Число)
Долгота: Долгота в десятичных градусах. (Число)
Высота: высота позиции в метрах над эллипсоидом. (Число)
точность: уровень точности координат широты и долготы в метрах. (Число)
altitudeAccuracy: уровень точности координат высоты в метрах. (Число)
заголовок: направление движения, указанный в градусах, считая по часовой стрелке относительно истинного севера. (Число)
скорость: Текущая скорость земли устройства, указанного в метрах в секунду. (Число)
altitudeAccuracy: не поддерживается Android устройств, возвращаяnull
.
altitudeAccuracy: не поддерживается Android устройств, возвращаяnull
.
PositionError
Объект передается в geolocationError
функции обратного вызова при возникновении ошибки с navigator.geolocation.
code: один из стандартных кодов ошибок, перечисленных ниже.
сообщение: сообщение об ошибке с подробными сведениями об ошибке.
PositionError.PERMISSION_DENIED
PositionError.POSITION_UNAVAILABLE
PositionError.TIMEOUT
timeout
в geolocationOptions
. При использовании с navigator.geolocation.watchPosition
, эта ошибка может быть неоднократно передан geolocationError
обратного вызова каждый timeout
миллисекунд.