Web API

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.

HTMLHTML
<!-- 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:

PropertiDeskripsiSelalu tersedia
latitudeGaris lintang dalam derajat desimalYa
longitudeGaris bujur dalam derajat desimalYa
accuracyAkurasi dalam meterYa
altitudeKetinggian di atas permukaan laut (meter)Tidak
altitudeAccuracyAkurasi ketinggian (meter)Tidak
headingArah pergerakan dalam derajatTidak
speedKecepatan dalam meter per detikTidak

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>:

HTMLHTML
<!-- 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:

HTMLHTML
<!-- 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: Jika true, 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, error TIMEOUT dipicu. Default: tanpa batas.
  • maximumAge: Berapa lama (dalam milidetik) posisi yang di-cache boleh digunakan. Nilai 0 berarti 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:

HTMLHTML
<!-- 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:

HTMLHTML
<!-- 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

  1. Modifikasi lokasi.html agar menampilkan waktu saat lokasi didapat menggunakan posisi.timestamp. Konversi timestamp ke format yang bisa dibaca dengan new Date(posisi.timestamp).toLocaleString("id-ID").

  2. 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.

  3. 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.

Referensi

  1. 1 MDN Web Docs: Geolocation API
  2. 2 MDN Web Docs: Geolocation.getCurrentPosition()
  3. 3 MDN Web Docs: Geolocation.watchPosition()