JS метод Geolocation.getCurrentPosition()

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

getCurrentPosition — це метод об'єкта navigator.geolocation, який дозволяє отримати поточні координати користувача, такі як широта та довгота, використовуючи геолокаційні сервіси браузера. Цей метод асинхронний і приймає три параметри: функцію для обробки успішного виконання, функцію для обробки помилок та об'єкт параметрів, що дозволяє налаштувати поведінку запиту.

Функція successCallback, яка передається як перший параметр, викликається, коли геолокація успішно отримана. Вона отримує об'єкт position, який містить інформацію про координати користувача.

function success(position) {
    console.log(`Широта: ${position.coords.latitude}`);
    console.log(`Довгота: ${position.coords.longitude}`);
}

Другий параметр — це функція errorCallback, яка викликається, якщо сталася помилка під час отримання геолокації. Вона отримує об'єкт error, що містить код помилки і повідомлення.

function error(error) {
    console.warn(`Помилка: ${error.code} - ${error.message}`);
}

Третій параметр — це об'єкт options, який дозволяє налаштувати поведінку запиту. Наприклад, ви можете задати максимальний час на отримання геолокації або точність даних.

let options = {
    enableHighAccuracy: true,  // Включення високої точності
    timeout: 5000,             // Ліміт часу (5 секунд)
    maximumAge: 0              // Не використовувати кешовані дані
};

navigator.geolocation.getCurrentPosition(success, error, options);

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

правити

Порада

Якщо ваша програма працює в середовищі з обмеженою підтримкою геолокації (наприклад, на старих браузерах або девайсах), не забувайте перевіряти підтримку API через if ("geolocation" in navigator) перед виконанням запиту.

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

Порада

Якщо потрібно регулярно отримувати оновлене місцезнаходження користувача, замість getCurrentPosition використовуйте метод watchPosition. Він дозволяє слідкувати за зміною координат у реальному часі.

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

Порада

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

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

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

Синтаксис

navigator.geolocation.getCurrentPosition(successCallback, errorCallback, options);

Повернення

Promise

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

• Успішний результат: Якщо геолокація була отримана успішно, то в перший параметр функції successCallback передається об'єкт position, який містить координати (широту та довготу) користувача, а також інші дані, як точність і висота (якщо доступні).

  • Наприклад, position.coords.latitude дає широту, а position.coords.longitude — довготу.

• Помилка: Якщо виникла помилка, наприклад, користувач відмовився від надання доступу до геолокації, то другий параметр функції errorCallback міститиме об'єкт помилки, який включає код помилки (наприклад, PERMISSION_DENIED, POSITION_UNAVAILABLE, або TIMEOUT) і повідомлення про помилку.

автор: Bond

правити

Переглядачі

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

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

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

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

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

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

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

Приклади

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

navigator.geolocation.getCurrentPosition(function(position) {
    const latitude = position.coords.latitude;
    const longitude = position.coords.longitude;

    fetch(`https://api.yelp.com/v3/businesses/search?term=restaurants&latitude=${latitude}&longitude=${longitude}`)
        .then(response => response.json())
        .then(data => {
            data.businesses.forEach(restaurant => {
                console.log(`${restaurant.name} - ${restaurant.location.address1}`);
            });
        })
        .catch(error => console.error("Помилка при пошуку ресторанів:", error));
}, function(error) {
    console.error("Не вдалося отримати геолокацію:", error);
});

navigator.geolocation.getCurrentPosition(function(position) {
    const latitude = position.coords.latitude;
    const longitude = position.coords.longitude;
    console.log(`Точне місцезнаходження: Широта: ${latitude}, Довгота: ${longitude}`);
    // Наприклад, тут можна передавати ці координати до служби доставки.
}, function(error) {
    console.error("Не вдалося отримати геолокацію:", error);
});