Ringkasan Geolocation API

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
}'
 API ini dapat menampilkan data untuk sejumlah kolom data seluler umum seperti yang ditunjukkan di bawah.

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