Genel bakış

Places Aggregate API, konum, tür, çalışma durumu, fiyat düzeyi ve kullanıcı puanları gibi ölçütlere göre belirli bir alandaki yerler hakkında analizler sağlayan bir hizmettir. Bu hizmet, belirli bir konumun çevresindeki belirli Yer Türlerinin yoğunluğunu analiz etmeye yardımcı olabilir ve "Bu konumun 5 km yarıçapında kaç tane 5 yıldızlı $$$ restoran var?" gibi soruları yanıtlayabilir.

Sonuçlar, ilgi alanındaki arama alanında toplu sayımlar veya tanımlanan yer kimlikleri olarak döndürülür. Kullanıcılar, bu yer kimlikleri hakkında daha fazla bilgi almak için Place Details API'yi kullanabilir.

Places Aggregate API'yi neden kullanmalısınız?

Places Aggregate API, kullanıcılarınızın çeşitli yerler hakkında sağladığınız kapsamlı bilgilere dayanarak veriye dayalı kararlar almasını sağlar. Aşağıdaki temel kullanım alanlarını destekleyen doğru ve güncel yer modellerinden yararlanır:

  • İşletmeler: Rekabeti ve yeni şubeler için potansiyel konumları analiz edin.
  • Geliştiriciler: Kişiselleştirilmiş öneriler sunan uygulamalar geliştirin.
  • Araştırmacılar: Belirli alanlardaki trendleri ve kalıpları inceleyin.

Places Aggregate API ile yapabilecekleriniz

Places Aggregate API ile aşağıdaki bilgileri edinebilirsiniz:

  • Sayılar: Ölçütlerinize uyan yerlerin sayısını alın.
  • Yer kimlikleri: Ölçütlerinize uyan belirli yerlerin yer kimliklerini alın.

Ayrıca, yer türleri, çalışma saatleri, fiyat düzeyleri ve müşteri puanları gibi çeşitli özelliklere göre aramanızı daraltmak için filtreleme de kullanabilirsiniz.

Örnekler

Bu bölümde, Places Aggregate API'nin kullanım alanlarıyla ilgili örnekler açıklanmakta ve her örnek için çalışan kodlar yer almaktadır.

Yeni bir kafe açma

Bir restoran sahibi yeni bir kafe açmak istiyor. Bunu yapmak için öncelikle kafelerin yoğun olduğu noktaları görselleştirmek istiyorlar. Böylece, işletme kararlarını şekillendirmek için yüksek ve düşük yoğunluklu alanları belirleyebiliyorlar. Places Aggregate API, bir sonraki konumun nerede açılacağına dair verilere dayalı bir karar vermek için belirli bir yarıçaptaki kafelerin sayısını işletme durumu, fiyat seviyeleri ve müşteri puanları gibi özelliklere göre analiz etmeye yardımcı olabilir.

Örneği görüntüleyin

San Francisco haritası ve posta koduna göre eğlence puanları.

Gayrimenkul yatırım şirketi

Bir gayrimenkul yatırım firması, finansal modellerini geliştirmek ve planlanan mülk yatırımlarının YG'sini doğru bir şekilde belirlemek istiyor. Places Aggregate API'yi kullanarak potansiyel yatırım mülklerinin yakınındaki olanaklar (ör. ATM'ler, hastaneler, toplu taşıma istasyonları ve marketler) hakkında ayrıntılı veriler toplayabilirler. Böylece potansiyel yatırım mülklerinin yakınındaki olanakları anlayabilirler.

Perakende teslimat hizmeti

Yeni bir şehre açılırken perakende teslimat hizmeti, restoranlar, marketler ve içki dükkanları gibi popüler tüketici noktalarının yoğunluğuna göre bir bölgeye atanacak teslimat sürücülerinin sayısını belirlemelidir. Teslimat hizmeti, API'yi kullanarak şehirdeki bu tür işletmelerin toplam sayısını belirler. Böylece kaynakları etkili bir şekilde planlayıp tahsis edebilir.

Örneği görüntüleyin

Mountain View'daki restoranların hacme göre ısı haritası.

Places Aggregate API'nin işleyiş şekli

Places Aggregate API, arama ölçütlerinizi daraltmak için filtreler belirtmenize olanak tanır. INSIGHT_COUNT veya INSIGHT_PLACES Analiz Türü'nü seçtikten sonra aşağıdakiler de dahil olmak üzere filtre ölçütleri ekleyebilirsiniz:

  • Konum: Daireler, bölgeler veya özel çokgenler kullanarak ilgi alanını tanımlayın.
  • Tür: İlgilendiğiniz yer türlerini belirtin.
  • Çalışma durumu: Yerleri çalışma durumlarına göre filtreleyin.
  • Fiyat düzeyleri: Yerleri fiyat düzeylerine göre filtreleyin.
  • Puanlar: Yerleri kullanıcı puanlarına göre filtreleyin.

API yanıtı ComputeInsightsResponse nesnesi, istek analizi sonuçlarını içerir. Örneğin, INSIGHT_COUNT seçtiyseniz yanıtta toplam yer sayısı, INSIGHT_PLACES seçtiyseniz yanıtta yer kimliklerinin listesi yer alır.

Places Aggregate API'yi kullanma

1 Ayarları yapın. Google Cloud projenizi ayarlayarak başlayın ve sonraki talimatları uygulayın.
2 Eşleşen yerlerin sayısını almak için istekte bulunun. İlk isteğinizi gönderme başlıklı makaleyi inceleyin.
3 İstek parametreleri hakkında bilgi edinin. İstek parametreleri başlıklı makaleyi inceleyin.

Sırada ne var?