Zapytanie o zmiany w liczbie punktów POI między miesiącami (PLACES_COUNT_CHANGE)

Funkcja PLACES_COUNT_CHANGE oblicza zmiany w liczbie ciekawych miejsc i pobiera przykładowe dodane i usunięte identyfikatory miejsc między 2 konkretnymi miesiącami w wielu regionach wejściowych.

Podobnie jak PLACES_COUNT_V2, ta funkcja jest przeznaczona do wydajnego przetwarzania wsadowego, ponieważ akceptuje parametr wejściowy tabeli lokalizacji geograficznych, co pozwala na jednoczesną ocenę trendów wzrostu i zmian komercyjnych w wielu lokalizacjach.

Składnia

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

Parametry

  • PROJECT_NAME: nazwa projektu Google Cloud.
  • LINKED_DATASET_NAME: nazwa zbioru danych BigQuery zawierającego funkcje Statystyk miejsc (np. places_insights___us).
  • input_geographies: tabela BigQuery zawierająca regiony do przeanalizowania. Tabela musi zawierać te kolumny:
    • geo_id (STRING): unikalny identyfikator każdego regionu geograficznego.
    • geo (GEOGRAPHY): obiekt BigQuery GEOGRAPHY reprezentujący obszar. Może to być punkt, wielokąt lub inny typ geograficzny.
  • filters (JSON): obiekt JSON zawierający pary klucz-wartość do filtrowania miejsc. Zobacz Parametry filtra. Musi on zawierać te filtry:
    • month1 (STRING): pierwszy miesiąc, w którym mają być wyszukiwane miejsca.
    • month2 (STRING): drugi miesiąc, w którym mają być wyszukiwane miejsca.

Schemat tabeli wyjściowej

Funkcja PLACES_COUNT_CHANGE zwraca tabelę z kolumnami:

Nazwa kolumny Typ danych Opis
geo_id CIĄG ZNAKÓW Identyfikator z wejściowej lokalizacji geograficznej.
start_count INT64 Liczba miejsc z pierwszego miesiąca.
end_count INT64 Liczba miejsc z drugiego miesiąca.
net_change INT64 Różnica między wartościami end_count i start_count (end_count – start_count).
percentage_change FLOAT64 Zmiana procentowa między miesiącem 1 a miesiącem 2.
compound_monthly_growth_rate FLOAT64 Złożona miesięczna stopa wzrostu od miesiąca 1 do miesiąca 2.
added_count INT64 Liczba przykładowych identyfikatorów miejsc w sample_added_place_ids.
removed_count INT64 Liczba przykładowych identyfikatorów miejsc w sample_removed_place_ids.
sample_added_place_ids <STRING> ARRAY Lista przykładowych identyfikatorów miejsc, które występują w miesiącu 2, ale nie w miesiącu 1.
sample_removed_place_ids <STRING> ARRAY Lista przykładowych identyfikatorów miejsc, które występują w miesiącu 1, ale nie w miesiącu 2.

Wyniki są sortowane według percentage_change i start_count malejąco.

Jak to działa

Funkcja przetwarza każdy wiersz w tabeli input_geographies. W przypadku każdego obiektu geo zlicza liczbę miejsc, które znajdują się w danym obszarze geograficznym (lub w obrębie geography_radius, jeśli geo jest punktem, a promień jest określony w filters) w 2 miesiącach określonych w month1 i month2 w filters. Na podstawie tych miejsc oblicza inne przydatne statystyki, takie jak zmiana procentowa i skumulowana miesięczna stopa wzrostu od pierwszego do drugiego miesiąca.

Liczba obejmuje tylko te miejsca, które spełniają wszystkie warunki zdefiniowane w obiekcie JSON filters.

Przykład: obliczanie zmian w liczbie ciekawych miejsc między 2 miesiącami

Ten przykład pokazuje, jak za pomocą parametrów month1 i month2 sprawdzić zmiany w liczbie ciekawych miejsc między 2 konkretnymi miesiącami w promieniu 5000 metrów od danego punktu geolokalizacyjnego.

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)
  )
);

Analiza danych wyjściowych

Zapytanie zwraca tabelę z wierszem dla każdego wejściowego obszaru geograficznego.

  • Dane dotyczące wzrostu: dane wyjściowe pokazują liczbę bazową (start_count: 89 560) i liczbę porównawczą (end_count: 90 923), co daje net_change o wartości +1363 miejsc (+1,52% percentage_change).
  • Ground-truth inspection: tablica sample_added_place_ids zawiera listę konkretnych identyfikatorów miejsc, które stały się aktywne w month2 (luty 2026 r.), a sample_removed_place_ids zawiera listę identyfikatorów miejsc, które nie są już dostępne.
  • Połączenie z Places API: możesz przekazać te przykładowe identyfikatory miejsc bezpośrednio do Place Details API (nowego), aby wyszukać nazwy, adresy i atrybuty nowo otwartych lub zamkniętych firm.

Wyniki funkcji zmiany liczby miejsc.