
Geolocation API adalah layanan yang menerima permintaan HTTPS dengan menara BTS dan titik akses WiFi yang dapat dideteksi klien seluler. Metode ini menampilkan koordinat lintang/bujur dan radius yang menunjukkan akurasi hasil untuk setiap input yang valid.
Mengapa menggunakan Geolocation API
Gunakan Geolocation API untuk menemukan perangkat seluler yang tidak menyediakan fitur geolokasi asli.
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 native.
Cara kerja Geolocation API
Geolocation API menggunakan kolom data perangkat seluler, data menara BTS, dan data array titik akses WiFi untuk mengembalikan koordinat lintang/bujur dan radius akurasi. Metode ini menerima permintaan HTTPS POST ke endpoint beserta isi permintaan terstruktur JSON. Contoh berikut menunjukkan URL permintaan dan contoh isi permintaan:
https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY { "homeMobileCountryCode": 310, "homeMobileNetworkCode": 410, "radioType": "gsm", "carrier": "Vodafone", "considerIp": true, "cellTowers": [ // See the Cell Tower Objects section below. ], "wifiAccessPoints": [ // See the WiFi Access Point Objects section below. ] }API dapat menampilkan data untuk sejumlah kolom data seluler umum seperti yang ditunjukkan di bawah ini.
Resource
Tabel berikut meringkas kolom dalam isi permintaan panggilan endpoint geolokasi, beserta jenis data yang disediakan dari kueri tersebut.
Resource data | Data yang ditampilkan | Format pengembalian |
---|---|---|
Kolom data perangkat seluler seperti informasi operator, perangkat, dan jaringan. | Koordinat garis lintang/bujur dan radius akurasi | JSON |
Data menara BTS, seperti kode area lokasi dan kode negara seluler. | ||
Data titik akses Wi-Fi, seperti kekuatan sinyal dan alamat MAC. |
Cara menggunakan Geolocation API
1 | Memulai penyiapan | Mulai dengan Menyiapkan project Google Cloud dan menyelesaikan petunjuk penyiapan yang mengikuti. |
2 | Mencoba permintaan geolokasi | Setelah memiliki kunci API, Anda dapat mulai menguji Geolocation API menggunakan cURL atau Postman. Lihat Contoh permintaan di panduan Permintaan dan respons geolokasi untuk mengetahui detailnya. |
3 | Mendapatkan ID seluler dari menara radio lain | Baca Menghitung cellID dan Menghitung newRadioCellID untuk mendapatkan akses ke menara lama dan yang lebih baru. |
4 | Memahami dasar-dasar respons | Pelajari respons data geolokasi untuk mempersiapkan penggunaan data elevasi bagi 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 open source yang didukung komunitas berdasarkan Lisensi Apache 2.0. Download aplikasi dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.
Langkah berikutnya
- Memulai contoh permintaan dan respons: Buka Permintaan dan respons geolokasi
- Ikuti praktik terbaik: Buka Praktik Terbaik Layanan Web.
- Memahami penagihan: Buka Penggunaan dan Penagihan.