Dalam dokumen ini, Anda akan mempelajari cara menggunakan Nearby Search (Baru) API untuk membuat pengalaman penemuan lokal yang sederhana dan hemat biaya
.
Pengalaman penemuan lokal menampilkan tempat-tempat menarik utama kepada pengguna di dekat lokasi yang Anda tentukan saat menelusuri hotel atau properti. Pengalaman 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 dengan interaktivitas.

Kasus Penggunaan
Sekarang, mari kita pahami elemen integrasi penemuan lokal yang mendorong nilai pengguna:
Penemuan - Berikan ringkasan kepada pengguna tentang apa yang ada di sekitar satu lokasi dengan menampilkan tempat-tempat relevan dari berbagai jenis.
Interaktivitas - Berikan kemampuan kepada pengguna untuk memilih tempat dan memperbarui data secara dinamis
relatif terhadap tempat tersebut.
Visualisasi - Berikan ulasan tempat, foto
serta waktu dan jarak tempuh untuk berjalan kaki agar pengguna dapat dengan cepat memahami apakah tempat tersebut sesuai dengan kebutuhan mereka.
Arsitektur Referensi

Penemuan Lokal
Ada banyak cara untuk membuat pengalaman penemuan lokal. Integrasi berikut adalah contoh kustom pengalaman pengguna yang memanfaatkan Google Maps Platform API yang terkenal serta beberapa fitur baru yang menarik. Jika ingin menggunakan pendekatan berbasis template untuk penemuan lokal, Anda dapat menggunakan Komponen Web.
Contoh Aplikasi
Panduan Contoh
Di tabel di bawah, Anda akan menemukan contoh aplikasi yang dipecah menjadi beberapa langkah beserta deskripsi penerapan teknis dengan Google Maps Platform API.
1. Penelusuran Lokasi dengan Pelengkapan OtomatisTelusuri lokasi
- Muat Maps JavaScript API.
- Kueri Places Autocomplete atau pilih lokasi di peta.

2. Tampilkan lokasi menarik lokal menggunakan Nearby Search (Baru) API
- Peringkat popularitas (hasil yang lebih relevan) atau Peringkat jarak.
includedTypes,excludedTypes; jika Anda adalah hotel, Anda dapat mengecualikan jenis “lodging”, dan hanya menyertakan jenis yang sesuai, yaitu: “restaurant, cafe, park, tourit_attraction”.- Manfaatkan
includedPrimaryTypes,excludedPrimaryTypesuntuk mendapatkan kontrol yang lebih besar atas hasil. - `locationRestriction untuk menghindari jumlah hasil yang tidak memadai atau tempat yang terlalu jauh; jika hasilnya NOL, perluas ukuran lingkaran / persegi sebelum menampilkan hasil.

Contoh kueri saat memesan hotel dengan kolom Data yang diminta:
- Dasar (
displayName,types,openingHours,formattedAddress) - Kontak (
websiteUri,nationalPhoneNumber,internationalPhoneNumber) - Pilihan (
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. Tambahkan interaktivitas dengan Dynamic Maps dan Directions API
- **Segmen dan langkah** terbaru dengan membuat kueri Directions API. * Gunakan waktu di bagian berikutnya.

4. Tampilkan informasi mendetail tentang tempat 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 Tanpa Batas Nearby Search (Baru) API, Anda harus membuat kueri Place Details dengan
place.iduntuk mendapatkan photo_reference lalu membuat kueri satu per satu dalam pengalaman Anda

Jumlah kueri dan biaya terkait
- Maps JavaScript API: 1 peta saat memuat pengalaman.
- Places Autocomplete API: 1 kueri setiap karakter yang diketik (jika menggunakan Widget Pelengkapan Otomatis), dapat disesuaikan.
- Nearby Search (Baru) API: 1 kueri setiap 20 tempat yang ditampilkan. Penagihan yang berbeda sesuai dengan data Tempat yang merupakan bagian dari respons kueri.
- Directions API: 1 kueri setiap tempat yang dipilih oleh pengguna.
- Place Photo API: 1 kueri setiap foto yang ditampilkan.
Kesimpulan
Pengalaman penemuan lokal adalah cara yang efektif untuk memberikan nilai kepada pengguna. Implementasi demonstrasi ini memiliki banyak fitur yang kemungkinan akan Anda sertakan saat membuat pengalaman seperti itu di Google Maps Platform dengan kemampuan khusus dari Nearby Search (Baru) API .
Langkah Berikutnya
Bacaan lebih lanjut yang disarankan:
- Komponen Web di Maps JavaScript API
- Pengoptimalan Pelengkapan Otomatis Tempat
- Layanan Tempat Lainnya
- Berikan masukan di bawah.
Kontributor
Penulis utama:
Thomas Anglaret | Google Maps Platform Solutions Engineer