Bu belgede, Yakındaki Arama (Yeni) API'sinin nasıl kullanılacağını basit ve uygun maliyetli
yerel keşif deneyimi.
Yerel keşif deneyimi, kullanıcılara bir konumun yakınındaki önemli yerleri gösterir otel veya emlak ararken belirttiğiniz yerdir. Genellikle bir veya daha fazla etkileşimli harita, ek bir panelde yer seçici ve bir yer tutucunun yanı sıra fotoğraf galerisi. Farklı bir Google Haritalar Platformu ile karşılaşacaksınız etkileşimli deneyimi geliştiren ürün ve olanaklar vardır.
Kullanım Alanları
Şimdi de yerel keşif entegrasyonunun hangi unsurlarının kullanıcıları sitenize çektiğini öğrenelim. değer:
Keşif: Kullanıcılara tek bir konumun çevresinde neler olduğuna dair genel bakış sunun alakalı çeşitli yerlerden yararlanarak
Etkileşim: Kullanıcılara bir yer seçmeleri ve verileri dinamik olarak yenilemeleri için destek olun.
göreceli olarak ortaya koyar.
Görselleştirme - Yerlerle ilgili yorumlar, fotoğraflar sağlayın
ve kullanıcıların uygun olup olmadığını hızlıca anlayabilmeleri için yürüme süresi ve mesafesi bahsedebilir.
Referans Mimari
Yerel Keşif
Yerel bir keşif deneyimi oluşturmanın birçok yolu vardır. Aşağıdakiler entegrasyon, Google Cloud'un gücünden yararlanan bir kullanıcı deneyiminin özel bir örneğidir bilinen Google Haritalar Platformu API'leri ve bazı heyecan verici yeni özellikler hakkında daha fazla bilgi edinin. Şu durumda: yerel keşif için şablonlu bir yaklaşım kullanmak istiyorsanız Bileşenler.
Örnek Uygulama
Örnek Adım Adım Açıklamalı Kılavuz
Aşağıdaki tabloda adımlara ayrılmış örnek uygulamayı bulabilirsiniz ve Google Haritalar'daki teknik uygulamanın bir açıklamasıyla birlikte Platform API'leri.
1. AutocompleteSearch konum bilgisiyle Konum Arama
- Haritalar JavaScript API'sini yükleyin.
- Yerler Otomatik Tamamlama sorgusunu sorgulayın veya haritadan bir konum seçin.
2. Yakındaki Arama (Yeni) API'sini kullanarak yerel önemli yerleri gösterin
- Popülerlik sıralaması (daha alakalı sonuçlar) veya Mesafe sıralaması.
includedTypes
,excludedTypes
; Bunu hariç tutabileceğiniz bir otelseniz ve yalnızca uygun türleri dahil edin (ör. “restoran, kafe, park, turit_attraction” olarak doğrulayabilirsiniz.- Daha fazlası için
includedPrimaryTypes
veexcludedPrimaryTypes
özelliklerinden yararlanın sonuçlar üzerinde kontrol sahibi olmanızı sağlar. - Yetersiz sayıda sonuç veya çok uzak bir noktadan kaçınmak için konum kısıtlaması yer ; sonuç SIFIR ise, sonuçtan önce daire / dikdörtgen boyutunu genişletin. seçeneğini tıklayın.
İstenen veri alanları ile otel rezervasyonu yaparken sorgu örneği:
- Temel (
displayName
,types
,openingHours
,formattedAddress
) - Kişi (
websiteUri
,nationalPhoneNumber
,internationalPhoneNumber
) - Tercih edilir (
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 } } }
Veri alanları istenen bir gayrimenkul ararken sorgu örneği:
- Temel (
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. Dynamic Maps and Directions API ile etkileşim ekleyin
- Sorgulayarak bacak ve adımlar güncelYol tarifi API. * Bir sonraki bölümde zamanı kullanın.
4. Etkileşimden sonra bu yerin ayrıntılı bilgilerini gösterin
Açıklama:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Zaman: Önceki Directions API sorgusundan gelir.
Yorumlar:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.Resimler: Yakındaki Arama'nın Sınırsız Önizlemesi (Yeni) API sırasında Yerler'i Ayrıntılar için
place.id
ile photo_reference daha sonra deneyiminizle ilgili her seferinde bir sorgu
İlişkili sorgu sayısı ve maliyet
- Haritalar JavaScript'i API: Deneyim yükleniyor 1 harita.
- Places Autocomplete API: Yazılan her karakter için 1 sorgu ( Otomatik tamamlama Widget) tıklayın. özelleştirilebiliyor.
- Yakında Arama (Yeni) API: Görüntülenen her 20 yerde 1 sorgu. Yere göre farklı faturalandırma veriler bilgileri de kapsayabilir.
- Yol tarifi API: Kullanıcı tarafından seçilen her yer için 1 sorgu.
- Yer Fotoğrafı API: Görüntülenen her fotoğraf 1 sorgu.
Sonuç
Yerel keşif deneyimi, kullanıcıya değer sunmanın etkili bir yoludur. Bu demo uygulamasında, bir sonraki aşamaya geldiğinizde ekleyebileceğiniz birçok Google Haritalar Platformu'nda özel olanaklarla böyle bir deneyim yaratmak Yakındaki Arama (Yeni) API'sinden ziyaret edin.
Sonraki Adımlar
Önerilen ek okuma:
- Haritalar JavaScript API'deki Web Bileşenleri
- Yerler Otomatik Tamamlama Optimizasyonu
- Diğer Rehber Hizmetleri
- Aşağıdan geri bildirim bırakın.
Katkıda bulunanlar
Ana yazarlar:
Thomas Anglaret | Google Haritalar Platform Çözümleri Mühendisi