Mengapa menggunakan Places API
Buat fitur deteksi lokasi agar data lokasi yang mendetail dapat diakses dengan mudah oleh pengguna. Data yang tersedia melalui Places API dibuat berdasarkan salah satu model tempat dunia nyata yang paling akurat, terbaru, dan komprehensif. Berikut contoh kasus penggunaan untuk aplikasi:
- Tampilkan penyewaan kondominium di area metropolitan utama dengan hasil yang ditargetkan khusus untuk kota.
- Sertakan detail tempat dalam pembaruan status pengambilan atau pengiriman.
- Menampilkan daftar taman di suatu area beserta foto dan ulasan yang dikirimkan pengguna.
- Berikan informasi kontak, ulasan, dan tingkat harga untuk tempat usaha kepada orang-orang yang merencanakan perjalanan.
Apa yang dapat Anda lakukan dengan Places API
Anda dapat menggunakan Places API untuk menyertakan fitur-fitur berikut dalam aplikasi Anda:
- Berikan hasil penelusuran tempat dari berbagai jenis kueri pengguna, seperti input teks, lokasi terdekat, dan kueri pengguna yang ambigu atau kategoris.
- Aktifkan fitur pelengkapan otomatis untuk berbagai jenis penelusuran, baik kueri teks spesifik maupun kueri kategoris.
- Saring jenis detail yang ditampilkan tentang sebuah tempat, seperti jam buka, ringkasan, ulasan pengguna, dan foto.
- Tambahkan foto berkualitas tinggi ke lokasi yang dilayani oleh aplikasi Anda.
Cara kerja Places API
Places API menerima permintaan sebagai URL standar dengan endpoint
layanan tertentu, seperti /place
atau /photo
. Endpoint juga
menerima jenis format yang ditentukan dalam permintaan, baik JSON maupun XML. Terakhir, permintaan
layanan menggunakan parameter yang relevan dengan endpoint spesifik tersebut untuk menyaring data yang ditampilkan.
Misalnya, permintaan Place Details berikut untuk komponen alamat berfungsi sebagai berikut,
dengan asumsi ditampilkan dalam format JSON:
https://maps.googleapis.com/maps/api/place/details/json ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
Dalam hal ini, layanan menggunakan ID tempat yang disediakan untuk menemukan tempat yang diminta dan menampilkan komponen alamat dalam format JSON.
Resource
Tabel berikut merangkum resource yang tersedia melalui Places API beserta data yang ditampilkannya.
Resource data | Data yang ditampilkan | Format pengembalian |
---|---|---|
Place Search | Menampilkan daftar tempat berdasarkan lokasi perangkat atau string penelusuran.
Lihat detail untuk Menempatkan respons penelusuran, Respons penelusuran di sekitar, dan Respons penelusuran teks. |
|
Detail tempat | Menampilkan informasi mendetail tentang tempat tertentu, termasuk ulasan pengguna.
Lihat detail dalam Respons Place Details. |
|
Foto tempat | Menyediakan akses ke jutaan foto terkait tempat yang disimpan dalam database Tempat Google.
Lihat detail untuk Respons foto tempat. |
|
Pelengkapan otomatis tempat | Otomatis mengisi nama dan/atau alamat tempat saat pengguna mengetik.
Lihat detail untuk Menempatkan respons pelengkapan otomatis. |
|
Pelengkapan otomatis kueri | Menyediakan layanan prediksi kueri untuk penelusuran geografis berbasis teks, yang menampilkan kueri yang disarankan saat pengguna mengetik.
Lihat detail untuk respons pelengkapan otomatis kueri. |
|
Cara menggunakan Places API
Langkah-langkah di bawah ini mencakup skenario kasus penggunaan standar untuk menggunakan tiga endpoint di layanan Places API. Saat membuat solusi, Anda dapat menggunakan endpoint tambahan, seperti Nearby Search, Place Photos, dan Query Autocomplete.1 | Memulai persiapan | Mulai dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikuti, lalu pelajari cara menggunakan kunci API Anda. |
2 | Mencoba penelusuran teks dasar | Setelah Anda memiliki kunci API, berikan penelusuran teks sederhana seperti yang diindikasikan pada Contoh penelusuran teks dasar di panduan Penelusuran teks. |
3 | Menggunakan permintaan Find Place | Permintaan Find Place menampilkan ID tempat, beserta kolom data yang Anda minta, seperti jam buka, alamat, dan foto. Lihat contoh Find Place dan coba satu lagi yang relevan dengan kasus penggunaan Anda. |
4 | Memahami dasar-dasar respons Find Place | Menjelajahi data yang ditampilkan dari respons Find Place. Lihat Menemukan respons tempat untuk mengetahui detailnya. |
5 | Menggunakan ID tempat untuk mengetahui detail selengkapnya | Respons Find Place tidak menyediakan semua data yang tersedia untuk tempat tertentu. Anda bisa menggunakan ID tempat yang ditampilkan dari respons Find Place untuk mendapatkan detail selengkapnya tentang suatu tempat. Lihat Place Details. |
Library klien yang tersedia
Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:
- Klien Java untuk Layanan Google Maps
- Klien Python untuk Layanan Google Maps
- Klien Go untuk Layanan Google Maps
- Klien Node.js untuk Layanan Google Maps
Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien yang didukung oleh komunitas, yang bersifat open source berdasarkan Lisensi Apache 2.0. Download file dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.
Langkah berikutnya
- Mulai menggunakan penelusuran Places API: Buka Place Search.
- Mendapatkan kunci API: Buka Menggunakan kunci API