Nearby Search (Yeni) API'siyle yerel keşfi iyileştirin

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 otel veya emlak ararken belirttiğiniz konumun yakınındaki önemli yerleri 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şimli deneyimi geliştirmek için farklı Google Haritalar Platformu ürünleri ve özellikleri sunulur.

Kullanım Alanları

Şimdi yerel keşif entegrasyonunun hangi unsurlarının kullanıcı değerini artırdığını anlayalım:

• Keşif: Çeşitli türlerde alakalı yerleri göstererek kullanıcılara tek bir konumun çevresinde neler olduğuna dair genel bir bakış sunun.

• Etkileşimli: Kullanıcıların bir yer seçmesine ve verileri dinamik olarak yenilemesine olanak tanır.

  göre değişir.

• Görselleştirme: Yer yorumları ve fotoğrafları sağlayın

  kullanıcıların ihtiyaçlarına uygun olup olmadığını hızlıca anlayabilmeleri için yürüyüş süresi ve mesafesi gibi bilgiler sağlar.

Referans Mimari

Yerel Keşif

Yerel 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, Google Haritalar Platformu API'leriyle teknik uygulamanın açıklamasının yanı sıra adım adım ayrılmış örnek uygulamayı bulabilirsiniz.

1. Otomatik Tamamlama ile Konum Arama

• Maps JavaScript API'yi yükleyin.
• Yerler Otomatik Tamamlama sorgusu gönderin veya haritada konum seçin.

2. Yakındaki Arama (Yeni) API'yi kullanarak yerel önemli yerleri gösterme

• 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, turistik_yer") dahil edebilirsiniz.
• Sonuçlar üzerinde daha fazla kontrol sahibi olmak için includedPrimaryTypes, excludedPrimaryTypes ö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.

Veri alanları istendiğinde otel rezervasyonu yapılırken örnek sorgu:

• Temel (displayName, types, openingHours, formattedAddress)
• İletişim (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ı 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. Dinamik Haritalar ve Directions API ile etkileşimli içerikler ekleme

• Directions API'yi sorgulayarak güncel bacak ve adım sayısı. * Bir sonraki bölümde zamanı kullanın.

4. Etkileşimden sonra bu yerin ayrıntılı bilgilerini gösterin

1. Açıklama: displayName, types, rating, userRatingCount, priceLevel.

   Zaman: Önceki Directions API sorgusundan gelir.

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

3. 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

• Maps JavaScript API: Deneyimin yüklenmesi sırasında 1 harita.
• Places Otomatik Tamamlama API: Her girilen karakter için 1 sorgu (Otomatik Tamamlama Widget'ı kullanılıyorsa) Bu API özelleştirilebilir.
• Yakındaki Yerler (Yeni) API: Gösterilen 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ı tarafından seçilen her yer için 1 sorgu.
• Place Photo API: Gösterilen her fotoğraf için 1 sorgu.

Sonuç

Yerel keşif deneyimi, kullanıcıya değer sunmanın etkili bir yoludur. Bu uygulamalı gösterimde, Google Haritalar Platformu'nda Yakında Arama (Yeni) API'sinden özel özellikler kullanarak bu tür bir deneyim oluştururken dahil edeceğiniz birçok özellik bulunmaktadır.

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 bildirimde bulunabilirsiniz.

Katkıda bulunanlar

Başlıca yazarlar:

Thomas Anglaret | Google Haritalar Platform Çözümleri Mühendisi