PLACES_COUNT_PER_GEO işlevi

Not: Çok daha iyi performans ve verimli toplu işleme için PLACES_COUNT_V2 kullanın.

PLACES_COUNT_PER_GEO işlevi, aranacak coğrafi alanların dizisini alır ve alan başına yer sayısını içeren bir tablo döndürür. Örneğin, arama alanı olarak bir posta kodu dizisi belirtirseniz yanıtta her posta kodu için ayrı bir satır içeren bir tablo bulunur.

PLACES_COUNT_PER_GEO işlevi bir tablo döndürdüğünden, bu işlevi FROM yan tümcesini kullanarak çağırın.

• Giriş parametreleri:

  • Zorunlu: Arama alanını belirten geographies filtre parametresi. geographies parametresi, noktaları, çizgi dizilerini ve poligonları destekleyen BigQuery GEOGRAPHY veri türü tarafından tanımlanan bir değer dizisi alır.

  • İsteğe bağlı: Aramanızı daraltmak için ek filtre parametreleri.

• Şunu döndürür:

  • Her coğrafi bölge için bir satır içeren tablo. Tabloda geography (GEOGRAPHY), count (INT64) ve place_ids (ARRAY<STRING>) sütunları bulunur. place_ids sütunu, her coğrafi bölge için en fazla 250 yer kimliği içerir.

Örnek: New York'un her ilçesindeki restoran sayısını hesaplama

Bu örnek, New York City'deki her ilçede faaliyet gösteren restoranların sayısını içeren bir tablo oluşturur.

Not: Yanıt tablosu bir geographies alanı içerdiğinden, BigQuery GEOGRAPHY türlerini destekleyen araçları kullanarak bu tabloyu görselleştirebilirsiniz. Bir işlevin sonuçlarını görselleştirme örneği için Sonuçları görselleştirme bölümüne bakın. Places Insights 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.

Bu örnekte, New York City'deki üç ilçenin ("Queens", "Kings", "New York") sınırlarını almak için ABD Nüfus Sayım Bürosu Verileri BigQuery herkese açık veri kümesi kullanılır. Her ilçenin sınırları county_geom sütununda yer alır.

Bu örnekte, county_geom tablosunun basitleştirilmiş bir sürümünü döndürmek için BigQuery ST_SIMPLIFY işlevi kullanılır. ST_SIMPLIFY işlevi, neredeyse düz kenar zincirlerini tek bir uzun kenarla değiştirir.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

Örnek: Markaya göre filtrelenmiş ilçe başına sayıları hesaplama

Aşağıdaki örnekte, Starbucks gibi belirli markaların yer sayılarını ve örnek yer kimliklerini almak için brand_ids filtresi kullanılmaktadır "1413758728321880760":

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ["OPERATIONAL"]
      )
);

Sonuçları görselleştirme

Aşağıdaki resimlerde, bu verilerin Looker Studio'da her bir ilçenin sınırlarını içeren dolgulu harita olarak gösterimi yer almaktadır:

Verilerinizi Looker Studio'ya aktarmak için:

1. Sonuçları oluşturmak için yukarıdaki işlevi çalıştırın.

2. BigQuery sonuçlarında Şurada aç -> Looker Studio'yu tıklayın. Sonuçlarınız otomatik olarak Looker Studio'ya aktarılır.

3. Looker Studio, varsayılan bir rapor sayfası oluşturur ve bu sayfayı sonuçların başlığı, tablosu ve çubuk grafiğiyle başlatır.

   

4. Sayfadaki her şeyi seçip silin.

5. Raporunuza dolu harita eklemek için Ekle -> Dolu harita'yı tıklayın.

6. Grafik türleri -> Kurulum bölümünde alanları aşağıda gösterildiği gibi yapılandırın:

   

7. Dolu harita yukarıdaki gibi görünür. Haritanın görünümünü daha ayrıntılı şekilde yapılandırmak için isteğe bağlı olarak Grafik türleri -> Stiller'i seçebilirsiniz.

Places Insights 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.