BAB 54: Geolocation API
Mendapatkan lokasi geografis pengguna menggunakan Geolocation API.
Di bab sebelumnya kita memeriksa dukungan Geolocation di browser menggunakan "geolocation" in navigator. Hasilnya positif, browser modern memang mendukungnya. Sekarang saatnya benar-benar menggunakan API ini untuk mendapatkan posisi fisik pengguna.
Geolocation API memungkinkan halaman web mengetahui koordinat geografis perangkat: latitude dan longitude, yang didapat dari GPS (di perangkat mobile) atau estimasi berbasis jaringan Wi-Fi dan IP address (di desktop). Ini adalah salah satu Web API yang membutuhkan izin eksplisit dari pengguna sebelum bisa digunakan, seperti yang kita singgung di bab pengenalan.
Mendapatkan Posisi Sekali
Method utama Geolocation API adalah navigator.geolocation.getCurrentPosition(). Method ini menerima dua argumen: fungsi callback yang dipanggil saat lokasi berhasil didapat, dan fungsi callback untuk menangani error.
<!-- lokasi.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Lokasi Saya</title>
</head>
<body>
<h1>Lokasi Geografis</h1>
<p id="hasil">Mencari lokasi...</p>
<script>
var hasil = document.getElementById("hasil");
if ("geolocation" in navigator) {
navigator.geolocation.getCurrentPosition(tampilkanLokasi, tampilkanError);
} else {
hasil.textContent = "Browser tidak mendukung Geolocation.";
}
function tampilkanLokasi(posisi) {
var lat = posisi.coords.latitude;
var lon = posisi.coords.longitude;
var akurasi = posisi.coords.accuracy;
hasil.innerHTML =
"Latitude: " + lat + "<br>" +
"Longitude: " + lon + "<br>" +
"Akurasi: " + akurasi + " meter";
}
function tampilkanError(error) {
switch (error.code) {
case error.PERMISSION_DENIED:
hasil.textContent = "Pengguna menolak permintaan lokasi.";
break;
case error.POSITION_UNAVAILABLE:
hasil.textContent = "Informasi lokasi tidak tersedia.";
break;
case error.TIMEOUT:
hasil.textContent = "Permintaan lokasi melewati batas waktu.";
break;
default:
hasil.textContent = "Terjadi error yang tidak diketahui.";
}
}
</script>
</body>
</html>
Saat halaman ini dibuka, browser akan menampilkan dialog izin. Jika pengguna mengizinkan, fungsi tampilkanLokasi dipanggil dengan objek posisi yang berisi koordinat. Jika ditolak atau terjadi masalah lain, fungsi tampilkanError menangani kasusnya.
Objek posisi.coords menyediakan beberapa properti:
| Properti | Deskripsi | Selalu tersedia |
|---|---|---|
latitude | Garis lintang dalam derajat desimal | Ya |
longitude | Garis bujur dalam derajat desimal | Ya |
accuracy | Akurasi dalam meter | Ya |
altitude | Ketinggian di atas permukaan laut (meter) | Tidak |
altitudeAccuracy | Akurasi ketinggian (meter) | Tidak |
heading | Arah pergerakan dalam derajat | Tidak |
speed | Kecepatan dalam meter per detik | Tidak |
Properti altitude, heading, dan speed bergantung pada sensor perangkat, di laptop tanpa GPS, nilainya biasanya null.
Menampilkan Lokasi di Peta
Koordinat angka saja kurang bermakna bagi pengguna. Cara paling umum menampilkan lokasi adalah menggunakan layanan peta. Kita bisa memanfaatkan peta statis dari OpenStreetMap melalui <iframe>:
<!-- lokasi-peta.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Lokasi di Peta</title>
</head>
<body>
<h1>Posisi Saya di Peta</h1>
<p id="koordinat">Mencari lokasi...</p>
<div id="wadah-peta"></div>
<script>
var koordinat = document.getElementById("koordinat");
var wadahPeta = document.getElementById("wadah-peta");
if ("geolocation" in navigator) {
navigator.geolocation.getCurrentPosition(function(posisi) {
var lat = posisi.coords.latitude;
var lon = posisi.coords.longitude;
koordinat.textContent = "Latitude: " + lat + ", Longitude: " + lon;
var iframe = document.createElement("iframe");
iframe.width = "600";
iframe.height = "400";
iframe.style.border = "none";
iframe.src = "https://www.openstreetmap.org/export/embed.html?bbox=" +
(lon - 0.01) + "," + (lat - 0.01) + "," +
(lon + 0.01) + "," + (lat + 0.01) +
"&layer=mapnik&marker=" + lat + "," + lon;
wadahPeta.appendChild(iframe);
}, function(error) {
koordinat.textContent = "Tidak bisa mendapatkan lokasi: " + error.message;
});
}
</script>
</body>
</html>
Kode ini membuat <iframe> secara dinamis dan mengarahkannya ke OpenStreetMap dengan koordinat yang didapat dari Geolocation API. Parameter bbox menentukan area peta yang ditampilkan (sedikit lebih lebar dari titik lokasi), dan marker menempatkan penanda di posisi pengguna.
Opsi Geolocation
getCurrentPosition() menerima argumen ketiga berupa objek opsi yang mengontrol perilaku permintaan lokasi:
<!-- lokasi-akurat.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Lokasi Akurat</title>
</head>
<body>
<h1>Lokasi dengan Akurasi Tinggi</h1>
<p id="hasil">Meminta lokasi akurat...</p>
<script>
var opsi = {
enableHighAccuracy: true,
timeout: 10000,
maximumAge: 0
};
navigator.geolocation.getCurrentPosition(
function(posisi) {
document.getElementById("hasil").innerHTML =
"Latitude: " + posisi.coords.latitude + "<br>" +
"Longitude: " + posisi.coords.longitude + "<br>" +
"Akurasi: " + posisi.coords.accuracy + " meter";
},
function(error) {
document.getElementById("hasil").textContent = "Error: " + error.message;
},
opsi
);
</script>
</body>
</html>
Tiga opsi yang tersedia:
enableHighAccuracy: Jikatrue, browser akan mencoba menggunakan GPS untuk hasil yang lebih presisi. Ini memakan waktu lebih lama dan menguras baterai lebih cepat di perangkat mobile. Default:false.timeout: Batas waktu maksimal (dalam milidetik) yang diberikan browser untuk mendapatkan lokasi. Jika terlewati, errorTIMEOUTdipicu. Default: tanpa batas.maximumAge: Berapa lama (dalam milidetik) posisi yang di-cache boleh digunakan. Nilai0berarti selalu minta posisi baru. Default:0.
enableHighAccuracy: true di desktop biasanya tidak mengubah hasil secara signifikan karena kebanyakan laptop tidak punya chip GPS. Efeknya paling terasa di smartphone yang memiliki GPS hardware.
Melacak Posisi Secara Terus-Menerus
Selain getCurrentPosition() yang hanya meminta lokasi sekali, ada watchPosition() yang memantau perubahan posisi secara terus-menerus. Setiap kali posisi berubah, callback dipanggil kembali:
<!-- lacak-posisi.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Lacak Posisi</title>
</head>
<body>
<h1>Pelacakan Posisi Real-Time</h1>
<p id="status">Menunggu perubahan posisi...</p>
<p id="jumlah-update">Update: 0</p>
<button id="tombol-berhenti">Berhenti Melacak</button>
<script>
var status = document.getElementById("status");
var jumlahUpdate = document.getElementById("jumlah-update");
var hitungan = 0;
var idPelacakan = navigator.geolocation.watchPosition(
function(posisi) {
hitungan++;
status.innerHTML =
"Latitude: " + posisi.coords.latitude + "<br>" +
"Longitude: " + posisi.coords.longitude + "<br>" +
"Akurasi: " + posisi.coords.accuracy + " meter";
jumlahUpdate.textContent = "Update: " + hitungan;
},
function(error) {
status.textContent = "Error: " + error.message;
},
{ enableHighAccuracy: true }
);
document.getElementById("tombol-berhenti").addEventListener("click", function() {
navigator.geolocation.clearWatch(idPelacakan);
status.textContent = "Pelacakan dihentikan.";
});
</script>
</body>
</html>
watchPosition() mengembalikan sebuah ID numerik. ID ini disimpan di variabel idPelacakan dan digunakan untuk menghentikan pelacakan lewat clearWatch(). Tanpa clearWatch(), browser terus memantau posisi dan mengonsumsi sumber daya, terutama baterai di perangkat mobile.
Pola ini cocok untuk aplikasi navigasi atau pelacakan aktivitas fisik di mana posisi pengguna terus berubah.
Menghitung Jarak Dua Titik
Dengan dua koordinat, kita bisa menghitung jarak antara keduanya menggunakan rumus Haversine, rumus matematika untuk menghitung jarak pada permukaan bola:
<!-- jarak.html -->
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Hitung Jarak</title>
</head>
<body>
<h1>Jarak ke Monas</h1>
<p id="hasil">Menghitung...</p>
<script>
// Koordinat Monas, Jakarta
var latMonas = -6.1754;
var lonMonas = 106.8272;
function hitungJarak(lat1, lon1, lat2, lon2) {
var R = 6371; // radius bumi dalam kilometer
var dLat = (lat2 - lat1) * Math.PI / 180;
var dLon = (lon2 - lon1) * Math.PI / 180;
var a =
Math.sin(dLat / 2) * Math.sin(dLat / 2) +
Math.cos(lat1 * Math.PI / 180) * Math.cos(lat2 * Math.PI / 180) *
Math.sin(dLon / 2) * Math.sin(dLon / 2);
var c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
return R * c;
}
navigator.geolocation.getCurrentPosition(
function(posisi) {
var lat = posisi.coords.latitude;
var lon = posisi.coords.longitude;
var jarak = hitungJarak(lat, lon, latMonas, lonMonas);
document.getElementById("hasil").innerHTML =
"Posisi kamu: " + lat.toFixed(4) + ", " + lon.toFixed(4) + "<br>" +
"Posisi Monas: " + latMonas + ", " + lonMonas + "<br>" +
"Jarak: " + jarak.toFixed(2) + " km";
},
function(error) {
document.getElementById("hasil").textContent = "Tidak bisa mendapatkan lokasi.";
}
);
</script>
</body>
</html>
Fungsi hitungJarak mengimplementasikan rumus Haversine yang memperhitungkan kelengkungan bumi. Hasilnya dalam kilometer. Untuk jarak pendek (dalam satu kota), hasilnya cukup akurat. Untuk navigasi presisi tinggi, biasanya digunakan library khusus, tapi untuk kebutuhan dasar, rumus ini sudah memadai.
Latihan
-
Modifikasi
lokasi.htmlagar menampilkan waktu saat lokasi didapat menggunakanposisi.timestamp. Konversi timestamp ke format yang bisa dibaca dengannew Date(posisi.timestamp).toLocaleString("id-ID"). -
Buat halaman yang menampilkan jarak dari posisi pengguna ke tiga landmark berbeda (misalnya Monas, Candi Borobudur, dan Tugu Yogyakarta). Tampilkan hasilnya dalam tabel HTML yang dibangun secara dinamis lewat JavaScript.
-
Gunakan
watchPosition()untuk membuat halaman yang mencatat setiap perubahan posisi ke dalam daftar<ul>. Setiap item berisi latitude, longitude, dan waktu update. Tambahkan tombol untuk menghentikan pelacakan.
Geolocation memberi halaman web kemampuan mengetahui di mana pengguna berada. Tapi bagaimana kalau kita ingin memberi pengguna kemampuan berinteraksi secara fisik dengan elemen di layar, menyeret dan menjatuhkan sesuatu? Di bab berikutnya, kita akan mempelajari Drag and Drop API yang memungkinkan interaksi sentuh-dan-geser langsung di halaman HTML.