Menemukan Tempat yang Tepat dengan Google Places API
Dalam seri tutorial ini, saya akan menunjukkan cara menggunakan Google Places API untuk pelengkapan otomatis alamat, pencarian tempat terdekat, pencarian teks dan mengambil detail tempat. Saya akan menjelaskan fungsi masing-masing API, membahas skema harga, dan di akhir setiap tulisan blog akan ada contoh praktis agar anda bisa langsung mengimplementasikan Places API di aplikasi web anda.
Bagian 1: Menemukan Tempat yang Tepat dengan Google Places API (artikel ini)
Bagian 2: Pelengkapan Alamat Otomatis Google dengan Places API
Bagian 3: Google Place Details dan Place Photos API (Detail Tempat dan Foto Tempat)
Bagian 4: Google Nearby Search API (Pencarian Tempat Terdekat)
Bagian 5: Google Places Text Search (Pencarian Teks Tempat)
Apa itu Google Places API?
Google Places API adalah kumpulan API yang mengubah Google Maps menjadi mesin pencari yang sangat kuat. Walaupun banyak orang menganggap Google Maps hanya sebagai alat pemetaan, pada kenyataannya ia berfungsi seperti buku alamat modern. Setiap "tempat" di dalam buku alamat ini merupakan entri yang berisi detail seperti nama, jenis, alamat, koordinat geografis, dan pengenal unik yang dikenal sebagai place_id. Beberapa tempat juga dapat menampilkan foto serta ulasan yang dikirimkan oleh pengguna. Karena Google Maps sangat populer, para pengguna pun terdorong untuk memberikan ulasan jujur, baik untuk memuji layanan yang baik maupun menyoroti pengalaman yang kurang menyenangkan.
Google Places API memungkinkan Anda mencari entri di buku alamat tersebut dan langsung memanfaatkan informasi ini di aplikasi Anda.
Kategori Google Places API
Berikut adalah lima API yang paling sering digunakan dalam keluarga Google Places API:
Place Autocomplete memberikan saran lokasi berdasarkan input pengguna saat mereka mengetik di kolom pencarian. Fitur ini sering digunakan pada kolom alamat dalam aplikasi, sehingga pengguna dapat dengan cepat memilih dari hasil yang disarankan tanpa harus mengetik alamat secara lengkap.
Place Details dan Place Photos memberikan Anda akses ke beragam data tentang suatu lokasi, mulai dari informasi dasar seperti nama dan alamat hingga konten buatan pengguna yang kaya seperti ulasan dan foto. Fitur ini sangat berguna ketika Anda ingin memberikan detail lengkap kepada pengguna mengenai suatu tempat, tidak hanya sekadar nama dan lokasinya.
Nearby Search memungkinkan pencarian tempat dalam area tertentu dan dapat disaring dengan kata kunci atau jenis tempat, cocok untuk aplikasi penemuan lokasi di sekitar pengguna.
Text Search adalah fitur pengganti kotak pencarian Google Maps yang memungkinkan pencarian tempat dengan teks bebas, seperti nama, alamat, atau jenis lokasi. Berbeda dari Nearby Search, Text Search memakai AI untuk memahami permintaan pengguna.
Kunci Google Places API
Untuk mulai menggunakan Google Places API, langkah pertama yang perlu Anda lakukan adalah melakukan pengaturan di Google Cloud console. Pertama, buatlah proyek baru melalui dashboard konsol di https://console.cloud.google.com/ kemudian beri nama places-api-demo. Klik [CREATE].
Untuk mengaktifkan Google Places API, buka halaman API & Layanan dengan memilihnya di menu sebelah kiri. Setelah di sana, pilih [+ Aktifkan API dan Layanan] dan cari "Places API". Dua opsi akan muncul - "Places API" dan "Places API (Baru)". Kita akan membutuhkan keduanya.
Klik setiap opsi dan aktifkan API dengan memilih [ENABLE] (AKTIFKAN).
Selanjutnya, saat masih berada di proyek places-api-demo, gunakan bilah navigasi sebelah kiri untuk menuju ke halaman Kredensial. Klik tombol [+ Create Credentials] (Buat Kredensial) dan pilih opsi [API Key] (Kunci API). Di halaman berikutnya, gunakan menu tarik-turun untuk memastikan bahwa Places API dan Places API (Baru) keduanya diaktifkan.
Untuk keamanan tambahan, penting untuk mengatur pembatasan situs web untuk kunci API Google Maps anda guna mencegah akses tidak sah. Anda dapat melakukan ini dengan mengklik tombol [Add] (Tambah) di bawah bagian Pembatasan API. Karena kunci API Google sering digunakan di frontend, kunci tersebut dapat terekspos dengan memeriksa kode sumber di browser. Untuk melindunginya, anda dapat membatasi kunci ke domain tertentu. Dalam contoh di atas, saya telah menambahkan *.afi.dev/* sebagai pembatasan, memastikan bahwa kunci hanya dapat digunakan oleh situs web di bawah domain afi.dev.
Klik [Save] (Simpan) dan kunci API Google anda siap digunakan. Untuk menggunakannya, klik tombol [Show Key] (Tampilkan Kunci) di halaman Kredensial.
Harga Google Places API
Google Places API menggunakan model harga bayar sesuai penggunaan, serupa dengan layanan Google Maps Platform lainnya. Berikut tampilan lembar harga (dalam CPM, atau biaya per seribu permintaan) untuk Places API:
| 0 - 100k | 100k - 500k | 500k - 1M | 1M - 5M | 5M - 10M | 10M - 20M | 20M + | |
|---|---|---|---|---|---|---|---|
| Autocomplete / Request |
$2.83 | $2.27 | $1.70 | $0.85 | $0.25 | $0.17 | $0.17 |
| Autocomplete / Session |
$17.00 | $13.60 | $10.20 | $5.10 | $1.28 | $1.00 | $1.00 |
| Place Details | $17.00 | $13.60 | $10.20 | $5.10 | $1.28 | $1.00 | $1.00 |
| Place Photo | $7.00 | $5.60 | $4.20 | $2.10 | $0.53 | $0.16 | $0.06 |
| Nearby Search | $32.00 | $25.60 | $19.20 | $9.60 | $2.40 | $1.90 | $1.90 |
| Text Search | $32.00 | $25.60 | $19.20 | $9.60 | $2.40 | $1.90 | $1.90 |
* CPM: biaya per seribu permintaan
Dua tingkatan pertama (0 - 100 ribu dan 100 ribu - 500 ribu) tersedia untuk umum. Anda hanya perlu membuat akun penagihan GCP dengan kartu kredit anda dan setiap bulan Anda akan ditagih secara otomatis berdasarkan volume. Tingkatan yang lebih tinggi (500 ribu ke atas) hanya tersedia jika anda bekerja dengan Mitra Google Maps.
Contoh Kasus Penggunaan Umum untuk Google Places API
Google Places API banyak digunakan di berbagai industri. Perusahaan berbagi tumpangan memanfaatkan Place Autocomplete untuk membantu pelanggan memasukkan lokasi penjemputan dan pengantaran dengan akurat. Sementara itu, perusahaan real estat sering menggunakan Nearby Search untuk menampilkan fasilitas yang berada dalam jarak berjalan kaki dari daftar properti tertentu, sehingga meningkatkan pengalaman pengguna.
API ini juga populer di industri pariwisata, yang menggunakan Place Details dan Place Photo API untuk menambahkan informasi kontak, jam buka, ulasan pengguna, foto, dan peringkat ke tempat wisata, hotel, dan restoran. Hal ini memungkinkan wisatawan untuk membuat keputusan yang tepat tentang tempat yang akan dikunjungi, tempat menginap, atau tempat makan selama perjalanan mereka.
Salah satu cara baru dan semakin umum yang digunakan industri pariwisata untuk Google Places API adalah dengan menggabungkannya dengan Large Language Model, atau LLM. Misalnya, Anda dapat memberikan perintah berikut kepada ChatGPT-4o:
"Saya tertarik dengan museum, landmark budaya, lingkungan yang bagus, dan restoran Prancis. Rencanakan itinerary tiga hari di Prancis untuk saya, dimulai dari hotel saya, Le Meurice, yang mempertimbangkan preferensi saya. Berikan jawaban Anda dalam format JSON dan untuk setiap tempat, sertakan place_id Google Maps dalam respons anda."
Dan itu akan menghasilkan itinerary yang mencakup place_id untuk setiap lokasi yang disarankan oleh mesin pencari.
Respons dari LLM dan place_id yang disertakan kemudian dapat digunakan oleh aplikasi perencanaan perjalanan untuk memberikan rekomendasi yang dipersonalisasi, bersama dengan ulasan, foto, dan peringkat untuk objek wisata dan landmark utama.
Apa yang akan Anda pelajari dalam rangkaian tutorial ini
Pada akhir tutorial ini, anda akan menjadi ahli dalam Google Places API. Secara khusus, anda akan:
- Mendapatkan pengalaman langsung dalam menyiapkan Place Autocomplete untuk saran alamat dan lokasi.
- Memahami cara menggunakan Place Details dan Place Photos untuk mengambil informasi tentang tempat, termasuk alamat, nomor telepon, jam buka, peringkat pengguna, dan foto.
- Mempelajari bagaimana Nearby Search dapat membantu menemukan tempat-tempat terdekat seperti restoran, hotel, dan tempat wisata berdasarkan lokasi pengguna.
- Menggunakan Text Search untuk mencari tempat berdasarkan nama, alamat, atau jenis menggunakan input teks bebas.
👋 Seperti biasa, jika anda memiliki pertanyaan atau saran untuk saya, silakan hubungi saya atau sapa saya di LinkedIn.
Selanjutnya: Bagian 2: Pelengkapan otomatis alamat Google dengan API Places