Pengantar
Places API adalah layanan yang menerima permintaan HTTP untuk data lokasi melalui berbagai metode. API ini menampilkan data lokasi yang diformat dan gambar tentang tempat usaha, lokasi geografis, atau lokasi menarik terkemuka.Alasan menggunakan Places API (Baru)
Buat fitur yang mengetahui lokasi untuk menyediakan data lokasi terperinci bagi pengguna Anda. Data yang tersedia melalui Places API (Baru) dibangun berdasarkan salah satu model tempat dunia nyata yang paling akurat, terbaru, dan komprehensif. Berikut adalah contoh kasus penggunaan untuk aplikasi:
- Menampilkan sewa kondominium di wilayah metropolitan utama dengan hasil yang ditargetkan secara khusus ke kota.
- Menyertakan detail tempat dalam pembaruan status pengambilan atau pengiriman.
- Menampilkan daftar taman di suatu area beserta foto dan ulasan yang dikirimkan pengguna.
- Memberikan informasi kontak, ulasan, dan tingkat harga untuk tempat-tempat yang dilewati kepada orang yang merencanakan perjalanan.
Yang dapat Anda lakukan dengan Places API (Baru)
Anda dapat menggunakan Places API (Baru) untuk menyertakan fitur berikut dalam aplikasi Anda:
- Memberikan hasil penelusuran tempat dari berbagai jenis kueri pengguna, seperti input teks, lokasi terdekat, dan kueri pengguna yang ambigu atau berdasarkan kategori.
- Aktifkan fitur pelengkapan otomatis untuk berbagai jenis penelusuran, baik kueri teks tertentu maupun kueri kategoris.
- Memperbaiki jenis detail yang ditampilkan tentang suatu tempat, seperti jam buka, ringkasan, ulasan pengguna, dan foto.
- Tambahkan foto berkualitas tinggi ke lokasi yang dilayani oleh aplikasi Anda.
Banyak Google Maps Platform API mendukung ID tempat, dengan ID tempat secara unik mengidentifikasi tempat di database Google Places dan di Google Maps. Ada banyak cara untuk mendapatkan ID tempat, termasuk dari Places API (Baru), tetapi juga dari Geocoding API, Routes API, dan Address Validation API.
Setelah memiliki ID tempat, Anda dapat menggunakan Places API (Baru) untuk meminta detail selengkapnya tentang tempat usaha atau lokasi menarik tertentu, seperti alamat lengkap, nomor telepon, rating pengguna, dan ulasan.
Cara kerja Places API (Baru)
Places API (Baru) menerima permintaan sebagai URL standar dengan endpoint layanan tertentu, seperti /places atau places:searchText, dan menampilkan respons JSON.
Places API (Baru) mendukung otorisasi dengan kunci API dan token OAuth.
Contoh berikut membuat permintaan Place Details (Baru) untuk menampilkan
komponen alamat untuk ID tempat menggunakan kunci API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
Cara menggunakan Places API (Baru)
Langkah-langkah di bawah mencakup skenario kasus penggunaan umum untuk menggunakan layanan Places API. Saat mengembangkan solusi, Anda dapat menggunakan endpoint tambahan, seperti Nearby Search (Baru) dan Place Photos (Baru).| 1 | Mulai penyiapan | Siapkan penagihan, aktifkan Places API (Baru), dan buat permintaan pertama Anda. |
| 2 | Mencoba penelusuran teks dasar | Lakukan penelusuran teks menggunakan Text Search (Baru). |
| 3 | Menggunakan ID tempat untuk mengetahui detail selengkapnya | Banyak Google Maps Platform API menampilkan ID tempat sebagai bagian dari respons. Gunakan ID tempat untuk mendapatkan Detail Tempat (Baru). |
| 4 | Mendapatkan foto untuk suatu tempat | Place Photos (Baru) memberi Anda akses ke jutaan foto yang disimpan dalam database Places. Gunakan Foto Tempat (Baru) untuk mengakses foto suatu tempat. |