
Geolocation API adalah layanan yang menerima permintaan HTTPS dengan menara BTS dan titik akses Wi-Fi yang dapat dideteksi oleh klien seluler. API ini menampilkan koordinat lintang/bujur dan radius yang menunjukkan akurasi hasil untuk setiap input yang valid.
Alasan menggunakan Geolocation API
Gunakan Geolocation API untuk menemukan lokasi perangkat seluler yang tidak menyediakan fitur geolokasi native.
Yang dapat Anda lakukan dengan Geolocation API
Dengan Geolocation API, Anda dapat menggunakan data geospasial dari menara BTS dan node Wi-Fi untuk mendapatkan lokasi perangkat yang tidak memiliki geolokasi atau GPS bawaan.
Cara kerja Geolocation API
Geolocation API menggunakan kolom data perangkat seluler, data menara BTS, dan data array titik akses Wi-Fi untuk menampilkan koordinat lintang/bujur dan radius akurasi. Fungsi ini menerima permintaan POST HTTPS ke endpointnya bersama dengan isi permintaan berstruktur JSON. Contoh berikut menunjukkan URL permintaan dan contoh isi permintaan:
curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d \ '{ "homeMobileCountryCode":310, "homeMobileNetworkCode":410, "radioType":"gsm", "carrier":"Vodafone", "considerIp":true }'
Resource
Tabel berikut merangkum kolom dalam isi permintaan panggilan endpoint geolokasi, beserta jenis data yang diberikan dari kueri tersebut.
Resource data | Data yang ditampilkan | Format pengembalian |
---|---|---|
Kolom data perangkat seluler seperti informasi operator, perangkat, dan jaringan. | Koordinat lintang/bujur dan radius akurasi | JSON |
Data menara BTS, seperti kode area lokasi dan kode negara seluler. | ||
Data titik akses Wi-Fi, seperti alamat MAC dan kekuatan sinyal. |
Cara menggunakan Geolocation API
1 | Mulai penyiapan | Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan berikutnya. |
2 | Mencoba permintaan geolokasi | Setelah memiliki kunci API, Anda dapat mulai menguji Geolocation API menggunakan cURL atau Postman. Lihat Contoh permintaan dalam panduan Permintaan dan respons geolokasi untuk mengetahui detailnya. |
3 | Mendapatkan cellID dari menara pemancar radio yang berbeda | Lihat Menghitung cellID dan Menghitung newRadioCellID untuk mendapatkan akses ke menara BTS yang lebih lama dan lebih baru. |
4 | Memahami dasar-dasar respons | Jelajahi respons data geolokasi untuk bersiap menggunakan data elevasi untuk aplikasi Anda. Lihat Respons geolokasi untuk mengetahui detailnya. |
Library klien yang tersedia
Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:
- Klien Java untuk Layanan Google Maps
- Klien Python untuk Layanan Google Maps
- Klien Go untuk Layanan Google Maps
- Klien Node.js untuk Layanan Google Maps
Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien yang didukung komunitas, yang bersifat open source berdasarkan Lisensi Apache 2.0. Download library klien tersebut dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.
Langkah berikutnya
- Mulai menggunakan contoh permintaan dan respons: Buka Permintaan dan respons geolokasi
- Ikuti praktik terbaik: Buka Praktik Terbaik Layanan Web.
- Memahami penagihan: Buka Penggunaan dan Penagihan.