Bu belgede, Yakındakiler Arama (Yeni) API'yi kullanarak basit ve uygun maliyetli
yerel keşif deneyimi sunar.
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 yürüyüş süresi ile mesafesini göstererek kullanıcıların ihtiyaçlarına uygun olup olmadığını hızlıca anlamalarını sağlayın.
Referans Mimari
Yerel Keşif
Yerel bir keşif deneyimi oluşturmanın birçok yolu vardır. Aşağıdaki entegrasyon, iyi bilinen Google Maps Platform API'lerinin yanı sıra bazı heyecan verici yeni özelliklerden yararlanan bir kullanıcı deneyiminin özel örneğidir. Yerel keşif için şablonlu bir yaklaşım kullanmak istiyorsanız Web Bileşenleri'ni kullanabilirsiniz.
Ö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
- Maps JavaScript API'yi yükleyin.
- Yerler Otomatik Tamamlama sorgusu yapın veya haritada 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
; Otelseniz "konaklama" türünü hariç tutabilir ve yalnızca uygun türleri (ör. "restoran, kafe, park, tourist_attraction") dahil edebilirsiniz.- Sonuçlar üzerinde daha fazla kontrol sahibi olmak için
includedPrimaryTypes
,excludedPrimaryTypes
özelliklerinden yararlanın. - 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.
Veri alanları istendiğinde otel rezervasyonu yapılırken kullanılan sorgu örneği:
- Temel (
displayName
,types
,openingHours
,formattedAddress
) - Kişi (
websiteUri
,nationalPhoneNumber
,internationalPhoneNumber
) - Tercih edilen (
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ı istendiğinde emlak ararken kullanılan 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. Dinamik Haritalar ve Directions API ile etkileşimli içerikler ekleme
- Sorgulayarak bacak ve adımlar güncelYol tarifi API. * Bir sonraki bölümde zamanı kullanın.
4. Etkileşimde bulunulduğunda yerle ilgili ayrıntılı bilgileri gösterme
Açıklama:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Saat: Önceki Directions API sorgusundan gelir.
Yorumlar:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.Resimler: Yakındaki Arama (Yeni) API'sinin Sınırsız Önizlemesi sırasında, photo_reference değerini almak için
place.id
ile PlacesDetails'i sorgulamanız ve ardından deneyiminizde tek tek sorgu yapmanız gerekir.
Sorgu sayısı ve ilişkili maliyet
- Haritalar JavaScript'i API: Deneyim yükleniyor 1 harita.
- Places Autocomplete API: Her girilen karakter için 1 sorgu (Otomatik Tamamlama Widget'ı kullanılıyorsa) Bu API özelleştirilebilir.
- Yakında Arama (Yeni) API: Görüntülenen her 20 yerde 1 sorgu. Yere göre farklı faturalandırma veriler bilgileri de kapsayabilir.
- Directions 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ılara değer sunmanın güçlü 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:
- Maps JavaScript API'deki Web Bileşenleri
- Yerler Otomatik Tamamlama Optimizasyonu
- Diğer Yerler Hizmetleri
- Aşağıdan geri bildirim bırakın.
Katkıda bulunanlar
Ana yazarlar:
Thomas Anglaret | Google Haritalar Platform Çözümleri Mühendisi