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

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

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

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

Метод getCurrentPosition приймає три параметри: перший – це колбек на успішний результат, другий – обробка помилок, а третій – об’єкт параметрів, який може змінити налаштування, наприклад, "час життя" кешованих координат та максимально допустиме очікування відповіді. За замовчуванням браузер запитує дозволу в користувача на використання його даних геолокації при першому виклику цього методу.

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

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

правити

Порада

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

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

Порада

Використовуйте watchPosition, якщо вам потрібно постійне відстеження місця користувача (наприклад, у додатках для доставки або відстеження маршрутів). Однак будьте обережні, оскільки це може швидко витратити заряд батареї користувача.

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

Порада

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

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

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

Синтаксис

position.coords.latitude;

Переглядачі

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

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

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

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

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

Приклади

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

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

navigator.geolocation.getCurrentPosition((position) => {
 const latitude = position.coords.latitude;
 console.log(`Ваше місце розташування у північній півкулі: ${latitude >= 0}`);
});