JS властивість Geolocation.longitude

Загальний опис

longitude – це властивість, яка повертає довготу поточного місця розташування користувача в градусах, використовуючи можливості геолокації пристрою. Властивість longitude доступна в об’єкті coords, який міститься у відповіді методів getCurrentPosition або watchPosition з об’єкта navigator.geolocation. Це значення дає змогу веб-додаткам ідентифікувати місце розташування користувача і використовувати його для навігаційних цілей або локалізованих сервісів.

Щоб отримати longitude, розробник викликає navigator.geolocation.getCurrentPosition, який приймає колбек-функцію, де у відповідь на успішне виконання передається об’єкт position. У цьому об’єкті position.coords.longitude повертає поточне значення довготи у форматі десяткового числа. Наприклад, за допомогою console.log(position.coords.longitude) можна вивести в консоль числове значення довготи користувача. Метод getCurrentPosition також має опції для налаштування точності отримання координат, часу очікування та обробки помилок, коли геолокація недоступна або користувач відмовляє в дозволі.

Окрім getCurrentPosition, метод watchPosition дозволяє отримувати оновлення довготи в реальному часі, наприклад, коли користувач пересувається. Метод watchPosition приймає подібні параметри, але повертає watchId, за допомогою якого можна зупинити стеження, викликавши navigator.geolocation.clearWatch(watchId). longitude може використовуватися у додатках для відображення поточного місця на мапі, для обчислення відстаней між точками або налаштування контенту залежно від розташування користувача.

navigator.geolocation.getCurrentPosition((position) => {
const longitude = position.coords.longitude;
console.log(`Поточна довгота: ${longitude}`);
}, (error) => {
console.error("Помилка геолокації:", error);
});

Розробникам слід враховувати, що для використання longitude потрібен дозвіл користувача на доступ до його геолокації. Отримане значення залежить від точності доступних даних геолокації, таких як GPS, мережі Wi-Fi або дані мобільного зв’язку. Довгота використовується разом із широтою (latitude) для точного визначення місця користувача.

правити

Порада

Зберігайте watchId, щоб при необхідності зупинити постійне оновлення геолокації. Це економить батарею і ресурси пристрою, коли користувач не потребує відстеження в реальному часі.

автор: Bond правити

Порада

Для тестування геолокації в умовах реальної роботи з мапою використовуйте інструменти розробника браузера, які дозволяють емуляцію різних місць. Це дозволить вам протестувати довготу без фізичної зміни локації.

автор: Bond правити

Порада

Використовуйте enableHighAccuracy для підвищення точності довготи. Це особливо корисно, коли ви працюєте з додатками для навігації або точного розташування, але майте на увазі, що це може збільшити час обробки запиту.

автор: Bond правити

+ додати пораду чи нотатку

Синтаксис

position.coords.longitude;

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
	5	3.5	5	16	12

Підтримка: мобільні переглядачі

Переглядач
	37	18	4	3

Підтримка: серверні переглядачі

Переглядач
	-	-

Приклади

+ запропонувати свій приклад у пісочниці

navigator.geolocation.getCurrentPosition((position) => {
 const longitude = position.coords.longitude;
 console.log(`Ви знаходитесь ${longitude >= 0 ? 'на схід' : 'на захід'} від Гринвіча`);
});

navigator.geolocation.getCurrentPosition((position) => {
 const longitude = position.coords.longitude;
 const distanceFromPrimeMeridian = Math.abs(longitude * 111);
 console.log(`Відстань до нульового меридіана приблизно ${distanceFromPrimeMeridian} км.`);
});