Ringkasan

Pilih platform: Android iOS JavaScript Layanan Web
Places API adalah layanan yang menerima permintaan HTTP untuk data lokasi melalui berbagai metode. API ini menampilkan data lokasi dan gambar yang diformat tentang tempat usaha, lokasi geografis, atau lokasi menarik yang terkenal.

Alasan menggunakan Places API (Baru)

Buat fitur berbasis lokasi untuk menyediakan data lokasi mendetail kepada pengguna Anda. Data yang tersedia melalui Places API (Baru) dibuat berdasarkan salah satu model tempat yang paling akurat, terbaru, dan komprehensif di dunia nyata. Berikut adalah contoh kasus penggunaan untuk aplikasi:

  • Menampilkan sewa kondominium dalam area 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.
  • Berikan informasi kontak, ulasan, dan tingkat harga untuk tempat di sepanjang rute 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 kategoris.
  • Aktifkan fitur pelengkapan otomatis untuk berbagai jenis penelusuran, baik kueri teks tertentu maupun kueri kategoris.
  • Memilih jenis detail yang ditampilkan tentang suatu tempat, seperti jam buka, ringkasan, ulasan pengguna, dan foto.
  • Tambahkan foto berkualitas tinggi ke lokasi yang ditayangkan oleh aplikasi Anda.

Banyak Google Maps Platform API yang 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 berdasarkan 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 ini mencakup skenario kasus penggunaan standar untuk menggunakan layanan Places API. Saat membuat solusi, Anda dapat menggunakan endpoint tambahan, seperti Nearby Search (Baru) dan Place Photos (Baru).
1 Memulai penyiapan Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan yang mengikuti, lalu pelajari cara menggunakan kunci API.
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 Place Details (New).
4 Mendapatkan foto untuk suatu tempat Foto Tempat (Baru) memberi Anda akses ke jutaan foto yang tersimpan dalam database Places. Gunakan Foto Tempat (Baru) untuk mengakses foto untuk suatu tempat.