Bu belgede, basit ve uygun maliyetli bir uygulama oluşturmak için Yakında Arama (Yeni) API'sini nasıl kullanacağınızı öğreneceksiniz.
yerel keşif deneyimi sunar.
Yerel keşif deneyimi, otel veya gayrimenkul ararken belirttiğiniz bir konumun yakınındaki önemli yerleri kullanıcılara gösterir. Genellikle etkileşimli bir haritadan oluşur ve yer seçim aracı ile fotoğraf galerisi içeren ek bir panel bulunur. 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ı inceleyelim:
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ıyın.
göreceli olarak belirlenir.
Görselleştirme - Yerler hakkında yorum ve fotoğraf ekleme
ve yürüme süresi ile mesafesini göstererek ihtiyaçlarına uygun olup olmadığını hızlıca anlamalarını sağlıyoruz.
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 bir ö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, örnek uygulamanın adımlara ayrılmış halini ve Google Maps Platform API'leriyle teknik uygulamanın açıklamasını bulabilirsiniz.
1. Otomatik tamamlama ile konum aramaKonum arayın
- Maps JavaScript API'yi yükleyin.
- Yer Adı Otomatik Tamamlama sorgusu veya haritada konum seçme.

2. Yakında 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
includedPrimaryTypesveexcludedPrimaryTypeskullanın. - `locationRestriction: Yetersiz sayıda sonuç veya çok uzaktaki yerlerin gösterilmesini önlemek için kullanılır. SIFIR sonuç olması durumunda, sonuçları göstermeden önce daire / dikdörtgen boyutunu genişletin.

İstenen veri alanlarıyla otel rezervasyonu yaparken 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 } } }İstenen veri alanlarıyla gayrimenkul arama için ö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şim ekleme
- Directions API'yi sorgulayarak güncel bacak ve adımlar. * Sonraki bölümde zamanı kullanın.

4. Etkileşimde bulunulduğunda yerle ilgili ayrıntılı bilgileri gösterir.
Açıklama:
displayName,types,rating,userRatingCount,priceLevel.Time: Önceki Directions API sorgusundan alınır.
Yorumlar:
reviews[i].author,reviews[i].rating,reviews[i].text.Görseller: Yakında Arama (Yeni) API'nin kısıtlamasız önizlemesi sırasında, photo_reference değerini almak için Yer Ayrıntıları'nı
place.idile sorgulamanız ve ardından deneyiminizde tek tek sorgulamanız gerekir.

Sorgu sayısı ve ilişkili maliyet
- Maps JavaScript API: Deneyim yüklendiğinde 1 harita.
- Yer Adı Otomatik Tamamlama API'si: Yazılan her karakter için 1 sorgu (Otomatik Tamamlama Widget'ı kullanılıyorsa) özelleştirilebilir.
- Yakında Arama (Yeni) API: Gösterilen her 20 yer için 1 sorgu. Sorgu yanıtının 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örüntülenen her fotoğraf için 1 sorgu.
Sonuç
Yerel keşif deneyimi, kullanıcılara değer sunmanın etkili bir yoludur. Bu tanıtım uygulamasında, Yakında Arama (Yeni) API 'nin özel özellikleriyle Google Haritalar Platformu'nda böyle bir deneyim oluştururken kullanabileceğiniz birçok özellik bulunur.
Sonraki Adımlar
Önerilen ek kaynaklar:
- Maps JavaScript API'deki web bileşenleri
- Yer Adı Otomatik Tamamlama Optimizasyonu
- Diğer Places Services
- Aşağıdan geri bildirim gönderebilirsiniz.
Katkıda bulunanlar
Asıl yazarlar:
Thomas Anglaret | Google Haritalar Platformu Çözüm Mühendisi