Tentang Places API (Baru)

Places API (Baru) menyertakan API berikut:

Dokumen ini berisi ringkasan API baru ini.

Place Details (Baru)

ID tempat secara unik mengidentifikasi tempat di database Google Places dan di Google Maps. Dengan ID tempat, Anda dapat meminta detail tentang tempat usaha atau tempat menarik tertentu dengan memulai permintaan Place Details (New). Permintaan Place Details (Baru) menampilkan informasi komprehensif tentang tempat yang ditunjukkan seperti alamat lengkap, nomor telepon, rating pengguna, dan ulasan.

Ada banyak cara untuk mendapatkan ID tempat. Anda dapat menggunakan:

Place Photo (Baru)

Place Photo (New) API memungkinkan Anda menambahkan konten fotografi berkualitas tinggi ke aplikasi dengan memberi Anda akses ke jutaan foto yang disimpan di database Google Places. Dengan Place Photo (New) API, Anda dapat mengakses foto dan mengubah ukuran gambar ke ukuran yang optimal untuk aplikasi Anda.

Semua permintaan ke Place Photo (New) API harus menyertakan nama resource foto, yang secara unik mengidentifikasi foto yang akan ditampilkan. Anda bisa mendapatkan nama resource foto menggunakan:

Untuk menyertakan nama resource foto dalam respons dari permintaan Place Details (New), Text Search (New), atau Nearby Search (New), pastikan Anda menyertakan kolom photos dalam mask kolom permintaan.

Text Search (Baru) dan Nearby Search (Baru)

Places API menyertakan dua API penelusuran:

  • Penelusuran Teks (Baru)

    Memungkinkan Anda menentukan string teks untuk menelusuri tempat. Misalnya: "Makanan Vegetarian Pedas di Sydney, Australia" atau "Santapan seafood lezat dekat Palo Alto, CA".

    Anda dapat mempersempit penelusuran dengan menentukan detail seperti tingkat harga, status buka saat ini, rating, atau jenis tempat tertentu. Anda juga dapat menentukan untuk membiaskan hasil ke lokasi tertentu, atau membatasi penelusuran ke lokasi tertentu.

  • Nearby Search (Baru)

    Memungkinkan Anda menentukan wilayah untuk ditelusuri beserta daftar jenis tempat. Tentukan wilayah sebagai lingkaran yang ditentukan oleh koordinat lintang dan bujur titik pusat dan radius dalam meter.

    Tentukan satu atau beberapa jenis tempat yang menentukan karakteristik tempat. Misalnya, tentukan "pizza_restaurant" dan "shopping_mall" untuk menelusuri restoran pizza yang terletak di pusat perbelanjaan di wilayah yang ditentukan.

Perbedaan utama antara kedua penelusuran ini adalah Text Search (Baru) memungkinkan Anda menentukan string penelusuran arbitrer, sedangkan Nearby Search (Baru) memerlukan area tertentu untuk melakukan penelusuran.

Token pelengkapan otomatis (Baru) dan sesi

Autocomplete (Baru) adalah layanan web yang menampilkan prediksi tempat dan prediksi kueri sebagai respons terhadap permintaan HTTP. Dalam permintaan, tentukan string penelusuran teks dan batas geografis yang mengontrol area penelusuran.

Token sesi adalah string buatan pengguna yang melacak panggilan Autocomplete (Baru) sebagai sesi. Pelengkapan Otomatis (Baru) menggunakan token sesi untuk mengelompokkan fase kueri dan pemilihan dari penelusuran pelengkapan otomatis pengguna ke dalam sesi terpisah untuk tujuan penagihan.

Kolom, atribut, dan opsi aksesibilitas baru

Places API (Baru) menyertakan kolom, atribut, dan opsi aksesibilitas baru untuk memberi pengguna informasi selengkapnya tentang suatu tempat. Aspek ini dijelaskan di bagian berikut.

Kolom

Places API (Baru) menyertakan beberapa kolom baru:

Kolom Deskripsi
regularSecondaryOpeningHours Menjelaskan waktu tertentu untuk operasi tertentu. Jam buka sekunder berbeda dengan jam buka utama bisnis. Misalnya, restoran dapat menentukan jam layanan pesan antar atau drive-thru sebagai jam buka sekundernya.
paymentOptions Opsi pembayaran yang diterima tempat tersebut. Suatu tempat dapat menerima lebih dari satu opsi pembayaran. Jika data opsi pembayaran tidak tersedia, kolom opsi pembayaran tidak akan ditetapkan. Opsi mencakup hal berikut:
  • Kartu kredit
  • Kartu debit
  • Khusus tunai
  • pembayaran NFC
parkingOptions Opsi parkir yang disediakan oleh tempat. Opsi mencakup hal berikut:
  • Tempat parkir gratis
  • Tempat parkir berbayar
  • Parkir di jalan gratis
  • Parkir valet
  • Tempat parkir di garasi gratis
  • Parkir di garasi berbayar
subDestinations Tempat unik yang terkait dengan tempat tertentu. Misalnya, terminal bandara dianggap sebagai sub-tujuan bandara.
fuelOptions Informasi terbaru tentang opsi bahan bakar yang tersedia di SPBU. Informasi ini diperbarui secara berkala. Opsi mencakup hal berikut:
  • Solar
  • Bensin tanpa timbal biasa
  • Menengah
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • Metana
  • Biodiesel
  • Solar truk
evChargeOptions Jumlah pengisi daya kendaraan listrik (EV) di stasiun ini. Meskipun beberapa pengisi daya Kendaraan Listrik memiliki beberapa konektor, setiap pengisi daya hanya dapat mengisi daya satu kendaraan dalam satu waktu; sehingga, kolom ini mencerminkan jumlah pengisi daya Kendaraan Listrik yang tersedia pada waktu tertentu.
shortFormattedAddress Alamat pendek yang dapat dibaca manusia untuk suatu tempat.
primaryType Jenis utama hasil yang diberikan. Misalnya, tempat dapat diklasifikasikan sebagai cafe atau airport. Tempat hanya dapat memiliki satu jenis utama. Untuk mengetahui daftar lengkap nilai yang mungkin, lihat Jenis yang didukung.
primaryTypeDisplayName Nama tampilan jenis utama, yang dilokalkan ke bahasa permintaan jika berlaku. Untuk mengetahui daftar lengkap nilai yang mungkin, lihat Jenis yang didukung.

Atribut

Places API (Baru) menyertakan beberapa atribut baru:

Atribut Deskripsi
outdoorSeating Tempat ini menyediakan tempat duduk outdoor.
liveMusic Tempat ini menyediakan musik live.
menuForChildren Tempat ini memiliki menu untuk anak-anak.
servesCocktails Tempat ini menyajikan koktail.
servesDessert Tempat ini menyajikan hidangan penutup.
servesCoffee Tempat ini menyajikan kopi.
goodForChildren Tempatnya cocok untuk anak-anak.
allowsDogs Tempat mengizinkan.
restroom Tempat ini memiliki toilet.
goodForGroups Tempat dapat menampung grup.
goodForWatchingSports Tempat cocok untuk menonton acara olahraga.

Opsi aksesibilitas

Places API (Baru) menyertakan kolom opsi aksesibilitas berikut:

Kolom Deskripsi
wheelchairAccessibleParking Tempat ini menawarkan parkir khusus pengguna kursi roda.
wheelchairAccessibleEntrance Tempat memiliki pintu masuk khusus pengguna kursi roda.
wheelchairAccessibleRestroom Tempat ini memiliki toilet khusus pengguna kursi roda.
wheelchairAccessibleSeating Tempat ini memiliki tempat duduk khusus pengguna kursi roda.

Bermigrasi ke Places API Baru

Jika Anda adalah pelanggan Places API yang sudah ada dan ingin memigrasikan aplikasi untuk menggunakan API baru, lihat dokumentasi migrasi berikut: