Dalam dokumen ini, Anda akan mempelajari cara menggunakan Nearby Search (Baru) API untuk membuat API yang mudah dan hemat biaya
pengalaman penemuan lokal.
Pengalaman penemuan lokal menampilkan tempat-tempat menarik utama kepada pengguna di dekat lokasi yang Anda tentukan saat menelusuri hotel atau properti. Objek ini sering kali terdiri dari peta interaktif, dengan panel tambahan yang berisi pemilih tempat dan galeri foto. Anda akan melihat berbagai produk dan kemampuan Google Maps Platform untuk meningkatkan pengalaman interaktivitas.
Kasus Penggunaan
Sekarang, mari kita pahami elemen apa saja dari integrasi penemuan lokal yang mendorong nilai pengguna:
Penemuan - Memberi pengguna ringkasan tentang hal-hal di sekitar satu lokasi dengan menampilkan berbagai jenis tempat yang relevan.
Interaktivitas - Memberdayakan pengguna untuk memilih tempat dan memperbarui data secara dinamis
relatif terhadap tempat tersebut.
Visualisasi - Memberikan ulasan tempat, foto
serta waktu dan jarak berjalan kaki agar pengguna dapat memahami dengan cepat apakah itu sesuai dengan kebutuhan mereka.
Arsitektur Referensi
Penemuan Lokal
Ada banyak cara untuk menciptakan pengalaman penemuan lokal. Integrasi berikut adalah contoh kustom pengalaman pengguna yang memanfaatkan API Google Maps Platform yang terkenal serta beberapa fitur baru yang menarik. Jika ingin memiliki template pendekatan untuk penemuan lokal, Anda dapat menggunakan Komponen Web.
Contoh Aplikasi
Panduan Contoh
Dalam tabel di bawah contoh aplikasi yang dibagi menjadi beberapa langkah, Anda akan menemukan deskripsi implementasi teknis dengan Google Maps Platform API.
1. Penelusuran Lokasi dengan lokasi AutocompleteSearch
- Muat Maps JavaScript API.
- Place Autocomplete atau pilih lokasi di peta.
2. Menampilkan lokasi menarik lokal menggunakan Nearby Search (New) API
- Peringkat popularitas (hasil yang lebih relevan) atau Peringkat jarak.
includedTypes
,excludedTypes
; jika Anda adalah hotel, Anda dapat mengecualikan jenis “penginapan”, dan hanya menyertakan jenis yang sesuai, yaitu: “restoran, kafe, taman, turit_attraction”.- Manfaatkan
includedPrimaryTypes
,excludedPrimaryTypes
untuk mendapatkan kontrol yang lebih besar atas hasil. - `locationRestriction untuk menghindari jumlah hasil yang tidak memadai atau terlalu jauh, jika hasil TIDAK ADA, perluas ukuran lingkaran / persegi panjang sebelum menampilkan hasil.
Contoh kueri saat memesan hotel dengan Kolom data yang diminta:
- Dasar (
displayName
,types
,openingHours
,formattedAddress
) - Kontak (
websiteUri
,nationalPhoneNumber
,internationalPhoneNumber
) - Lebih disarankan (
reviews
,priceLevel
,userRatingCount
)
{ "includedTypes": ["restaurant","cafe","park"], "excludedTypes": ["lodging","convenience_store"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
Contoh kueri saat menelusuri properti dengan Kolom data yang diminta:
- Dasar (
displayName
,types
,openingHours
,formattedAddress
)
{ "includedTypes": ["school","transport","bus","convenience_store"], "excludedTypes": ["lodging"], "includedPrimaryTypes": ["restaurant","tourist_attraction","airport"], "excludedPrimaryTypes": ["lodging"], "maxResultCount": 20, "locationRestriction": { "circle": { "center": { "latitude": 37.7937, "longitude": -122.3965 }, "radius": 500.0 } } }
3. Menambahkan interaktivitas dengan Dynamic Maps dan Directions API
- Perbarui leg dan steps dengan membuat kueri Directions API. * Gunakan waktu di bagian berikutnya.
4. Tampilkan informasi mendetail tentang tempat tersebut saat interaksi
Deskripsi:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Waktu: berasal dari kueri Directions API sebelumnya.
Ulasan:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.Gambar: selama Pratinjau Tidak Dibatasi Nearby Search API (Baru), Anda harus mengirimkan kueri Detail Tempat dengan
place.id
untuk mendapatkan photo_reference lalu membuat kueri satu per satu dalam pengalaman Anda
Jumlah kueri dan biaya yang terkait
- Maps JavaScript API: 1 peta saat pengalaman dimuat.
- Places Autocomplete API: 1 kueri untuk setiap karakter yang diketik (jika menggunakan Widget Autocomplete), dapat disesuaikan.
- Nearby Search (Baru) API: 1 kueri setiap 20 tempat yang ditampilkan. Penagihan yang berbeda menurut data Tempat yang merupakan bagian dari respons kueri.
- Directions API: 1 buat kueri untuk setiap tempat yang dipilih oleh pengguna.
- Place Photo API: 1 kueri setiap foto yang ditampilkan.
Kesimpulan
Pengalaman penemuan lokal adalah cara efektif untuk memberikan nilai kepada pengguna. Implementasi demonstrasi ini memiliki banyak fitur yang mungkin Anda sertakan saat membuat pengalaman tersebut di Google Maps Platform dengan kemampuan khusus dari Nearby Search (Baru) API .
Langkah Berikutnya
Disarankan bacaan lebih lanjut:
- Komponen Web di Maps JavaScript API
- Pengoptimalan Places Autocomplete
- Layanan Places lainnya
- Berikan masukan di bawah.
Kontributor
Penulis utama:
Thomas Anglaret | Engineer Solusi Google Maps Platform