Ringkasan

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

Mengapa menggunakan Places API

Buat fitur deteksi lokasi agar data lokasi yang mendetail dapat diakses dengan mudah oleh pengguna. Data yang tersedia melalui Places API dibuat berdasarkan salah satu model tempat dunia nyata yang paling akurat, terbaru, dan komprehensif. Berikut contoh kasus penggunaan untuk aplikasi:

  • Tampilkan penyewaan kondominium di area metropolitan utama dengan hasil yang ditargetkan khusus untuk 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 usaha kepada orang-orang yang merencanakan perjalanan.

Apa yang dapat Anda lakukan dengan Places API

Anda dapat menggunakan Places API untuk menyertakan fitur-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.
  • Aktifkan fitur pelengkapan otomatis untuk berbagai jenis penelusuran, baik kueri teks spesifik maupun kueri kategoris.
  • Saring jenis detail yang ditampilkan tentang sebuah tempat, seperti jam buka, ringkasan, ulasan pengguna, dan foto.
  • Tambahkan foto berkualitas tinggi ke lokasi yang dilayani oleh aplikasi Anda.

Cara kerja 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 maupun XML. Terakhir, permintaan layanan menggunakan parameter yang relevan dengan endpoint spesifik tersebut untuk menyaring data yang ditampilkan. Misalnya, permintaan Place Details berikut untuk komponen alamat berfungsi sebagai berikut, dengan asumsi ditampilkan dalam format JSON: 

https://maps.googleapis.com/maps/api/place/details/json
  ?place_id=ChIJrTLr-GyuEmsRBfy61i59si0
  &fields=address_components
  &key=YOUR_API_KEY

Dalam hal ini, layanan menggunakan ID tempat yang disediakan untuk menemukan tempat yang diminta dan menampilkan komponen alamat dalam format JSON.

Resource

Tabel berikut merangkum resource yang tersedia melalui Places API beserta data yang ditampilkannya.

Resource data Data yang ditampilkan Format pengembalian
Place Search Menampilkan daftar tempat berdasarkan lokasi perangkat atau string penelusuran.

Lihat detail untuk Menempatkan respons penelusuran, Respons penelusuran di sekitar, dan Respons penelusuran teks.

  • JSON
  • XML
Detail tempat Menampilkan informasi mendetail tentang tempat tertentu, termasuk ulasan pengguna.

Lihat detail dalam Respons Place Details.

  • JSON
  • XML
Foto tempat Menyediakan akses ke jutaan foto terkait tempat yang disimpan dalam database Tempat Google.

Lihat detail untuk Respons foto tempat.

  • JSON
  • XML
Pelengkapan otomatis tempat Otomatis mengisi nama dan/atau alamat tempat saat pengguna mengetik.

Lihat detail untuk Menempatkan respons pelengkapan otomatis.

  • JSON
  • XML
Pelengkapan otomatis kueri Menyediakan layanan prediksi kueri untuk penelusuran geografis berbasis teks, yang menampilkan kueri yang disarankan saat pengguna mengetik.

Lihat detail untuk respons pelengkapan otomatis kueri.

  • JSON
  • XML

Cara menggunakan Places API

Langkah-langkah di bawah ini mencakup skenario kasus penggunaan standar untuk menggunakan tiga endpoint di layanan Places API. Saat membuat solusi, Anda dapat menggunakan endpoint tambahan, seperti Nearby Search, Place Photos, dan Query Autocomplete.
1 Memulai persiapan Mulai dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikuti, lalu pelajari cara menggunakan kunci API Anda.
2 Mencoba penelusuran teks dasar Setelah Anda memiliki kunci API, berikan penelusuran teks sederhana seperti yang diindikasikan pada Contoh penelusuran teks dasar di panduan Penelusuran teks.
3 Menggunakan permintaan Find Place Permintaan Find Place menampilkan ID tempat, beserta kolom data yang Anda minta, seperti jam buka, alamat, dan foto. Lihat contoh Find Place dan coba satu lagi yang relevan dengan kasus penggunaan Anda.
4 Memahami dasar-dasar respons Find Place Menjelajahi data yang ditampilkan dari respons Find Place. Lihat Menemukan respons tempat untuk mengetahui detailnya.
5 Menggunakan ID tempat untuk mengetahui detail selengkapnya Respons Find Place tidak menyediakan semua data yang tersedia untuk tempat tertentu. Anda bisa menggunakan ID tempat yang ditampilkan dari respons Find Place untuk mendapatkan detail selengkapnya tentang suatu tempat. Lihat Place Details.

Library klien yang tersedia

Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:

Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien yang didukung oleh komunitas, yang bersifat open source berdasarkan Lisensi Apache 2.0. Download file dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya