Places API (Baru) menyertakan API berikut:
- Place Details (Baru)
- Foto Tempat (Baru)
- Nearby Search (Baru)
- Penelusuran Teks (Baru)
- Pelengkapan Otomatis (Baru)
Dokumen ini berisi ringkasan tentang API baru tersebut.
Place Details (Baru)
ID tempat secara unik mengidentifikasi tempat di database Google Places dan Google Maps. Dengan ID tempat, Anda dapat meminta detail tentang tempat usaha atau lokasi menarik tertentu dengan memulai permintaan Place Details (Baru). Permintaan Place Details (Baru) menampilkan informasi komprehensif tentang tempat yang ditunjukkan seperti alamat lengkap, nomor telepon, rating pengguna, dan ulasannya.
Ada banyak cara untuk mendapatkan ID tempat. Anda dapat menggunakan:
- Penelusuran Teks (Baru)
- Nearby Search (Baru)
- Geocoding API
- Routes API
- Address Validation API
- Pelengkapan Otomatis Tempat
Foto Tempat (Baru)
Place Photo (Baru) API memungkinkan Anda menambahkan konten fotografi berkualitas tinggi ke aplikasi dengan memberi Anda akses ke jutaan foto yang tersimpan di database Google Places. Dengan menggunakan Place Photo (Baru) 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 mengidentifikasi foto yang akan ditampilkan secara unik. 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 tersebut.
Text Search (Baru) dan Nearby Search (Baru)
Places API menyertakan dua API penelusuran:
-
Memungkinkan Anda menentukan string teks untuk menelusuri tempat. Misalnya: "Makanan Vegetarian Pedas di Sydney, Australia" atau "Restoran seafood enak di dekat 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.
-
Memungkinkan Anda menentukan wilayah yang akan ditelusuri bersama dengan daftar jenis tempat. Tentukan wilayah sebagai lingkaran yang ditentukan oleh koordinat lintang dan bujur dari titik tengah dan radius dalam meter.
Tentukan satu atau beberapa jenis tempat yang mendefinisikan karakteristik tempat. Misalnya, tentukan "
pizza_restaurant
" dan "shopping_mall
" untuk menelusuri restoran pizza yang berada di pusat perbelanjaan di wilayah tertentu.
Perbedaan utama antara kedua penelusuran tersebut adalah Text Search (Baru) memungkinkan Anda menentukan string penelusuran arbitrer, sedangkan Nearby Search (Baru) memerlukan area tertentu untuk melakukan penelusuran.
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 string penelusuran teks dan batas geografis yang mengontrol area penelusuran.
Token sesi adalah string buatan pengguna yang melacak panggilan Autocomplete (Baru) sebagai sesi. Autocomplete (Baru) menggunakan token sesi untuk mengelompokkan fase kueri dan pemilihan dari penelusuran pelengkapan otomatis pengguna ke dalam sesi terpisah untuk tujuan penagihan.
Kolom baru, atribut, dan opsi aksesibilitas
Places API (Baru) menyertakan kolom, atribut, dan opsi aksesibilitas baru untuk memberikan lebih banyak informasi tentang suatu tempat kepada pengguna. Aspek-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 buka drive-through atau jam pesan antar sebagai jam sekundernya. |
paymentOptions |
Opsi pembayaran yang diterima tempat tersebut. Sebuah tempat dapat menerima lebih dari
satu opsi pembayaran. Jika data opsi pembayaran tidak tersedia, kolom
opsi pembayaran akan dibatalkan penetapannya. Opsi meliputi:
|
parkingOptions |
Opsi parkir yang disediakan oleh tempat. Opsi meliputi:
|
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. Opsinya meliputi:
|
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 pada satu waktu. Akibatnya, kolom 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, tempat dapat diklasifikasikan sebagai cafe atau airport . Sebuah tempat hanya dapat memiliki satu jenis utama. Untuk daftar lengkap
nilai yang dimungkinkan, lihat Jenis yang didukung. |
primaryTypeDisplayName |
Nama tampilan jenis utama, dilokalkan ke bahasa 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 adalah pelanggan Places API yang sudah ada dan ingin memigrasikan aplikasi Anda untuk menggunakan API baru, lihat dokumentasi migrasi berikut: