Tentang Places API (Baru)

Developer Wilayah Ekonomi Eropa (EEA)

Pengantar

Places API (Baru) mencakup API berikut:

Dokumen ini berisi ringkasan API baru tersebut.

Place Details (New)

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

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

Place Photos (Baru)

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

Semua permintaan ke Place Photos (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 (Baru), Text Search (Baru), atau Nearby Search (Baru), pastikan Anda menyertakan kolom photos dalam mask kolom permintaan.

Text Search (Baru) dan Nearby Search (Baru)

Places API (Baru) mencakup dua API penelusuran:

  • Text Search (New)

    Memungkinkan Anda menentukan string teks yang akan digunakan untuk menelusuri tempat. Misalnya: "Spicy Vegetarian Food in Sydney, Australia" atau "Fine seafood dining near Palo Alto, CA".

    Anda dapat menyaring 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 (New)

    Memungkinkan Anda menentukan wilayah yang akan 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 tersebut adalah Text Search (Baru) memungkinkan Anda menentukan string penelusuran arbitrer, sedangkan Nearby Search (Baru) memerlukan area tertentu untuk ditelusuri.

Autocomplete (New) dan token sesi

Autocomplete (New) 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 yang dibuat pengguna yang melacak panggilan Autocomplete (New) sebagai sesi. Autocomplete (New) 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 (New) menyertakan kolom, atribut, dan opsi aksesibilitas baru untuk memberikan informasi selengkapnya tentang suatu tempat kepada pengguna. Aspek-aspek ini dijelaskan di bagian berikut.

Kolom

Places API (New) 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 drive-through atau jam pesan antar sebagai jam sekunder.
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 meliputi:
  • Kartu kredit
  • Kartu debit
  • Hanya uang tunai
  • pembayaran NFC
parkingOptions Opsi parkir yang disediakan oleh tempat. Opsi meliputi:
  • Tempat parkir gratis
  • Tempat parkir berbayar
  • Parkir di jalan gratis
  • Parkir valet
  • Tempat parkir di garasi gratis
  • Tempat 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 meliputi:
  • Solar
  • Bensin 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 SPKLU ini. Meskipun beberapa pengisi daya EV memiliki beberapa konektor, setiap pengisi daya hanya dapat mengisi daya satu kendaraan dalam satu waktu; akibatnya, kolom ini mencerminkan jumlah pengisi daya EV yang tersedia pada waktu tertentu.
shortFormattedAddress Alamat singkat yang dapat dibaca manusia untuk suatu tempat.
primaryType Jenis utama dari hasil yang diberikan. Misalnya, suatu tempat dapat diklasifikasikan sebagai cafe atau airport. Suatu tempat hanya dapat memiliki satu jenis utama. Untuk mengetahui daftar lengkap kemungkinan nilai, lihat Jenis yang didukung.
primaryTypeDisplayName Nama tampilan jenis utama, yang dilokalkan ke bahasa permintaan jika ada. Untuk mengetahui daftar lengkap nilai yang mungkin, lihat Jenis yang didukung.
entrances Pintu masuk untuk tujuan. Pintu masuk adalah satu pasangan koordinat lintang/bujur yang menentukan lokasi titik masuk dan keluar untuk suatu tempat.
navigationPoints Titik navigasi untuk tujuan. Titik navigasi adalah lokasi di samping jalan tempat navigasi dapat berakhir, termasuk mode perjalanan dan penggunaan yang didukung.

Atribut

Places API (New) menyertakan beberapa atribut baru:

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

Opsi aksesibilitas

Places API (New) menyertakan kolom opsi aksesibilitas berikut:

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

Ringkasan yang didukung AI

Ringkasan Places API (New) yang didukung AI menggunakan kemampuan model Gemini untuk menampilkan ringkasan tentang tempat dan area yang dapat membantu pengguna memutuskan tempat yang akan dikunjungi.

Ringkasan yang didukung AI menyatukan data dari berbagai input untuk membantu pengguna membuat keputusan yang lebih tepat tentang suatu tempat. Misalnya, jika Anda sedang mempertimbangkan untuk mencoba restoran baru, ringkasan yang didukung AI dapat menampilkan sorotan menu umum, memberi Anda gambaran tentang suasana, atau mengumpulkan tema dari ulasan pengguna. Jika Anda mengunjungi kota baru, ringkasan yang didukung teknologi AI dapat memberikan ringkasan tentang tempat wisata dan fasilitas di sekitar.

Fitur berteknologi AI yang ditambahkan ke Places API (New)

Ringkasan yang didukung AI didukung oleh Place Details (New), Text Search (New), dan Nearby Search (New). Ringkasan yang didukung AI berikut tersedia dalam respons Places API (New):

  • Ringkasan tempat, yang merupakan ringkasan singkat terkait tempat tertentu.
  • Ringkasan ulasan, yang merupakan ringkasan yang mudah dipahami tentang apa yang dikatakan pengulas tentang suatu tempat.
  • Ringkasan area, yang memberikan ringkasan tempat populer dan terdekat di area sekitar. Ringkasan ini mencakup ringkasan lingkungan dan ringkasan stasiun pengisian kendaraan listrik umum.

Google sering membuat ulang ringkasan ini untuk memastikan ringkasan tersebut selalu baru berdasarkan informasi terbaru yang tersedia. Saat membuat permintaan Places API (New), Anda akan menampilkan data terbaru di aplikasi.

Bermigrasi ke Places API (New)

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