Meningkatkan penemuan lokal dengan Nearby Search API (Baru)

Dalam dokumen ini, Anda akan mempelajari cara menggunakan Nearby Search API (Baru) untuk membuat API yang sederhana 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. Panel ini sering kali terdiri dari peta interaktif, dengan panel tambahan yang berisi pemilih tempat dan galeri foto. Anda akan disajikan berbagai produk dan kemampuan Google Maps Platform untuk meningkatkan pengalaman dengan interaktivitas.

contoh penemuan lokal

Kasus Penggunaan

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

  • Penemuan - Memberi pengguna ringkasan tentang hal-hal 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 aplikasi tersebut sesuai dengan kebutuhan mereka atau tidak.

Arsitektur Referensi

alt_text

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 pendekatan template untuk penemuan lokal, Anda dapat menggunakan Komponen Web.

Contoh Aplikasi

Panduan Contoh

Anda akan menemukan tabel di bawah contoh aplikasi yang dibagi menjadi beberapa langkah beserta deskripsi implementasi teknis dengan API Google Maps Platform.

1. Penelusuran Lokasi dengan lokasi AutocompleteSearch

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

contoh pelengkapan otomatis

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 jenis “penginapan”, dan hanya menyertakan jenis yang sesuai, yaitu: “restoran, kafe, taman, wisata_wisata”.
  • Manfaatkan includedPrimaryTypes, excludedPrimaryTypes untuk kontrol yang lebih besar atas hasil.
  • `locationRestriction untuk menghindari jumlah hasil yang tidak memadai atau tempat yang terlalu jauh; jika tidak ada hasil, perluas ukuran lingkaran / persegi panjang sebelum menampilkan hasil.

contoh tempat-tempat terdekat

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

  • Segmen dan langkah terbaru dengan membuat kueri Directions API. * Gunakan waktu di bagian berikutnya.

contoh rute

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 mengajukan kueri ke Places Details dengan place.id untuk mendapatkan photo_reference untuk lalu membuat kueri satu per satu selama pengalaman Anda

detail tempat

Jumlah kueri dan biaya yang terkait

Kesimpulan

Pengalaman penemuan lokal adalah cara yang efektif untuk memberikan nilai kepada pengguna. Implementasi demo ini memiliki banyak fitur yang dapat Anda sertakan saat membuat pengalaman tersebut di Google Maps Platform dengan kemampuan khusus dari Nearby Search API (Baru) .

Langkah Berikutnya

Saran bacaan lebih lanjut:

Kontributor

Penulis utama:

Thomas Anglaret | Engineer Solusi Google Maps Platform