Ringkasan Geolocation API

Geolocation API adalah layanan yang menerima permintaan HTTPS dengan menara seluler dan titik akses Wi-Fi yang dapat dideteksi oleh klien seluler. Metode 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 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 native.

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. Objek ini menerima permintaan POST HTTPS ke endpoint-nya bersama dengan isi permintaan terstruktur 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 dapat menampilkan data untuk sejumlah kolom data seluler umum seperti yang ditunjukkan di bawah.

Referensi

Tabel berikut merangkum 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 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 Memulai persiapan Mulailah dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan yang mengikuti.
2 Coba 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 cellID dari berbagai menara radio Lihat Menghitung cellID dan Menghitung newRadioCellID untuk mendapatkan akses ke menara lama dan baru.
4 Memahami dasar-dasar respons Pelajari respons data geolokasi untuk mempersiapkan penggunaan 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, dan merupakan open source berdasarkan Lisensi Apache 2.0. Download dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya