navigator.geolocation.watchPosition()

navigator.geolocation.watchPosition() - додає обробника події, який автоматично виконується при зміні місця розташування.

Синтаксис:

id = window.navigator.geolocation.watchPosition( success[, error[, options]] );

Параметри:

id - зміна яка отримує ідентифікатор обробника події.

window - не обов'язково вказувати. Об'єкт window.

navigator - об'єкт navigator.

geolocation - об'єкт geolocation.

success - Обов'язковий параметр. Функція зворотнього виклику , яка викликається при отримані даних геолокації і приймає об'єкт Position в якості єдиного параметра.

coords.latitude - широта
coords.longitude - довгота
coords.accuracy - точність положення.
coords.altitude - висота в метрах над середнім рівнем моря (повертається, якщо є)
coords.altitudeAccuracy - точність висоти положення (повертається, якщо є)
coords.heading - кількість градусів за годинниковою стрілкою з півночі (повертається, якщо є)
coords.speed - швидкість в метрах в секунду (повертається, якщо є).
timestamp - дата / часу визначення місця розташування

error - функція зворотнього виклику, яка викликається при виникненні помилки.

options - об'єкт який містить додаткові опції.

enableHighAccuracy - висока точність, true або false. Якщо включена висока точність то потрібно більше часу для отримання більш точного місця розташування.
timeout - скільки максимум мілісекунд браузер повинен чекати на отримання даних геолокації.
maximumAge - скільки мілісекунд можливо від передніх даних геолокації.

Опис:

watchPosition() метод об'єкта geolocation який реєструє обробника події яка відбувається кожного разу при зміні місцезнаходження пристрою користувача.

Метод watchPosition() повертає id обробника, за яким його можна видалити за допомогою clearWatch().

Приклад:

function pozitions(pos){
var div=document.createElement('div');
div.innerHTML= Date(pos.timestamp)+" <b>широта:</b> "+pos.coords.latitude+" <b>довгота:</b> "+pos.coords.longitude+" <b>швидкість:</b> "+pos.coords.speed+" м/с";
document.getElementById("test").appendChild(div);
}	

if(navigator.geolocation)
navigator.geolocation.watchPosition(pozitions, function(e){alert(e.message);});
else alert('Ваш браузер Не підтримує геолокацію');