географическое местонахождение

Объект этого типа является представлением точки на поверхности Земли.

Свойства

Точность определения широты и долготы (свойства

и ) в метрах.

Высота над уровнем моря в метрах или null, если информация о высоте недоступна.

Точность определения высоты (свойство

) над уровнем моря в метрах. Если свойство имеет значение null, свойство также будет иметь значение null.

Направление движения пользователя в градусах относительно направления на истинный север или null, если информация о направлении недоступна. Если информация о высоте доступна, но скорость (свойство speed) движения равна нулю, то свойство heading будет иметь значение NaN.

Широта местоположения пользователя в градусах с долями к северу от экватора.

Долгота местоположения пользователя в градусах с долями к востоку от Гринвичского меридиана.

Скорость движения пользователя в метрах в секунду или null, если информация о скорости недоступна. Это свойство никогда не принимает отрицательные значения. См. также heading.

позволяет получить широту и долготу местоположения пользователя

Объект

определяет методы, позволяющие получить точные географические координаты местоположения пользователя. В броузерах, поддерживающих такую возможность, объект можно получить через объекта , обратившись к свойству . Методы, описываемые ниже, опираются на использование некоторых других типов: местоположение определяется в форме объекта , а ошибки - в форме объектов .

Методы

Останавливает слежение за местонахождением пользователя. В аргументе watchId должно передаваться значение, полученное соответствующим вызовом метода

.

Асинхронно определяет местонахождение пользователя с учетом параметров options (перечень свойств объекта option приводится ниже). Этот метод немедленно возвращает управление, а когда местонахождение пользователя будет определено, указанной функции обратного вызова success будет передан объект

. Или в случае ошибки (возможно из-за того, что пользователь не дал разрешение на определение его координат) функции обратного вызова error будет передан объект .

Этот метод похож на метод

, но после определения текущего местонахождения пользователя он продолжает следить за его координатами и вызывает функцию success каждый раз, когда обнаружит существенное их изменение. Возвращает число, которое можно передать методу чтобы остановить слежение за местонахождением пользователя.

Параметры

Аргумент options, передаваемый методам

и является обычным объектом, содержащим ноль или более свойств из числа следующих:

Этот параметр говорит о желательности определения координат с высокой точностью, даже если это повлечет увеличение расхода энергии в аккумуляторах. По умолчанию имеет значение false. В устройствах, способных определять местонахождение посредством измерения мощности сигналов WiFi или с помощью GPS, установка этого параметра в значение true обычно означает «использовать GPS».

Этот параметр определяет максимальное время (в миллисекундах), прошедшее с того момента, как объект

был передан функции обратного вызова . По умолчанию имеет значение 0, т.е. каждый вызов метода или будет заново определять местонахождение. Если установить этот параметр в значение 60000, например, то реализации будет позволено возвращать любой объект , полученный в течение последней минуты.