![Ringkasan Geolocation API](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=4&hl=id)
Geolocation API adalah layanan yang menerima permintaan HTTPS dengan menara BTS dan titik akses WiFi yang dapat dideteksi oleh klien seluler. Metode ini menghasilkan koordinat lintang/bujur dan radius yang menunjukkan akurasi hasil untuk setiap input yang valid.
Alasan menggunakan Geolocation API
Menggunakan Geolocation API untuk menemukan perangkat seluler yang tidak menyediakan geolokasi native baru.
Yang dapat Anda lakukan dengan Geolocation API
Dengan Geolocation API, Anda dapat menggunakan data geospasial dari menara BTS dan node WiFi untuk mendapatkan lokasi perangkat yang tidak memiliki geolokasi atau GPS asli.
Cara kerja Geolocation API
Geolocation API menggunakan kolom data perangkat seluler, menara BTS data, dan data array titik akses WiFi untuk menampilkan koordinat lintang/bujur dan akurasi radius. Load balancer ini menerima permintaan POST HTTPS ke endpoint-nya beserta permintaan terstruktur JSON {i>body <i}itu. Contoh berikut menampilkan 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.
Resource
Tabel berikut meringkas kolom dalam isi permintaan endpoint geolokasi beserta jenis data yang disediakan kueri tersebut.
Resource data | Data yang dikembalikan | 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 (AP) Wi-Fi, seperti alamat MAC dan kekuatan sinyal. |
Cara menggunakan Geolocation API
1 | Melakukan penyiapan | Diawali 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 tukang pos. Lihat Contoh permintaan di panduan Permintaan dan respons geolokasi untuk mengetahui detailnya. |
3 | Mendapatkan cellID dari menara radio lain | Lihat Menghitung cellID dan Menghitung newRadioCellID untuk mendapatkan akses ke menara lama dan baru masing-masing. |
4 | Memahami dasar-dasar respons | Jelajahi 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:
- Java Klien untuk Layanan Google Maps
- Python Klien untuk Layanan Google Maps
- Klien Go untuk Layanan Google Maps
- Node.js Klien untuk Layanan Google Maps
Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Google Maps Layanan adalah library klien yang didukung komunitas, yang bersifat open source di bawah Lisensi Apache 2.0. Download semuanya dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.
Langkah berikutnya
- Memulai dengan contoh permintaan dan respons: Buka Permintaan dan respons geolokasi
- Mengikuti praktik terbaik: Buka Praktik Terbaik Layanan Web.
- Memahami penagihan: Buka Penggunaan dan Penagihan.