Geolocation
clearWatch
(long watchId)Останавливает слежение за местонахождением пользователя. В аргументе watchId должно передаваться значение, полученное соответствующим вызовом метода watchPosition().
getCurrentPosition
(function success[, function error][, object options])Асинхронно определяет местонахождение пользователя с учетом параметров options (перечень свойств объекта option приводится ниже). Этот метод немедленно возвращает управление, а когда местонахождение пользователя будет определено,указанной функции обратного вызова success будет передан объект Geoposition.
Или в случае ошибки (возможно из-за того, что пользователь не дал разрешение наопределение его координат) функции обратного вызова error будет передан объект GeolocationError.
options - обычный объект с атрибутами
enableHighAccuracy. Этот параметр говорит о желательности определения координат с высокой точностью, даже если это повлечет увеличение расхода энергии в аккумуляторах. По умолчанию имеет значение false. В устройствах, способных определять местонахождение посредством измерения мощности сигналов WiFi или с помощью GPS, установка этого параметра в значение true обычно означает «использовать GPS».
maximumAge. Этот параметр определяет максимальное время (в миллисекундах), прошедшее с того момента, как объект Geoposition был передан функции обратного вызова success. По умолчанию имеет значение 0, т. е. каждый вызов метода getCurrentPosition() или watchPosition() будет заново определять местонахождение. Если установить этот параметр в значение 60000, например, то реализации будет позволено возвращать любой объект Geoposition, полученный в течение последней минуты.
timeout. Этот параметр определяет продолжительность ожидания выполнения запросав миллисекундах. По умолчанию имеет значение Infinity. По истечении указанного интервала времени будет вызвана функция обратного вызова error. Обратитевнимание, что время ожидания разрешения пользователя на получение его местонахождения не входит в это значение параметра timeout.
watchPosition
(function success[, function error][, object options])Этот метод похож на метод getCurrentPosition(), но после определения текущего местонахождения пользователя он продолжает следить за его координатами и вызывает функцию success каждый раз, когда обнаружит существенное их изменение.
Возвращает число, которое можно передать методу clearWatch(), чтобы остановитьслежение за местонахождением пользователя.