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 bir yer seçici ve fotoğraf galerisi içeren ek bir panelin yer aldığı 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

  ve yürüyüş süresi ile mesafesini ekleyerek kullanıcıların ihtiyaçlarına uygun olup olmadığını hızlıca anlayabilecekleri bir içerik oluşturabilirsiniz.

Referans Mimari

Yerel Keşif

Yerel keşif deneyimi oluşturmanın birçok yolu vardır. Aşağıdaki entegrasyon, iyi bilinen Google Haritalar Platformu 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, tourist_attraction") dahil edebilirsiniz.
• Sonuçlar üzerinde daha fazla kontrol sahibi olmak için includedPrimaryTypes, excludedPrimaryTypes özelliklerinden yararlanın.
• Yeterli sayıda sonuç elde edememeniz veya çok uzak yerlerle karşılaşmanız

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ı 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

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

4. Etkileşimde bulunulduğunda yerle ilgili ayrıntılı bilgileri gösterme

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: Deneyim yüklenirken 1 harita.
• Places Otomatik Tamamlama API'si: 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 bir 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ılara değer sunmanın güçlü 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 diğer kaynaklar:

• 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 Platformu Çözümleri Mühendisi