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);

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

Синтаксис

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

Параметри

Return

Promise

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

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

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

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

Переглядачі

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

Приклади

• Приклад 1
• Приклад 2
• Приклад 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);
});