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

Bu belgede, basit ve uygun maliyetli bir uygulama geliştirmek için Yakındaki Arama (Yeni) API'sinin nasıl kullanılacağını

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, yer seçici ve fotoğraflardan oluşan bir galeri içeren ek bir panel içeren etkileşimli bir haritadan oluşur. Etkileşimle ilgili deneyimi geliştirmek için farklı Google Haritalar Platformu ürünleri ve özellikleri sunulacak.

örnek yerel keşif

Kullanım Alanları

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

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

  • Etkileşim: Kullanıcılara bir yer seçmeleri ve verileri dinamik olarak yenilemeleri için destek olun.

    göreceli olarak ortaya koyar.

  • Görselleştirme - Yerlerle ilgili yorumlar, fotoğraflar sağlayın

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

Referans Mimari

alt_text

Yerel Keşif

Yerel bir keşif deneyimi oluşturmanın birçok yolu vardır. Aşağıdaki entegrasyon, bilinen Google Haritalar Platformu API'lerinden ve heyecan verici yeni özelliklerden yararlanan bir kullanıcı deneyimine özel bir örnektir. Yerel keşif için şablonlu bir yaklaşım kullanmak isterseniz Web Bileşenleri'ni kullanabilirsiniz.

Örnek Uygulama

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

Aşağıdaki tabloda, Google Haritalar Platformu API'leri ile teknik uygulamanın açıklamasıyla birlikte adımlara ayrılmış örnek uygulamayı bulabilirsiniz.

1. AutocompleteSearch konum bilgisiyle Konum Arama

  • Haritalar JavaScript API'sini yükleyin.
  • Yerler Otomatik Tamamlama sorgusunu sorgulayın veya haritadan bir konum seçin.

örnek otomatik tamamlama

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

  • 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, turit_attraction") ekleyebilirsiniz.
  • Sonuçlar üzerinde daha fazla kontrol için includedPrimaryTypes ve 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.

yakındaki yerleri örnekle

İstenen veri alanları ile otel rezervasyonu yaparken sorgu örneği:

  • Temel (displayName, types, openingHours, formattedAddress)
  • Kişi (websiteUri, nationalPhoneNumber, internationalPhoneNumber)
  • Tercih edilir (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. Dynamic Maps and Directions API ile etkileşim ekleyin

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

örnek talimatlar

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. Görseller: Yakındakilerde Arama (Yeni) API'sinin Sınırsız Önizlemesi sırasında, photo_reference ve ardından deneyiminiz sırasında bir seferde bir sorgu göndermek için place.id ile Yer Ayrıntıları'nı sorgulamanız gerekir

yer ayrıntıları

İlişkili sorgu sayısı ve maliyet

Sonuç

Yerel keşif deneyimi, kullanıcıya değer sunmanın etkili bir yoludur. Bu gösterim uygulamasında, Google Haritalar Platformu'nda Yakındaki Arama (Yeni) API 'sindeki özel olanaklarla böyle bir deneyim oluştururken ekleyebileceğiniz birçok özellik bulunmaktadır.

Sonraki adımlar

Önerilen ek okuma:

Katılımcılar

Ana yazarlar:

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