Pengantar
Places API adalah layanan yang menerima permintaan HTTP untuk data lokasi melalui berbagai metode. Layanan ini menampilkan data lokasi dan gambar berformat tentang tempat usaha, lokasi geografis, atau lokasi menarik terkemuka.Alasan menggunakan Places API (Baru)
Buat fitur yang mendukung lokasi untuk menyediakan data lokasi mendetail kepada pengguna Anda. Data yang tersedia melalui Places API (Baru) dibuat berdasarkan salah satu model tempat paling akurat, terbaru, dan komprehensif di dunia nyata. Berikut adalah contoh kasus penggunaan untuk aplikasi:
- Menampilkan penyewaan kondominium di wilayah metropolitan utama dengan hasil yang ditargetkan secara khusus ke kota.
- Menyertakan detail tempat dalam update 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 usaha di sepanjang perjalanan 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:
- Menyediakan hasil penelusuran tempat dari berbagai jenis kueri pengguna, seperti input teks, lokasi terdekat, dan kueri pengguna yang ambigu atau kategoris.
- Mengaktifkan fitur pelengkapan otomatis untuk berbagai jenis penelusuran, baik kueri teks tertentu maupun kueri kategoris.
- Menyempurnakan jenis detail yang ditampilkan tentang suatu tempat, seperti jam buka, ringkasan, ulasan pengguna, dan foto.
- Menambahkan foto berkualitas tinggi ke lokasi yang ditayangkan oleh aplikasi Anda.
Banyak Google Maps Platform API yang mendukung ID tempat, dengan ID tempat yang secara unik mengidentifikasi tempat di database Google Places dan 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 membuat solusi, Anda dapat menggunakan endpoint tambahan, seperti Nearby Search (Baru) dan Place Photos (Baru).| 1 | Mulai menyiapkan | Siapkan penagihan, aktifkan Places API (Baru), dan buat permintaan pertama Anda. |
| 2 | Coba penelusuran teks dasar | Kirim penelusuran teks menggunakan Text Search (Baru). |
| 3 | Gunakan ID tempat untuk detail selengkapnya | Banyak Google Maps Platform API yang menampilkan ID tempat sebagai bagian dari a respons. Gunakan ID tempat untuk mendapatkan Place Details (Baru). |
| 4 | Dapatkan foto untuk suatu tempat | Place Photos (Baru) memberi Anda akses ke jutaan foto yang tersimpan dalam database Places. Gunakan Place Photos (Baru) untuk mengakses foto suatu tempat. |