API веб-геолокації
Знайти позицію користувача
HTML Geolocation API використовується для отримання географічного положення користувача.
Оскільки це може поставити під загрозу конфіденційність, позиція недоступна, якщо користувач її не схвалить.
Примітка: Геолокація найточніша для пристроїв із GPS, наприклад смартфонів.
API геолокації підтримується всіма браузерами:
| Yes | Yes | Yes | Yes | Yes |
Примітка: Починаючи з Chrome 50, API геолокації працюватиме лише в безпечних контекстах, таких як HTTPS. Якщо ваш сайт розміщено на незахищеному джерелі (наприклад, HTTP), запити на отримання місцезнаходження користувачів більше не працюватимуть.
Використання API геолокації
Метод getCurrentPosition() використовується для повернення позиції користувача.
Наведений нижче приклад повертає широту та довготу місця розташування користувача:
Приклад
<script>
const x = document.getElementById("demo");
function getLocation() {
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(showPosition);
} else {
x.innerHTML = "Geolocation is not supported by this browser.";
}
}
function showPosition(position) {
x.innerHTML = "Latitude: " + position.coords.latitude +
"<br>Longitude: " + position.coords.longitude;
}
</script>
Спробуйте самі »
Пояснення прикладу:
- Перевірте, чи підтримується геолокація
- Якщо підтримується, запустіть метод getCurrentPosition(). Якщо ні, відобразіть повідомлення для користувача
- Якщо метод getCurrentPosition() виконано успішно, він повертає об’єкт координат функції, указаній у параметрі (showPosition)
- Функція showPosition() виводить широту та довготу
Наведений вище приклад є дуже простим скриптом геолокації без обробки помилок.
Обробка помилок і відхилень
Другий параметр методу getCurrentPosition() використовується для обробки помилок. Він визначає функцію, яку потрібно запустити, якщо їй не вдається отримати місцезнаходження користувача:
Приклад
function showError(error) {
switch(error.code) {
case error.PERMISSION_DENIED:
x.innerHTML = "Користувач відхилив запит на геолокацію."
break;
case error.POSITION_UNAVAILABLE:
x.innerHTML = "Інформація про місцезнаходження недоступна."
break;
case error.TIMEOUT:
x.innerHTML = "Час очікування запиту на отримання місцезнаходження користувача минув."
break;
case error.UNKNOWN_ERROR:
x.innerHTML = "Сталася невідома помилка."
break;
}
}
Спробуйте самі »
Відображення результату на карті
Щоб відобразити результат на карті, вам потрібен доступ до картографічної служби, наприклад Google Maps.
У наведеному нижче прикладі отримані широта та довгота використовуються для відображення розташування на карті Google (з використанням статичного зображення):
Приклад
function showPosition(position) {
let latlon = position.coords.latitude + "," + position.coords.longitude;
let img_url = "https://maps.googleapis.com/maps/api/staticmap?center=
"+latlon+"&zoom=14&size=400x300&sensor=false&key=YOUR_KEY";
document.getElementById("mapholder").innerHTML = "<img src='"+img_url+"'>";
}
Інформація про місцезнаходження
Ця сторінка продемонструвала, як показати положення користувача на карті.
Геолокація також дуже корисна для інформації про місцезнаходження, наприклад:
- Остання місцева інформація
- Показ визначних місць поблизу користувача
- Покрокова навігація (GPS)
Метод getCurrentPosition() — повернення даних
Метод getCurrentPosition() повертає об’єкт у разі успіху. Властивості широти, довготи та точності завжди повертаються. Інші властивості повертаються, якщо вони доступні:
| Властивість | Поверне |
|---|---|
| coords.latitude | Широта як десяткове число (завжди повертається) |
| coords.longitude | Довгота як десяткове число (завжди повертається) |
| coords.accuracy | Точність позиції (завжди повертається) |
| coords.altitude | Висота над середнім рівнем моря в метрах (повертається, якщо є) |
| coords.altitudeAccuracy | Висотна точність положення (повертається, якщо доступно) |
| coords.heading | Напрямок у градусах за годинниковою стрілкою від півночі (повертається, якщо доступно) |
| coords.speed | Швидкість у метрах за секунду (повертається, якщо доступно) |
| timestamp | Дата/час відповіді (повертається, якщо є) |
Об’єкт геолокації – інші цікаві методи
Об’єкт Geolocation також має інші цікаві методи:
watchPosition()- Повертає поточне положення користувача та продовжує повертати оновлене положення, коли користувач рухається (як GPS в автомобілі).clearWatch()- Зупиняє методwatchPosition().
У прикладі нижче показано метод watchPosition(). Щоб перевірити це, вам потрібен точний пристрій GPS (наприклад, смартфон):
Приклад
<script>
const x = document.getElementById("demo");
function getLocation() {
if (navigator.geolocation) {
navigator.geolocation.watchPosition(showPosition);
} else {
x.innerHTML = "Геолокація не підтримується цим браузером.";
}
}
function showPosition(position) {
x.innerHTML = "Широта: " + position.coords.latitude +
"<br>Довгота: " + position.coords.longitude;
}
</script>
Спробуйте самі »
