Введенные данные не соответствуют указанному шагу.
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 должно передаваться значение, полученное соответствующим вызовом метода
Асинхронно определяет местонахождение пользователя с учетом параметров 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, например, то реализации будет позволено возвращать любой объект