JavaScript. Подробное руководство, 6-е издание

Флэнаган Дэвид

readonly boolean rangeOverflow

Объем введенных данных слишком велик.

readonly boolean rangeUnderflow

Объем введенных данных слишком мал.

readonly boolean stepMismatch

Введенные данные не соответствуют указанному шагу.

readonly boolean tooLong

Объем введенных данных слишком велик.

readonly boolean typeMismatch

Введенные данные имеют неверный тип.

readonly boolean valid

Если

это свойство имеет значение true, элемент формы содержит корректные данные и все другие свойства имеют значение false. Если это свойство имеет значение false, элемент формы содержит недопустимые данные и, по крайней мере, одно из других свойств имеет значение true.

readonly boolean valueMissing

Элемент формы пуст, хотя он должен быть заполнен.

Geocoordinates

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

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

Свойства

readonly double accuracy

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

latitude

и

longitude

) в метрах.

readonly double altitude

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

readonly double altitudeAccuracy

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

altitude

) над уровнем моря в метрах. Если свойство

altitude

имеет значение null, свойство

altitudeAccuracy

также будет иметь значение null.

readonly double heading

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

readonly double latitude

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

readonly double longitude

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

readonly double speed

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

Geolocation

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

Объект

Geolocation

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

Geolocation

можно получить через объекта

Navigator

, обратившись к свойству

navigator.geolocation

.

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

Geoposition

, а ошибки - в форме объектов

GeolocationError

.

Методы

void clearWatch(long watchId)

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

watchPosition

.

void getCurrentPosition(function success, [function error], [object options])

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

Geoposition

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

GeolocationError

.

long watchPosition(function success, [function error], [object options])

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

getCurrentPosition

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

clearWatch,

чтобы остановить слежение за местонахождением пользователя.

Параметры

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

getCurrentPosition

и

watchPosition,

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

boolean enableHighAccuracy

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

long maximumAge

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

Geoposition

был передан функции обратного вызова

success

. По умолчанию имеет значение 0, т.е. каждый вызов метода

getCurrentPosition

или

watchPosition

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

Geoposition

, полученный в течение последней минуты.