Genel bakış

Places Aggregate API, konum, tür, faaliyet 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 ve "Bu konumun 5 km yarıçapında kaç tane 5 yıldızlı $$$ restoran var?" gibi soruları yanıtlamaya yardımcı olabilir.

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 Yer Ayrıntıları API'si'ni 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. Bu özellik, doğru ve güncel yer modellerinden yararlanır. Bu modeller 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 oluşturun.
  • 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ına dair ö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ı belirleyebilecekler. 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ı, çalışma durumu, fiyat seviyeleri ve müşteri puanları gibi özelliklere göre analiz etmeye 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çılan bir perakende teslimat hizmetinin, restoranlar, marketler ve içki dükkanları gibi popüler tüketici yerlerinin yoğunluğuna göre bir bölgeye atanacak teslimat sürücülerinin sayısını belirlemesi gerekir. 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ü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: 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 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 ayarlama ile 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?