Ringkasan

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

Alasan menggunakan Places API

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

  • Tampilkan penyewaan kondominium dalam area metropolitan utama dengan hasil yang ditargetkan khusus ke kota.
  • Sertakan detail tempat dalam pembaruan status pengambilan atau pengiriman.
  • Menampilkan daftar taman di suatu area bersama dengan foto dan ulasan yang dikirim pengguna.
  • Sediakan informasi kontak, ulasan, dan tingkat harga untuk tempat usaha di sepanjang perjalanan kepada orang-orang yang merencanakan perjalanan.

Yang dapat Anda lakukan dengan Places API

Anda dapat menggunakan Places API untuk menyertakan fitur berikut dalam aplikasi:

  • Memberikan hasil penelusuran tempat dari berbagai jenis kueri pengguna, seperti input teks, lokasi terdekat, dan kueri pengguna yang ambigu atau kategorik.
  • Mengaktifkan fitur pelengkapan otomatis untuk berbagai jenis penelusuran, baik kueri teks tertentu atau kategorikal.
  • Saring 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 API Google Maps Platform mendukung ID tempat, dengan ID tempat yang 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 bisa menggunakan Places API untuk meminta detail selengkapnya tentang tempat usaha atau lokasi menarik tertentu, seperti alamat lengkap, nomor telepon, penilaian pengguna, dan ulasan.

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 memutuskan sekumpulan API yang akan digunakan. Hal ini berlaku jika Anda adalah pelanggan baru atau lama yang sudah menggunakan API. Gunakan panduan ini untuk mempelajari perbedaan antara kedua API tersebut.

Cara kerja Places API

Places API (Baru)

Places API (Baru) menerima permintaan sebagai URL standar dengan endpoint layanan, seperti /places atau places:searchText dan menampilkan respons JSON. Places API (Baru) mendukung otorisasi melalui 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 kami, seperti /place atau /photo. Endpoint juga menerima jenis format yang ditentukan dalam permintaan, baik JSON maupun XML. Layanan menggunakan parameter yang relevan dengan endpoint tertentu 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 contoh ini, layanan menggunakan ID tempat yang disediakan untuk menemukan tempat yang diminta dan mengembalikan komponen alamat dalam format JSON.

Resource

Tabel berikut meringkas sumber daya 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.
Penelusuran Di Sekitar Nearby Search (Baru) Semua permintaan yang menggunakan API yang sudah ada dan menyertakan kueri teks harus menggunakan Penelusuran Teks (Baru) karena Nearby Search (Baru) tidak mendukung input teks.
Penelusuran Teks Penelusuran Teks (Baru)
Detail Tempat Place Details (Baru)
Foto Tempat Foto Tempat (Baru)
Pelengkapan Otomatis Tempat Pelengkapan Otomatis (Baru)
Pelengkapan Otomatis Kueri Pelengkapan Otomatis (Baru) Kemampuan yang ditambahkan ke Autocomplete (Baru)

Cara menggunakan Places API

Langkah-langkah di bawah ini mencakup skenario kasus penggunaan umum untuk menggunakan layanan Places API. Saat Anda membangun solusi Anda, Anda dapat menggunakan endpoint tambahan, seperti Nearby Search dan Place Photos.
1 Melakukan penyiapan Mulailah dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan yang mengikutinya, lalu pelajari cara menggunakan kunci API Anda. Untuk Places API (Baru), Anda juga dapat menggunakan Token OAuth.
2 Coba penelusuran teks dasar Lakukan penelusuran teks sederhana menggunakan Text Search (Baru) atau Penelusuran Teks.
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 suatu tempat Layanan Place Photo memberi Anda akses ke jutaan foto yang disimpan di dalam Tempat di skrip untuk menyiapkan database. Gunakan Foto Tempat (Baru) atau Place Details untuk mengakses foto suatu tempat.