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. Bu sayfa 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 göstererek kullanıcıların ihtiyaçlarına uygun olup olmadığını hızlıca anlamalarını sağlayın.

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 yapın 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, turistik_yer") 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 ö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 bir emlak aranırken örnek sorgu:

  • 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

  • Yol Tarifi API'sini sorgulayarak güncel adım ve adımlar. * Sonraki bölümde zaman kullanın.

örnek yol tarifleri

4. Etkileşimde bulunulduğunda yerin ayrıntılı bilgilerini gösterme

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

    Saat: Önceki Directions API sorgusundan gelir.

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

  3. Resimler: Yakındaki Arama (Yeni) API'nin Sınırsız Önizlemesi sırasında, photo_reference aldıktan sonra deneyiminizde tek tek sorgulamak için place.id ile PlacesDetails'i sorgulamanı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