Meningkatkan penemuan lokal dengan Nearby Search API (Baru)

Dalam dokumen ini, Anda akan mempelajari cara menggunakan Nearby Search (Baru) API ke membangun solusi yang sederhana dan hemat biaya

pengalaman penemuan lokal.

Pengalaman penemuan lokal menunjukkan kepada pengguna tempat-tempat menarik utama di dekat lokasi yang Anda tentukan saat menelusuri hotel atau perumahan. Sering kali terdiri dari peta interaktif, dengan panel tambahan yang berisi pemilih tempat dan galeri foto. Anda akan melihat berbagai platform Google Maps Platform dan kemampuan untuk meningkatkan pengalaman dengan interaktivitas.

Kasus Penggunaan

Sekarang, mari kita pahami elemen apa dari integrasi penemuan lokal yang mendorong pengguna nilai:

• Penemuan - Memberi pengguna ringkasan tentang apa saja yang ada 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 itu.

• Visualisasi - Memberikan ulasan dan foto tempat

  serta waktu dan jarak berjalan kaki agar pengguna dapat memahami dengan cepat apakah dan kebutuhan pengguna.

Arsitektur Referensi

Penemuan Lokal

Ada banyak cara untuk menciptakan pengalaman penemuan lokal. Hal berikut adalah contoh kustom pengalaman pengguna yang memanfaatkan Google Maps Platform API yang dikenal luas serta beberapa fitur baru yang menarik. Jika Anda ingin memiliki pendekatan template untuk penemuan lokal, Anda dapat menggunakan Web Komponen.

Contoh Aplikasi

Panduan Contoh

Anda akan menemukan aplikasi contoh yang diuraikan dalam langkah-langkah pada tabel di bawah ini bersama dengan deskripsi implementasi teknis dengan Google Maps API Platform.

1. Penelusuran Lokasi dengan lokasi AutocompleteSearch

• Muat Maps JavaScript API.
• Kueri Place Autocomplete atau pilih lokasi di peta.

2. Menampilkan lokasi menarik lokal menggunakan Nearby Search API (Baru)

• Peringkat popularitas (hasil yang lebih relevan) atau Peringkat jarak.
• includedTypes, excludedTypes ; jika Anda adalah hotel, Anda dapat mengecualikan "penginapan", dan hanya mencakup jenis yang sesuai, yaitu: "restoran, kafe, taman, turit_attraction”.
• Manfaatkan includedPrimaryTypes, excludedPrimaryTypes untuk mengetahui lebih banyak lagi mengontrol hasil.
• `locationRestriction untuk menghindari jumlah hasil yang tidak mencukupi atau terlalu jauh tempat ; jika hasilnya nol, perluas ukuran lingkaran / persegi panjang sebelumnya untuk menampilkan hasil.

Contoh kueri saat memesan hotel dengan kolom Data yang diminta:

• Dasar (displayName, types, openingHours, formattedAddress)
• Kontak (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
• Lebih disukai (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

• Bagian dan langkah yang terbaru dengan membuat kueri Directions API lebih lanjut. * Gunakan waktu di bagian berikutnya.

4. Menampilkan informasi mendetail tentang tempat setelah interaksi

1. Deskripsi: displayName, types, rating, userRatingCount, priceLevel.

   Waktu: berasal dari kueri Directions API sebelumnya.

2. Ulasan: reviews[i].author, reviews[i].rating,reviews[i].text.

3. Gambar: selama Pratinjau Tak Terbatas untuk Nearby Search API (Baru), Anda harus mengkueri Places Detail dengan place.id untuk mendapatkan photo_reference kemudian membuat kueri satu per satu sesuai pengalaman Anda

Jumlah kueri dan biaya yang terkait

• Maps JavaScript API: 1 peta pada pemuatan pengalaman.
• Places Autocomplete API: 1 kueri untuk setiap karakter yang diketik (jika menggunakan Pelengkapan Otomatis {i>Widget<i}), dapat disesuaikan.
• Nearby Search (Baru) API: 1 kueri setiap 20 tempat ditampilkan. Penagihan yang berbeda menurut Tempat data yang merupakan bagian dari respons kueri.
• Petunjuk arah API: 1 kueri setiap tempat yang dipilih pengguna.
• Foto Tempat API: 1 kueri untuk setiap foto yang ditampilkan.

Kesimpulan

Pengalaman penemuan lokal adalah cara yang efektif untuk memberikan nilai kepada pengguna. Ini Contoh penerapan memiliki banyak fitur yang kemungkinan akan Anda sertakan saat menciptakan pengalaman tersebut di Google Maps Platform dengan kemampuan khusus dari Nearby Search API (Baru) API .

Langkah Berikutnya

Saran bacaan lebih lanjut:

• Komponen Web di Maps JavaScript API
• Pengoptimalan Places Autocomplete
• Layanan Places lainnya
• Berikan masukan di bawah.

Kontributor

Penulis utama:

Thomas Anglaret | Google Maps Engineer Solusi Platform