Tentang Places API (Baru)

Places API (Baru) menyertakan API berikut:

Dokumen ini berisi ringkasan tentang API baru tersebut.

Place Details (Baru)

ID tempat secara unik mengidentifikasi tempat di database Google Places dan di di Google Maps. Dengan ID tempat, Anda bisa meminta detail tentang tempat usaha atau lokasi menarik dengan memulai Place Details (Baru) permintaan. Permintaan Place Details (Baru) menampilkan informasi komprehensif tentang tempat yang ditunjukkan seperti alamat lengkap, nomor telepon, peringkat pengguna, dan untuk tinjauan sejawat (peer review).

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

Foto Tempat (Baru)

Place Photo (Baru) API memungkinkan Anda menambahkan konten fotografi berkualitas tinggi ke aplikasi Anda dengan memberi Anda akses ke jutaan foto yang disimpan dalam Database Google Places. Dengan menggunakan Place Photo (New) API, Anda dapat mengakses 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 dapat memperoleh referensi foto menggunakan:

Untuk menyertakan nama resource foto dalam respons dari Place Details (Baru), Permintaan Text Search (Baru), atau Nearby Search (Baru), pastikan Anda menyertakan kolom photos di 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. Contoh: "Makanan Vegetarian Pedas di Sydney, Australia" atau "Restoran seafood terbaik di dekat Palo Alto, CA".

    Anda dapat menyaring penelusuran dengan menentukan detail seperti tingkat harga, status pembukaan saat ini, rating, atau jenis tempat tertentu. Anda juga dapat menentukan untuk mencondongkan hasil ke lokasi tertentu, atau membatasi pencarian ke lokasi tertentu.

  • Nearby Search (Baru)

    Memungkinkan Anda menentukan wilayah yang akan ditelusuri bersama dengan daftar jenis tempat. Tetapkan wilayah sebagai lingkaran yang ditentukan oleh lintang dan bujur koordinat titik pusat dan radius dalam meter.

    Tentukan satu atau beberapa jenis tempat yang mendefinisikan karakteristik tempat saat ini. Misalnya, tentukan "pizza_restaurant" dan "shopping_mall" dapat cari restoran pizza yang terletak di pusat perbelanjaan di teritorial Anda.

Perbedaan utama di antara kedua penelusuran tersebut adalah bahwa Text Search (Baru) memungkinkan Anda menentukan string penelusuran arbitrer, sedangkan Nearby Search (Baru) memerlukan area yang ingin ditelusuri.

Pelengkapan otomatis (Baru) dan token sesi

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

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

Kolom baru, atribut, dan opsi aksesibilitas

Places API (Baru) menyertakan kolom, atribut, dan opsi aksesibilitas baru untuk memberikan informasi lebih lanjut kepada pengguna tentang suatu tempat. Aspek-aspek tersebut yang dijelaskan di bagian berikut.

Kolom

Places API (Baru) menyertakan beberapa kolom baru:

Kolom Deskripsi
regularSecondaryOpeningHours Menjelaskan waktu tertentu untuk operasi tertentu. Sekunder jam buka berbeda dari jam buka utama bisnis. Sebagai misalnya, restoran dapat menentukan jam buka atau pesan antar {i>drive<i} jam sebagai jam sekundernya.
paymentOptions Opsi pembayaran yang diterima tempat tersebut. Suatu tempat dapat menerima lebih dari satu opsi pembayaran. Jika data opsi pembayaran tidak tersedia, bidang opsi pembayaran akan dibatalkan penetapannya. Opsi meliputi:
  • Kartu kredit
  • Kartu debit
  • Khusus tunai
  • pembayaran NFC
parkingOptions Opsi parkir yang disediakan oleh tempat. Opsi meliputi:
  • Tempat parkir gratis
  • Tempat parkir berbayar
  • Parkir di jalan gratis
  • Parkir valet
  • Parkir di garasi gratis
  • Parkir berbayar di garasi
subDestinations Tempat unik yang terkait dengan tempat tertentu. Sebagai contohnya, terminal bandara dianggap sebagai sub-tujuan dari bandara.
fuelOptions Informasi terbaru tentang opsi bahan bakar yang tersedia di SPBU. Informasi ini diperbarui secara berkala. Opsinya meliputi berikut ini:
  • Solar
  • Tanpa timbal reguler
  • 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 kendaraan satu per satu; hasilnya, {i>field<i} ini mencerminkan jumlah pengisi daya Kendaraan Listrik yang tersedia pada waktu tertentu.
shortFormattedAddress Alamat singkat yang dapat dibaca orang untuk suatu tempat.
primaryType Jenis utama hasil yang diberikan. Misalnya, suatu tempat mungkin diklasifikasikan sebagai cafe atau airport. J tempat hanya bisa memiliki satu tipe utama. Untuk daftar lengkap nilai yang mungkin, lihat Jenis yang didukung.
primaryTypeDisplayName Nama tampilan jenis utama, dilokalkan ke permintaan jika berlaku. Untuk daftar lengkap nilai yang memungkinkan, lihat Jenis yang didukung.

Atribut

Places API (Baru) menyertakan beberapa atribut baru:

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

Opsi aksesibilitas

Places API (Baru) menyertakan kolom opsi aksesibilitas berikut:

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

Bermigrasi ke New Places API

Jika Anda pelanggan Places API lama dan ingin memigrasikan aplikasi Anda ke menggunakan API baru, lihat dokumentasi migrasi berikut: