Yer sayısı işlevlerine genel bakış

Yer sayısı işlevleri, Places Analizleri'nde bulunan Yerler verilerini sorgulamanın başka bir yoludur. Bu işlevler, BigQuery'de çalışan ve yer verileri sorgularını tamamlayan önceden tanımlanmış SQL sorgularıdır. Aradaki temel fark, işlevlerin minimum sayı eşiği uygulamaması, bunun yerine minimum arama alanı uygulamasıdır:

• Yer veri kümeleri sorguları yalnızca 5'ten büyük sayıları döndürebilir ancak arama alanının boyutuyla ilgili herhangi bir sınırlama uygulamaz.

• Yer sayısı işlevleri, 0 dahil olmak üzere herhangi bir sayıyı döndürebilir ancak minimum 40,0 metreye 40,0 metre (1.600 m²) arama alanı zorunluluğu vardır.

Bir sorgu sonuç döndürmediğinde bunu bilmek önemliyse veya 5'ten az yer sayısını bilmeniz gerekiyorsa yer sayısı işlevlerini kullanmak isteyebilirsiniz. Örneğin, düşük sayıları döndürebilmek site seçimi kullanım alanları için önemlidir.

Desteklenen yer sayısı işlevleri ve ülkeler

Places Insights aşağıdaki işlevleri destekler:

• PLACES_COUNT: Yerlerin sayısını içeren tek bir satır döndürür.
• PLACES_COUNT_PER_TYPE: Yer türüne göre yer sayısı içeren bir BigQuery tablosu döndürür.
• PLACES_COUNT_PER_GEO: Coğrafyalara göre yer sayısı içeren bir BigQuery tablosu döndürür.
• PLACES_COUNT_PER_H3: H3 hücresi başına yer sayısı içeren bir BigQuery tablosu döndürür.

Yer sayılarının yanı sıra PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO ve PLACES_COUNT_PER_H3 işlevleri de yanıtın her öğesi için en fazla 250 yer kimliği döndürür.

Yer veri kümelerine benzer şekilde, desteklenen ülkelerin her biri için en iyi şehirde yer sayısı işlevleri kullanılabilir. Örneğin, Avustralya için Avustralya'nın Sidney şehrindeki yer sayısı işlevlerine erişebilirsiniz.

Not: Örnek veri kümesi erişimi için abone olduğunuz şehir ve ülkelerde yer sayısı işlevlerine erişebilirsiniz.

Desteklenen şehirlerin ve ülkelerin tam listesi için BigQuery'deki referans yer sayısı işlevleri başlıklı makaleyi inceleyin.

Yer sayısı işlevi örneği

Aşağıdaki örnekte, New York City'deki Empire State Binası'na 1.000 metre mesafede bulunan ve hizmet veren restoranların sayısını döndürmek için PLACES_COUNT işlevi kullanılmaktadır:

SELECT `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

Not: Genellikle OPERATIONAL işletmelerin sayısını aldığınızdan emin olmak için business_status filtresini eklersiniz. Aksi takdirde, sayımlara kapalı işletmeler de dahil edilir.

Yanıtta tek bir sayı var:

Bu örnekte SELECT ifadesi, şu söz dizimini kullanarak ABD için PLACES_COUNT işlevine referans veriyor:

maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT

Desteklenen şehirlerin ve ülkelerin tam listesi için BigQuery'deki referans yer sayısı işlevleri başlıklı makaleyi inceleyin.

İşleve bağımsız değişkenler iletmek için JSON_OBJECT kullanın. Bu örnekte, bir noktadan GEOGRAPHY değeri döndürmek ve bu değeri geography parametresine iletmek için BigQuery ST_GEOGPOINT işlevi kullanılmaktadır. Ayrıca, aranacak yer türü "restaurant" ile birlikte noktanın etrafındaki arama yarıçapını da iletir.

Not: Gerekli ve isteğe bağlı parametreler, filtreler bölümünde açıklandığı gibi her yer sayısı işlevi için farklıdır.

Tür, coğrafya veya H3 örneği başına yer sayısı

Yer sayılarıyla birlikte PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO ve PLACES_COUNT_PER_H3 işlevleri de yanıtta yer alan yerler için 250'ye kadar yer kimliği döndürür.

Örneğin, PLACES_COUNT_PER_TYPE işlevi, yer türü başına yer sayısı tablosunu döndürür. Yanıt, her türe uyan yerlerin yer kimliklerinden oluşan bir dizi içerir. Döndürülen yer kimliklerini kullanarak her yerle ilgili bilgileri arayabilirsiniz.

Aşağıdaki işlev çağrısı, restaurant, cafe ve bar türlerine sahip yerlerin sayısını döndürür:

SELECT * FROM `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

Bu işlev, type, count ve sample_place_ids olmak üzere üç sütunlu bir tablo döndürür. count sütunlarında her bir type için yer sayısı, sample_place_ids sütununda ise her bir type için en fazla 250 yer kimliği gösterilir.

İşleve filtre uygulama

Arama ölçütlerinizi daraltmak için filtreler uygulayın. Yer sayısı işlevleri, aramanızı daraltmak için birçok filtreyi destekler. Aşağıdaki örnekte, aramayı minimum kullanıcı derecelendirmesi, fiyat düzeyi, işletme durumu ve restoranın köpeklere izin verip vermediğine göre sınırlamak için filtreler uyguluyorsunuz:

SELECT `maps-platform-analytics-hub.sample_places_insights_us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

Sonuçları görselleştirme

BigQuery verilerinizdeki analizleri keşfetmenize yardımcı olmak için analiz ve iş zekası araçları çok önemlidir. BigQuery, Places Insights verilerindeki işlevlerinizin sonuçlarını analiz etmek için kullanabileceğiniz çeşitli Google ve üçüncü taraf veri görselleştirme araçlarını destekler.

Bir işlevin sonuçlarını görselleştirme örneği için Sonuçları görselleştirme başlıklı makaleyi inceleyin. Yer İşletmeleri Analizleri sonuçlarını görselleştirme hakkında daha fazla bilgi ve örnek için Sorgu sonuçlarını görselleştirme başlıklı makaleyi inceleyin.

Sınırlamalar ve şartlar

Yer sayısı işlevleriyle ilgili sınırlamalar ve şartlar aşağıda belirtilmiştir:

• Yalnızca COUNT analizleri desteklenir.
• Minimum 40,0 metreye 40,0 metre (1.600 m²) arama alanı gereklidir.
• Yer işlevi sayısı parametre giriş boyutu 1 MB ile sınırlıdır.
• Yer kimliğine veya adres bileşenine göre filtreleme desteklenmez.

Yer sayısı işlevlerini ve yer veri kümesi sorgularını karşılaştırma

Aşağıdaki tabloda temel farklılıklar listelenmiştir:

	Yer sayısı işlevleri	Yer veri kümesi sorguları
Arayüz	COUNT analizleri oluşturan dört önceden tanımlanmış SQL işlevi: tek sayı, türe göre sayı, coğrafi konuma göre sayı, H3 hücresine göre sayı.	COUNT, COUNT_IF, SUM ve AVG. gibi toplama işlevlerini çalıştırmak için SQL kullanılır. JOIN, GROUP BY, WHERE ve diğer işlevler kullanılarak ek analizler oluşturulabilir.
Kısıtlamalar	40,0 metreye 40,0 metre (1.600 m^2) boyutlarında minimum arama alanı zorunlu kılar. Minimum arama alanı karşılandığı sürece, toplama sayısı 5'ten az olsa bile bir işlev sonuç döndürür.	5 öğelik bir sayı eşiği zorunlu kılınır ancak minimum arama alanı zorunlu kılınmaz.
Desteklenen özellik filtreleri	Aşağıdakiler hariç tam şema desteklenir: Yer id Adres bileşenleri	Tam şema desteklenir.
Avantajlar	Herhangi bir sayıyı döndürebilir. Performans ve düşük işleme maliyeti için optimize edilmiştir. Kullanımı basittir. Karmaşık sorgular yazmanıza gerek yoktur. Giriş parametrelerini doğrular ve hata döndürerek kullanmayı ve hata ayıklamayı kolaylaştırır.	Gelişmiş filtreleme ve birleştirme gibi karmaşık sorgulara olanak tanır. Minimum arama alanı zorunluluğu yoktur. COUNT dışında AVG, SUM ve GROUP BY gibi ek toplama işlevlerini destekler.

BigQuery'deki yer sayısı işlevlerine referans verme

Yer sayısı işlevleri aşağıdaki şehirleri ve ülkeleri destekler. Her şehre ve ülkeye ayrı ayrı abone olmanız gerekir.

Şehir, Ülke	Tablo adları
Sidney, Avustralya	maps-platform-analytics-hub.sample_places_insights_au.FUNCTION_NAME
Sao Paulo, Brezilya	maps-platform-analytics-hub.sample_places_insights_br.FUNCTION_NAME
Toronto, Kanada	maps-platform-analytics-hub.sample_places_insights_ca.FUNCTION_NAME
Paris, Fransa	maps-platform-analytics-hub.sample_places_insights_fr.FUNCTION_NAME
Berlin, Almanya	maps-platform-analytics-hub.sample_places_insights_de.FUNCTION_NAME
Londra, İngiltere	maps-platform-analytics-hub.sample_places_insights_gb.FUNCTION_NAME
Mumbai, Hindistan	maps-platform-analytics-hub.sample_places_insights_in.FUNCTION_NAME
Cakarta, Endonezya	maps-platform-analytics-hub.sample_places_insights_id.FUNCTION_NAME
Roma, İtalya	maps-platform-analytics-hub.sample_places_insights_it.FUNCTION_NAME
Tokyo, Japonya	maps-platform-analytics-hub.sample_places_insights_jp.FUNCTION_NAME
Mexico City, Meksika	maps-platform-analytics-hub.sample_places_insights_mx.FUNCTION_NAME
Madrid, İspanya	maps-platform-analytics-hub.sample_places_insights_es.FUNCTION_NAME
Zürih, İsviçre	maps-platform-analytics-hub.sample_places_insights_ch.FUNCTION_NAME
New York City, ABD	maps-platform-analytics-hub.sample_places_insights_us.FUNCTION_NAME