Bu belgede, Etrafımda Arama (Yeni) API 'sini kullanarak basit ve uygun maliyetli bir API'yi nasıl kullanacağınızı öğreneceksiniz.
çok önemli.
Yerel keşif deneyimi, kullanıcılara otel veya emlak ararken belirttiğiniz bir konumun yakınındaki önemli yerleri gösterir. Genellikle etkileşimli bir haritadan oluşur. Ek bir panel, bir yer seçici ve bir fotoğraf galerisi içerir. Etkileşim deneyimini geliştirecek farklı Google Haritalar Platformu ürünleri ve özellikleri sunulur.
Kullanım Alanları
Şimdi de yerel keşif entegrasyonunun hangi öğelerinin kullanıcı değerini artırdığını inceleyelim:
Keşif: Çeşitli türlerdeki alakalı yerleri göstererek kullanıcılara tek bir konumun etrafında neler olduğuna dair genel bir bakış sunun.
Etkileşim: Kullanıcılara bir yer seçme ve verileri dinamik olarak yenileme konusunda destek olun
bir kontrol noktası görevi görebilir.
Görselleştirme - Yerlerle ilgili yorumlar, fotoğraflar sağlayın
kolayca anlayabilmesi için yürüme süresi ve mesafeyi temel ekleyin.
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'lerinden ve bazı heyecan verici yeni özelliklerden yararlanan bir kullanıcı deneyimine özel örnek olarak verilmiştir. Yerel keşif için şablonlu bir yaklaşım 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 bir açıklamasıyla birlikte adımlara ayrılmış örnek uygulamayı bulabilirsiniz.
1. AutocompleteSearch konumuyla Konum Arama
- Haritalar JavaScript API'sini yükleyin.
- Yerler Otomatik Tamamlama sorgusuna ilişkin soruları yanıtlayın veya haritadaki bir konumu seçin.
2. Yakında Arama (Yeni) API'sini kullanarak yerel önemli noktaları bulun
- 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, tourit_attraction") dahil edebilirsiniz.- Sonuçlar üzerinde daha da fazla kontrole sahip olmak için
includedPrimaryTypes
veexcludedPrimaryTypes
yararlanın. - "Yeterli sayıda sonuç olmamasını veya çok uzaktaki yerleri önlemek için locationRestriction ; SIFIR sonuç olması durumunda, sonuçları görüntülemeden önce daire / dikdörtgen boyutunu genişletin.
İstenen veri alanları ile otel rezervasyonu yaparken sorgu örneği:
- Temel (
displayName
,types
,openingHours
,formattedAddress
) - Kişi (
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ı ile bir emlak 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 ve Directions API'si ile etkileşim ekleyin
- Directions API'yi sorgulayarak ayak ve adımları güncelleyin. * Sonraki bölümde zaman kullanın.
4. Etkileşimin ardından yer hakkında ayrıntılı bilgiler göstermek
Açıklama:
displayName
,types
,rating
,userRatingCount
,priceLevel
.Zaman: Önceki Directions API sorgusundan gelir.
Yorumlar:
reviews[i].author
,reviews[i].rating
,reviews[i].text
.Resimler: Yakındaki Arama (Yeni) API'sinin Sınırsız Önizlemesi (Yeni) API'si sırasında Yer Ayrıntıları'nı
place.id
ile sorgulamanız gerekir. Böylece photo_reference. Daha sonra deneyiminizde tek tek sorgulama yapabilirsiniz.
Sorgu sayısı ve ilişkili maliyet
- Haritalar JavaScript API'si: Deneyim yüklenirken 1 harita.
- Yerler Otomatik Tamamlama API'si: Girilen her karakter için 1 sorgu (Otomatik Tamamlama Widget'ı kullanılıyorsa) özelleştirilebilir.
- Yakındaki Arama (Yeni) API'si: Görüntülenen 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 gönderilir.
- Place Photo API: Görüntülenen her fotoğrafa 1 sorgu gönderilir.
Sonuç
Yerel keşif deneyimi, kullanıcılara değer sunmanın etkili bir yoludur. Bu tanıtım uygulamasında, Google Haritalar Platformu'nda Yakındaki Arama (Yeni) API 'sinin özel özellikleri ile böyle bir deneyim oluştururken dahil edebileceğiniz birçok özellik vardır.
Sonraki adımlar
Önerilen daha fazla bilgi:
- Haritalar JavaScript API'sindeki Web Bileşenleri
- Yerler Otomatik Tamamlama Optimizasyonu
- Diğer Yer Hizmetleri
- Aşağıda geri bildirim bırakın.
Katılımcılar
Baş yazarlar:
Thomas Anglaret | Google Haritalar Platformu Çözüm Mühendisi