Panduan praktis untuk Google Geocoding API
Dalam rangkaian tutorial ini, kita akan mempelajari secara mendalam API terpopuler kedua Google Maps*, yaitu API Google Geocoding. Saya akan menjelaskan kegunaannya, membahas beberapa contoh praktis, dan mengakhiri setiap postingan blog dengan demo dan kode sumber yang dapat anda gunakan dalam proyek Anda sendiri. Kita juga akan melihat dua API terkait: API Address Validation, yang membantu mengidentifikasi dan memperbaiki alamat yang salah, dan Building Outlines and Entrances, yang memungkinkan Anda menampilkan denah dan pintu masuk bangunan pada peta.
Bagian 1: Panduan praktis untuk Google Geocoding API (artikel ini)
Bagian 2: Geocoding maju dengan API Google Geocoding
Bagian 3: Geocoding terbalik Google Maps: Mendapatkan alamat dari koordinat
Bagian 4: Memperbaiki alamat yang salah dengan API Google Address Validation
Bagian 5: API Google Maps Building Outlines and Entrances
* API Google Maps #1 tentu saja adalah API Maps Javascript, yang digunakan untuk menampilkan ubin peta di web.
Apa itu API Google Geocoding?
API Google Geocoding adalah layanan web yang mengubah alamat - seperti "555 West Hastings Street, Vancouver BC, Kanada", menjadi koordinat geografis seperti (49.2846966, -123.11258). API ini juga mendukung proses sebaliknya, mengubah koordinat lintang dan bujur menjadi alamat atau nama tempat yang mudah dibaca manusia dari basis data Google Maps.
Anda dapat mencobanya sendiri di Google Maps (https://www.google.com/maps) dengan memasukkan alamat di bilah pencarian dan mencatat garis lintang dan garis bujur yang muncul di URL. Proses ini disebut geocoding maju (atau geocoding singkatnya).
Geocoding terbalik melakukan hal sebaliknya - mengubah lokasi geografis menjadi alamat yang mudah dibaca manusia. Untuk mencobanya di Google Maps, klik dan tahan di mana saja di peta hingga muncul penanda kecil. Alamat kemudian akan muncul di jendela pop-up di bagian bawah layar.
Dari kedua metode tersebut, geocoding maju (koordinat alamat 👉) umumnya lebih populer karena seringkali merupakan langkah pertama dalam mengubah alamat dunia nyata menjadi data yang dapat digunakan untuk navigasi, perencanaan, dan analitik.
Untuk apa geocoding digunakan?
Geocoding sangat penting ketika Anda perlu menampilkan alamat di peta atau memberikan data lokasi ke API. Banyak API, seperti API Google Weather atau API Google Maps Route Optimization (GMPRO), memerlukan koordinat GPS sebagai input. Misalnya, alat manajemen pengiriman dapat menggunakan geocoding maju untuk mengubah alamat pelanggan menjadi koordinat yang tepat sebelum mengirimkannya ke GMPRO untuk menghasilkan rute pengiriman yang dioptimalkan.
Di sisi lain, geocoding alamat terbalik digunakan untuk mengubah koordinat GPS menjadi nama lokasi yang mudah dibaca untuk berbagai aplikasi seperti layanan berbasis lokasi (misalnya, aplikasi cuaca yang menampilkan area anda saat ini), pelacakan aset (misalnya, aplikasi FindMy milik Apple yang menunjukkan di mana anda meninggalkan AirTags anda), dan geotagging (misalnya, platform media sosial yang menandai foto dengan lokasi tertentu untuk memudahkan penemuan dan konteks).
Apa perbedaan antara API Google Geocoding dan Autocomplete?
Baik API Google Geocoding maupun Places Autocomplete mengembalikan garis lintang dan garis bujur untuk alamat tertentu. Namun, keduanya memiliki tujuan yang berbeda: API Geocoding ideal untuk memproses string teks alamat yang tersimpan dalam file atau basis data, sedangkan Autocomplete dirancang untuk input pengguna - membantu pengguna memilih alamat atau nama tempat yang benar dari daftar yang dapat dicari. Misalnya, sistem manajemen pengiriman dapat menggunakan API Geocoding untuk memproses sejumlah alamat yang diunggah, sedangkan situs e-commerce akan menggunakan Autocomplete untuk memandu pelanggan dalam memasukkan alamat pengiriman mereka selama proses pembayaran.
Cara mendapatkan kunci API Geocoding Google
Untuk mulai menggunakan API Geocoding, anda perlu mengaturnya terlebih dahulu di Google Cloud Console. Buat proyek baru di https://console.cloud.google.com/ dan beri nama proyek geocoding-api-demo. Klik [CREATE].
Untuk mengaktifkan API Geocoding, navigasikan ke halaman API & Layanan dengan memilihnya dari menu di sebelah kiri. Kemudian, klik [+ Aktifkan API dan Layanan] dan cari "API Geocoding".
Klik tautan [API Geocoding] dan tekan tombol [Enable].
Klik [Save]. Jika anda kembali ke halaman Kunci dan Kredensial, anda dapat menemukan kunci API baru anda dengan mengklik tautan [Show Key] di sebelah kanan.
Contoh Google Geocoding API
API Geocoding cukup mudah digunakan. Setelah anda memiliki kunci API, ganti {GOOGLE_MAPS_API_KEY} dengan kunci tersebut pada contoh di bawah ini, salin URL lengkapnya, dan tempelkan ke bilah alamat browser anda. Tekan [Enter], dan respons akan langsung muncul di browser anda.
Meneruskan permintaan geocoding
Method: GET
https://maps.googleapis.com/maps/api/geocode/json?address=555+west+hastings+street+vancouver&key={GOOGLE_MAPS_API_KEY}Respons
Permintaan geocoding terbalik
Method: GET
https://maps.googleapis.com/maps/api/geocode/json?latlng=49.2846966,-123.1119349&key={GOOGLE_MAPS_API_KEY}Respons
Apakah Google Geocoding API gratis?
Tidak, API Geocoding tidak sepenuhnya gratis. Harga mulai dari $5 per 1.000 alamat yang di-geocoding (CPM). Namun, Google menawarkan paket gratis yang cukup besar yang mencakup 10.000 alamat yang di-geocoding per bulan, cukup untuk mendukung sebagian besar operasi pengiriman berukuran menengah tanpa menimbulkan biaya apa pun.
Harga API Google Geocoding
Seperti API Google Maps Platform lainnya, API Geocoding menggunakan model harga bayar sesuai penggunaan. Pelanggan ditagih berdasarkan jumlah alamat yang dikirim ke API. 10.000 alamat pertama setiap bulan gratis, dan setelah itu, biaya per 1.000 alamat (CPM) bergantung pada total volume bulanan.
| 0 - 10k | 10k - 100k | 100k - 500k | 500k - 1M | 1M - 5M | 5M+ | |
|---|---|---|---|---|---|---|
| Geocoding API | FREE | $5.00 | $4.00 | $3.00 | $1.50 | $0.38 |
Jika anda menangani volume penggunaan yang tinggi, anda dapat bekerja sama dengan mitra Google Maps untuk mendapatkan diskon volume. Lihat halaman harga resmi untuk detailnya.
Bisakah saya menyimpan data geocoding Google Maps dalam cache?
Secara resmi, tidak. Persyaratan Layanan Google Maps dengan jelas menyatakan:
5.3 Penyimpanan Sementara (Caching). Pelanggan dapat menyimpan sementara nilai lintang (lat) dan bujur (lng) dari API Geocoding hingga 30 hari kalender berturut-turut, setelah itu Pelanggan harus menghapus nilai lintang dan bujur yang disimpan sementara tersebut.
Namun dalam praktiknya, semua orang tetap melakukannya dan tidak ada cara bagi Google untuk menegakkan aturan ini. Cara populer untuk mengurangi biaya geocoding adalah dengan terlebih dahulu memeriksa apakah alamat tersebut telah "dilihat". Jika sudah, gunakan kembali lintang dan bujur yang tersimpan. Jika itu alamat baru, lakukan geocoding sekali dan simpan alamat serta koordinatnya ke dalam basis data untuk penggunaan di masa mendatang.
Alternatif API Geocoding Google
Jika anda mempertimbangkan alternatif untuk API Geocoding Google Maps, beberapa layanan pesaing seperti Mapbox, HERE Maps, atau Tom Tom menawarkan pilihan yang solid dengan biaya lebih rendah. Misalnya, paket berbayar Mapbox dimulai hanya dengan $0,75 per 1.000 permintaan (CPM) dan termasuk 100.000 geocoding gratis per bulan. Namun, Google tetap menjadi pilihan utama bagi banyak orang karena akurasi dan kebaruan data alamatnya yang superior. Bagi bisnis logistik pengiriman tahap akhir yang beroperasi dengan margin keuntungan yang tipis, biaya pengiriman yang gagal karena alamat yang salah dapat jauh melebihi biaya $0,005 untuk mendapatkan geocoding yang akurat dari Google.
Apa yang akan Anda pelajari dalam rangkaian tutorial ini
API Geocoding Google adalah andalan Platform Google Maps. Pada akhir tutorial ini, anda akan dapat:
1. Mengonversi alamat apa pun menjadi garis lintang dan garis bujur,
- Melakukan geocode terbalik koordinat GPS menjadi alamat dan nama tempat yang mudah dibaca manusia,
- Menggunakan API Validasi Alamat Google untuk memeriksa apakah suatu alamat dapat dikirimkan, dan,
- Menampilkan garis luar bangunan dan menandai pintu masuk pada peta
👋 Seperti biasa, jika Anda memiliki pertanyaan atau saran untuk saya, silakan hubungi saya atau sapa saya di LinkedIn.
Selanjutnya: Bagian 2: Geocoding maju dengan API Geocoding Google