Bu belgede, basit ve uygun maliyetli bir uygulama geliştirmek için Yakındaki Arama (Yeni) API'sinin nasıl kullanılacağını
yerel keşif deneyimi.
Yerel keşif deneyimi, otel veya emlak ararken belirttiğiniz konumun yakınındaki önemli yerleri kullanıcılara gösterir. Genellikle, yer seçici ve fotoğraflardan oluşan bir galeri içeren ek bir panel içeren etkileşimli bir haritadan oluşur. Etkileşimle ilgili deneyimi geliştirmek için farklı Google Haritalar Platformu ürünleri ve özellikleri sunulacak.
Kullanım Alanları
Şimdi, yerel keşif entegrasyonunun hangi öğelerinin kullanıcı değerini artırdığını anlayalım:
Keşif: Çeşitli türlerdeki alakalı yerleri göstererek kullanıcılara tek bir konumun çevresinde neler olduğuna dair genel bakış sunun.
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
kullanıcıların ihtiyaçlarına uygun olup olmadığını hızlıca anlayabilmeleri için yürüme süresi ve mesafesi gibi bilgiler sağlar.
Referans Mimari
Yerel Keşif
Yerel bir keşif deneyimi oluşturmanın birçok yolu vardır. Aşağıdaki entegrasyon, bilinen Google Haritalar Platformu API'lerinden ve heyecan verici yeni özelliklerden yararlanan bir kullanıcı deneyimine özel bir örnektir. Yerel keşif için şablonlu bir yaklaşım kullanmak isterseniz Web Bileşenleri'ni kullanabilirsiniz.
Örnek Uygulama
Örnek Adım Adım Açıklamalı Kılavuz
Aşağıdaki tabloda, Google Haritalar Platformu API'leri ile teknik uygulamanın açıklamasıyla birlikte adımlara ayrılmış örnek uygulamayı bulabilirsiniz.
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
; otelseniz "konaklama" türünü hariç tutabilir ve yalnızca uygun türleri (ör. "restoran, kafe, park, turit_attraction") ekleyebilirsiniz.- Sonuçlar üzerinde daha fazla kontrol için
includedPrimaryTypes
veexcludedPrimaryTypes
özelliklerinden yararlanın. - Yetersiz sonuç sayısını veya çok uzaktaki yerleri önlemek için "locationrestriction" (konum kısıtlaması) özelliği; SIFIR sonuç elde edildiğinde, sonuçları görüntülemeden önce daire / dikdörtgen boyutunu genişletin.
İ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
- Directions API'yi sorgulayarak güncel bacak ve adımlar. * 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
.Görseller: Yakındakilerde Arama (Yeni) API'sinin Sınırsız Önizlemesi sırasında, photo_reference ve ardından deneyiminiz sırasında bir seferde bir sorgu göndermek için
place.id
ile Yer Ayrıntıları'nı sorgulamanız gerekir
İlişkili sorgu sayısı ve maliyet
- Haritalar JavaScript API'si: Deneyim yüklenirken 1 harita.
- Yerler Otomatik Tamamlama API'si: Girilen her karakter için 1 sorgu (Otomatik Tamamlama Widget'ı kullanılıyorsa) özelleştirilebilir.
- Yakındakilerde Arama (Yeni) API: Görüntülenen her 20 yer için 1 sorgu. Sorgu yanıtının parçası olan Yer verilerine göre farklı faturalandırma.
- Directions API: Kullanıcının seçtiği her yer 1 sorgudur.
- Place Photo API: Görüntülenen her fotoğraf için 1 sorgu.
Sonuç
Yerel keşif deneyimi, kullanıcıya değer sunmanın etkili bir yoludur. Bu gösterim uygulamasında, Google Haritalar Platformu'nda Yakındaki Arama (Yeni) API 'sindeki özel olanaklarla böyle bir deneyim oluştururken ekleyebileceğiniz birçok özellik bulunmaktadır.
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.
Katılımcılar
Ana yazarlar:
Thomas Anglaret | Google Haritalar Platform Çözümleri Mühendisi