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

Bu belgede, Nearby Search (New) API 'yi kullanarak basit ve uygun maliyetli

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 etkileşimli bir haritadan oluşur ve ek olarak yer seçici ve fotoğraf galerisi içeren bir panel bulunur. Etkileşimli deneyiminizi geliştirmek için farklı Google Haritalar Platformu ürünleri ve yetenekleri sunulacaktır.

örnek yerel keşif

Kullanım Alanları

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

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

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

    o yere göre.

  • Görselleştirme - Yer incelemeleri ve fotoğraflar sağlayın

    ve kullanıcıların ihtiyaçlarına uygun olup olmadığını hızlıca anlamaları için yürüme süresi ve mesafesi.

Referans Mimari

alt_text

Yerel Keşif

Yerel bir keşif deneyimi yaratmanı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 bir örneğidir. Yerel keşfe şablon tabanlı bir yaklaşım uygulamak istiyorsanız Web Bileşenleri'ni kullanabilirsiniz.

Örnek Uygulama

Örnek Adım Adım Açıklamalı Kılavuz

Aşağıdaki tabloda, örnek uygulamanın adımlara ayrılmış halini ve Google Haritalar Platformu API'leriyle teknik uygulamanın açıklamasını bulabilirsiniz.

1. Otomatik Tamamlama ile Konum AramaKonumu ara

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

örnek otomatik tamamlama

2. Nearby Search (New) API'yi kullanarak yerel ilgi çekici yerleri gösterin

  • Popülerlik sıralaması (daha alakalı sonuçlar) veya mesafe sıralaması.
  • includedTypes, excludedTypes ; otel sahibiyseniz "konaklama" türünü hariç tutabilir ve yalnızca uygun türleri (ör. "restoran, kafe, park, turistik_yer") dahil edebilirsiniz.
  • Sonuçlar üzerinde daha da fazla kontrol sahibi olmak için includedPrimaryTypes ve excludedPrimaryTypes özelliklerinden yararlanın.
  • Yetersiz sayıda sonuç veya çok uzak yerleri önlemek için "locationRestriction" parametresini kullanın. Sıfır sonuç olması durumunda, sonuçları göstermeden önce daire / dikdörtgen boyutunu genişletin.

örnek yakındaki yerler

İstenen veri alanlarıyla otel rezervasyonu yaparken kullanılan örnek sorgu:

  • Basic (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 } } }

İstenen veri alanlarıyla emlak ararken sorgu örneği:

  • Basic (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şim ekleme

  • Directions API'yi sorgulayarak ayak ve adımlarla ilgili güncel bilgileri alın. * Bir sonraki bölümde zamanı kullanın.

örnek talimatlar

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

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

    Süre: Ö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, place.id ile Yer Ayrıntıları sorgusu göndermeniz gerekir. Böylece photo_reference elde edip deneyiminizde bunları tek tek sorgulayabilirsiniz.

yer ayrıntıları

Sorgu sayısı ve ilişkili maliyet

Sonuç

Yerel keşif deneyimi, kullanıcılara değer sunmanın etkili bir yoludur. Bu gösterim uygulamasında, Yakında Arama (Yeni) API 'nin özel özellikleriyle Google Haritalar Platformu'nda bu tür bir deneyim oluştururken kullanacağınız birçok özellik bulunur.

Sonraki Adımlar

Daha fazla bilgi için önerilen kaynaklar:

Katkıda bulunanlar

Başlıca yazarlar:

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