Yer sayısı işlevlerini kullanarak veri kümesini sorgulama

Yer sayısı işlevleri, BigQuery'de çalışan ve veri kümesini doğrudan sorgulamayı tamamlayan önceden tanımlanmış SQL sorgularıdır. Verilere doğrudan sorgu gönderme ile işlev kullanma arasındaki temel fark, işlevlerin minimum sayı eşiği uygulamaması ancak bunun yerine minimum arama alanı uygulamasıdır:

• Yer veri kümeleri sorguları yalnızca 5 ve üzeri 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 arama alanı 40,0 metreye 40,0 metre (1.600 m²) olmalıdır. İşlevler, tek tek yerler hakkında bilgi aramak için kullanılabilecek yer kimlikleri de döndürebilir.

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. Sonuçlarınızı kontrol etmek için tek tek yer bilgisi almanız gerektiğinde de bu araçtan yararlanabilirsiniz.

Yer Sayısı işlevleri yalnızca sayı sağlar. Bu nedenle, veri birleştirme gibi daha karmaşık sorgular yapmanız veya bir grup yerin ortalama puanı gibi ek analizler almanız gerekiyorsa veri kümesini doğrudan sorgulayın.

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. Tüm filtre parametrelerini inceleyin.

Yer kimlikleri şu durumlarda kullanılabilir:

• Places API (Yeni)
• Geocoding API
• Places UI Kit

Not: Yer sayısı işlevlerine, aynı şehirler ve ülkeler için erişebilirsiniz.

Fonksiyonlarla sorgu yazma

İşlevleri çağırmak için şu biçimi kullanın: [project name (optional)].[table name].[function name].

Places Insights'ı ayarlarken bağlı veri kümesinin adını değiştirdiyseniz burada listelenen varsayılan tablo adları yerine özel adınızı kullanın. İsteğe bağlı olarak proje adınızı da ekleyebilirsiniz. Biri dahil edilmezse sorgu varsayılan olarak etkin projeye yönlendirilir.

Örneğin:

PROJECT_NAME.places_insights___us.PLACES_COUNT

İşleve bağımsız değişkenler iletmek için JSON_OBJECT kullanın.

Not: Yer sayısı işlevi kullandığınızda işlev, FROM ifadesinde belirtilir ve WITH_AGGREGATION_THRESHOLD atlanır.

Sonuçlarınızı filtreleme

Yer sayısı işlevleri, aramanızı daraltmak için birçok filtreyi destekler. Bu parametreler (örneğin, price_level veya types) büyük/küçük harfe duyarlıdır ve parametre adlarıyla tam olarak eşleşmelidir. Seçeneklerin tam listesi için filtre parametreleri referansına bakın.

Sonraki örnekte, aramayı minimum kullanıcı puanı, fiyat düzeyi, işletme durumu ve restoranda köpek kabul edilip edilmediğine göre sınırlamak için filtreler uyguluyorsunuz:

SELECT `PROJECT_NAME.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;

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

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

Aşağıdaki örnekte, New York City'deki Empire State Binası'nın 1.000 metre yarıçapındaki çalışan restoranların sayısını döndürmek için PLACES_COUNT işlevi kullanılmaktadır:

SELECT `PROJECT_NAME.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;

Yanıtta tek bir sayı yer alıyor:

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, arama yapılacak nokta etrafındaki arama yarıçapını ve yer türünü ("restaurant") de 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ıta dahil edilen yerler için 250'ye kadar yer kimliği döndürür.

Örneğin, PLACES_COUNT_PER_TYPE işlevi, yer türüne göre 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ı, türleri restaurant, cafe ve bar olan yerlerin sayısını döndürür:

SELECT * FROM `PROJECT_NAME.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.

Not: Bir yer hakkında bilgi edinmek için Places API veya Places UI Kit'i çağırmak üzere yer kimliğini kullanın. Örnek yer kimliklerini kullanarak Places Insights verilerini doğrulama başlıklı makalede bir örnek verilmiştir.

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 bölümüne bakın. 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, markalara, elektrikli araç şarjı seçeneklerine veya adres bileşenine göre filtreleme desteklenmez.
• Yalnızca abone olduğunuz şehir ve ülkeler için yer sayısı işlevlerine erişebilirsiniz. Veri kümesine erişim için Places Insights'ı ayarlama başlıklı makaleyi inceleyin.
• Filtre parametreleri (örneğin, geography veya types) büyük/küçük harfe duyarlıdır ve parametre adlarıyla tam olarak eşleşmelidir. Aksi takdirde sorgu başarısız olur.