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

Buat fitur berbasis lokasi untuk menyediakan data lokasi mendetail kepada pengguna Anda. 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 sewa kondominium dalam area metropolitan utama dengan hasil yang ditargetkan secara khusus ke 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 di sepanjang rute kepada orang yang merencanakan perjalanan.

Yang dapat Anda lakukan dengan Places API

Anda dapat menggunakan Places API untuk menyertakan 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.
  • Mengaktifkan 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 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 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

Langkah-langkah di bawah ini mencakup skenario kasus penggunaan umum untuk menggunakan layanan Places API. Saat membuat solusi, Anda dapat menggunakan endpoint tambahan, seperti Penelusuran Langsung (Baru) dan Foto Tempat (Baru).
1 Memulai penyiapan Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan yang mengikutinya, 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 API Google Maps Platform menampilkan ID tempat sebagai bagian dari respons. Gunakan ID tempat untuk mendapatkan Place Details (New).
4 Mendapatkan foto untuk suatu tempat Layanan Place Photo (Baru) memberi Anda akses ke jutaan foto yang disimpan dalam database Places. Gunakan Foto Tempat (Baru) untuk mengakses foto tempat.