Alasan menggunakan Places API
Buat fitur kemampuan penentuan lokasi untuk mempermudah akses data lokasi bagi pengguna. Data yang tersedia melalui Places API dibuat berdasarkan salah satu model tempat yang paling akurat, terbaru, dan komprehensif di dunia nyata. Berikut adalah contoh kasus penggunaan untuk aplikasi:
- Menampilkan penyewaan kondominium di area metropolitan utama dengan hasil yang ditargetkan secara khusus ke kota.
- Menyertakan detail tempat dalam pembaruan status pengambilan atau pengiriman.
- Tampilkan daftar taman di suatu area bersama dengan foto dan ulasan yang dikirimkan pengguna.
- Beri orang yang merencanakan perjalanan dengan informasi kontak, ulasan, dan tingkat harga untuk tempat usaha di sepanjang perjalanan.
Yang dapat Anda lakukan dengan Places API
Anda dapat menggunakan Places API 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 kategoris.
- Aktifkan fitur pelengkapan otomatis untuk berbagai jenis penelusuran, baik kueri teks tertentu maupun kueri kategori.
- Saring jenis detail yang ditampilkan tentang suatu tempat, seperti jam buka, ringkasan, ulasan pengguna, dan foto.
- Tambahkan foto berkualitas tinggi ke lokasi yang disediakan oleh aplikasi Anda.
Banyak API Google Maps Platform mendukung ID tempat, dengan ID tempat secara unik mengidentifikasi tempat di database Google Places dan Google Maps. Ada banyak cara untuk mendapatkan ID tempat, termasuk dari Places API, tetapi juga dari Geocoding API, Routes API, dan Address Validation API.
Setelah memiliki ID tempat, Anda dapat menggunakan Places API untuk meminta detail selengkapnya tentang tempat usaha atau lokasi menarik tertentu, seperti alamat lengkap, nomor telepon, rating pengguna, dan ulasannya.
Pilih versi Places API Anda
Places API mendukung dua versi API: Places API adalah API yang sudah ada dan Places API (Baru) adalah versi API generasi berikutnya.
Dengan dirilisnya Places API (Baru), tugas pertama Anda adalah menentukan kumpulan API mana yang akan digunakan. Hal ini berlaku jika Anda adalah pelanggan baru atau pelanggan lama yang sudah menggunakan API ini. Gunakan panduan ini untuk mempelajari perbedaan utama antara kedua API.
Cara kerja Places API
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 untuk menampilkan komponen alamat untuk
ID tempat menggunakan kunci API:
https://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents &key=YOUR_API_KEY
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 atau XML. Permintaan layanan menggunakan parameter yang relevan dengan endpoint spesifik tersebut untuk menyaring data yang ditampilkan.
Contoh berikut membuat permintaan Place Details untuk menampilkan komponen alamat untuk
ID tempat dalam format JSON:
https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJrTLr-GyuEmsRBfy61i59si0 &fields=address_components &key=YOUR_API_KEY
Dalam instance ini, layanan menggunakan ID tempat yang diberikan untuk menemukan tempat yang diminta dan menampilkan komponen alamat dalam format JSON.
Referensi
Tabel berikut meringkas resource yang tersedia melalui Places API.
Places API | Places API (Baru) | Catatan |
---|---|---|
Find Place | Penelusuran Teks (Baru) | Tidak ada versi baru Find Place. Text Search (Baru) telah menggantikannya. |
Nearby Search | Nearby Search (Baru) | Semua permintaan menggunakan API yang ada dan menyertakan kueri teks harus menggunakan Text Search (Baru) karena Nearby Search (Baru) tidak mendukung input teks. |
Penelusuran Teks | Penelusuran Teks (Baru) | |
Place Details | Place Details (Baru) | |
Foto Tempat | Foto Tempat (Baru) | |
Pelengkapan Otomatis Tempat | Pelengkapan Otomatis (Baru) | Dalam Pratinjau |
Pelengkapan Otomatis Kueri | Pelengkapan Otomatis (Baru) | Kemampuan yang ditambahkan ke versi Pratinjau Autocomplete (Baru) |
Cara menggunakan Places API
Langkah-langkah di bawah ini mencakup skenario kasus penggunaan umum untuk menggunakan layanan Places API. Saat membuat solusi, Anda dapat menggunakan endpoint tambahan, seperti Nearby Search dan Place Photos.1 | Memulai persiapan | Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikuti, lalu pelajari cara menggunakan kunci API Anda. Untuk Places API (Baru), Anda juga dapat menggunakan token OAuth. |
2 | Mencoba penelusuran teks dasar | Lakukan penelusuran teks sederhana menggunakan Text Search (Baru) atau Text Search. |
3 | Menggunakan ID tempat untuk mengetahui detail selengkapnya | Banyak API Google Maps Platform menampilkan ID tempat sebagai bagian dari respons. Gunakan ID tempat untuk mendapatkan detail tentang suatu tempat. Lihat Place Details (Baru) dan Place Details. |
4 | Mendapatkan foto untuk suatu tempat | Layanan Place Photo memberi Anda akses ke jutaan foto yang tersimpan dalam database Places. Gunakan Place Photo (Baru) atau Place Details untuk mengakses foto suatu tempat. |