Aylar arasındaki ÖY değişikliği sorgusu (PLACES_COUNT_CHANGE)

PLACES_COUNT_CHANGE işlevi, ilgi alanları sayısındaki değişiklikleri hesaplar ve birden fazla giriş coğrafyasında belirli iki ay arasında eklenen ve kaldırılan örnek yer kimliklerini alır.

PLACES_COUNT_V2 işlevi gibi bu işlev de coğrafi konumların giriş tablosu parametresini kabul ederek verimli toplu işleme için tasarlanmıştır. Bu sayede, birçok konumdaki büyüme trendlerini ve ticari değişimleri aynı anda değerlendirebilirsiniz.

Söz dizimi

SELECT *
FROM
  `PROJECT_NAME.LINKED_DATASET_NAME.PLACES_COUNT_CHANGE`(
    TABLE input_geographies,
    filters
  );

Parametreler

  • PROJECT_NAME: Google Cloud projenizin adı.
  • LINKED_DATASET_NAME: Places Insights işlevlerini (ör. places_insights___us) içeren BigQuery veri kümesinin adı.
  • input_geographies: Analiz edilecek coğrafi konumları içeren bir BigQuery tablosu. Bu tablo aşağıdaki sütunları içermelidir:
    • geo_id (STRING): Her coğrafi bölge için benzersiz bir tanımlayıcı.
    • geo (GEOGRAPHY): Alanı temsil eden BigQuery GEOGRAPHY nesnesi. Bu bir nokta, poligon veya başka bir coğrafya türü olabilir.
  • filters (JSON): Yerleri filtrelemek için anahtar/değer çiftleri içeren bir JSON nesnesi. Filtre Parametreleri bölümüne bakın. Aşağıdaki filtreleri içermelidir:
    • month1 (STRING): Yer aramak için kullanılacak ilk ay.
    • month2 (STRING): Yer aramak için ikinci ay.

Çıkış tablosu şeması

PLACES_COUNT_CHANGE işlevi, aşağıdaki sütunları içeren bir tablo döndürür:

Sütun adı Veri türü Açıklama
geo_id Dize Giriş coğrafyasından alınan kimlik.
start_count INT64 İlk aydan itibaren yer sayısı.
end_count INT64 İkinci aydaki yer sayısı.
net_change INT64 end_count ile start_count arasındaki fark (end_count - start_count).
percentage_change FLOAT64 1. aydan 2. aya kadar olan yüzdelik değişim.
compound_monthly_growth_rate FLOAT64 1. aydan 2. aya kadar olan bileşik aylık büyüme oranı.
added_count INT64 sample_added_place_ids içindeki örnek yer kimliklerinin sayısı.
removed_count INT64 sample_removed_place_ids içindeki örnek yer kimliklerinin sayısı.
sample_added_place_ids ARRAY<STRING> 2. ayda bulunan ancak 1. ayda bulunmayan örnek yer kimliklerinin listesi.
sample_removed_place_ids ARRAY<STRING> 1. ayda bulunan ancak 2. ayda bulunmayan örnek yer kimliklerinin listesi.

Sonuçlar, percentage_change ve start_count azalan düzende sıralanır.

İşleyiş şekli

İşlev, input_geographies tablosundaki her satırı işler. Her geo nesnesi için, filters içindeki month1 ve month2 içinde belirtilen iki ayda coğrafi bölgeye (veya geo bir nokta ise ve yarıçap filters içinde belirtilmişse geography_radius'ye) giren yerlerin sayısı hesaplanır. Bu yerleri kullanarak, ilk aydan ikinci aya yüzde değişim ve bileşik aylık büyüme oranı gibi diğer faydalı istatistikleri hesaplar.

Sayım yalnızca filters JSON nesnesinde tanımlanan tüm koşulları karşılayan yerleri içerir.

Örnek: İki ay arasındaki ÖY sayılarındaki değişiklikleri hesaplama

Bu örnekte, belirli bir coğrafi konum noktasından 5.000 yarıçaplı bir alanda month1 ve month2 parametreleri kullanılarak iki belirli ay arasındaki ÖY sayısı değişikliklerinin nasıl sorgulanacağı gösterilmektedir.

WITH my_locations AS (
  SELECT
    'loc_1' AS geo_id,
    ST_GEOGFROMTEXT('POINT(-122.4194 37.7749)') AS geo
  -- Add more target locations as needed...
)

SELECT *
FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_CHANGE`(
  TABLE my_locations,
  JSON_OBJECT(
    'geography_radius', 5000,
    'month1', '2026-01', -- Baseline snapshot month (YYYY-MM)
    'month2', '2026-02'  -- Comparison snapshot month (YYYY-MM)
  )
);

Çıkışı analiz etme

Sorgu, her giriş coğrafi konumu için bir satır içeren bir tablo döndürür.

  • Büyüme metrikleri: Çıkışta temel sayı (start_count: 89.560) ve karşılaştırma sayısı (end_count: 90.923) gösterilir. Bu da net_change +1.363 yer (+% 1,52 percentage_change) artışına neden olur.
  • Gerçeklik denetimi: sample_added_place_ids dizisi, month2 (Şubat 2026) ayında etkin hale gelen belirli yer kimliklerini listelerken sample_removed_place_ids artık mevcut olmayan yer kimliklerini listeler.
  • Places API'ye köprü: Yeni açılan veya kapanan işletmelerin mağaza adlarını, adreslerini ve özelliklerini aramak için bu örnek Yer Kimliklerini doğrudan Yer Ayrıntıları API'sine (Yeni) iletebilirsiniz.

Places Count Change işlevinin sonuçları.