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ılar 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. Doğru ve güncel yer modellerinden yararlanarak aşağıdaki temel kullanım alanlarını destekler:

  • İş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, aramanızı yer türleri, çalışma saatleri, fiyat düzeyleri ve müşteri puanları gibi çeşitli özelliklere göre 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 yerleri 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 konumunuzu nerede açacağınıza dair verilere dayalı bir karar vermeniz için belirli bir yarıçaptaki kafelerin sayısını, çalışma durumu, fiyat seviyeleri ve müşteri puanları gibi özelliklere göre analiz etmenize yardımcı olabilir.

Örneği görüntüle

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ındaki YG'yi 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ı hesaplar. Böylece kaynakları etkili bir şekilde planlayıp tahsis edebilir.

Örneği görüntüle

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: İlgi alanını daireler, bölgeler veya özel poligonlar kullanarak tanımlayın.
  • Tür: İlgilendiğiniz yer türlerini belirtin.
  • İşletme durumu: Yerleri işletme 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 içgörüsünün 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 Kurulumu 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?