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.

örnek yerel keşif

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 ekleyin. Böylece kullanıcılar, bu yerlerin ihtiyaçlarına uygun olup olmadığını hızlıca anlayabilir.

Referans Mimari

alt_text

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.

örnek otomatik tamamlama

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

örnek yakın yerler

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

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

örnek yol tarifleri

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.

yer ayrıntıları

Sorgu sayısı ve ilişkili maliyet

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:

Katkıda bulunanlar

Başlıca yazarlar:

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