POI-Änderungen zwischen Monaten abfragen (PLACES_COUNT_CHANGE)

Die Funktion PLACES_COUNT_CHANGE berechnet Änderungen bei der Anzahl der POIs und ruft Beispiel-Orts-IDs ab, die zwischen zwei bestimmten Monaten in mehreren Eingabegeografien hinzugefügt und entfernt wurden.

Wie PLACES_COUNT_V2 ist diese Funktion für die effiziente Batchverarbeitung konzipiert. Sie akzeptiert einen Eingabetabellenparameter mit geografischen Regionen, sodass Sie Wachstumstrends und kommerzielle Veränderungen an vielen Standorten gleichzeitig bewerten können.

Syntax

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

Parameter

  • PROJECT_NAME ist der Name Ihres Google Cloud-Projekts.
  • LINKED_DATASET_NAME: Der Name des BigQuery-Datasets, das die Places Insights-Funktionen enthält (z.B. places_insights___us).
  • input_geographies: Eine BigQuery-Tabelle mit den zu analysierenden geografischen Einheiten. Diese Tabelle muss die folgenden Spalten enthalten:
    • geo_id (STRING): Eine eindeutige Kennung für jede geografische Einheit.
    • geo (GEOGRAPHY): Das BigQuery-GEOGRAPHY-Objekt, das das Gebiet darstellt. Dies kann ein Punkt, ein Polygon oder ein anderer Geografietyp sein.
  • filters (JSON): Ein JSON-Objekt mit Schlüssel/Wert-Paaren zum Filtern der Orte. Weitere Informationen finden Sie unter Filterparameter. Sie muss die folgenden Filter enthalten:
    • month1 (STRING): Der erste Monat, in dem nach Orten gesucht werden soll.
    • month2 (STRING): Der zweite Monat, in dem nach Orten gesucht werden soll.

Schema der Ausgabetabelle

Die Funktion PLACES_COUNT_CHANGE gibt eine Tabelle mit den folgenden Spalten zurück:

Spaltenname Datentyp Beschreibung
geo_id STRING Die ID aus der Eingabegeografie.
start_count INT64 Die Anzahl der Orte aus dem ersten Monat.
end_count INT64 Die Anzahl der Orte aus dem zweiten Monat.
net_change INT64 Die Differenz zwischen „end_count“ und „start_count“ (end_count – start_count).
percentage_change FLOAT64 Die prozentuale Änderung von Monat 1 zu Monat 2.
compound_monthly_growth_rate FLOAT64 Die durchschnittliche monatliche Wachstumsrate von Monat 1 bis Monat 2.
added_count INT64 Die Anzahl der Beispiel-Orts-IDs in sample_added_place_ids.
removed_count INT64 Die Anzahl der Beispiel-Orts-IDs in sample_removed_place_ids.
sample_added_place_ids ARRAY<STRING> Eine Liste mit Beispiel-Orts-IDs, die in Monat 2, aber nicht in Monat 1 vorhanden sind.
sample_removed_place_ids ARRAY<STRING> Eine Liste mit Beispiel-Orts-IDs, die in Monat 1, aber nicht in Monat 2 vorhanden sind.

Die Ergebnisse werden nach percentage_change und start_count absteigend sortiert.

Funktionsweise

Die Funktion verarbeitet jede Zeile in der Tabelle input_geographies. Für jedes geo-Objekt wird die Anzahl der Orte gezählt, die in den beiden in month1 und month2 in der filters angegebenen Monaten in die Geografie (oder in den geography_radius, wenn das geo ein Punkt ist und der Radius in der filters angegeben ist) fallen. Anhand dieser Orte werden andere nützliche Statistiken berechnet, z. B. die prozentuale Änderung und die monatliche Wachstumsrate vom ersten zum zweiten Monat.

Die Anzahl umfasst nur die Orte, die allen im JSON-Objekt filters definierten Bedingungen entsprechen.

Beispiel: Änderungen der POI-Anzahl zwischen zwei Monaten berechnen

In diesem Beispiel wird gezeigt, wie Sie die Änderungen der POI-Anzahl zwischen zwei bestimmten Monaten mithilfe der Parameter month1 und month2 mit einem Radius von 5.000 Metern von einem bestimmten Standort abfragen.

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

Ausgabe analysieren

Die Abfrage gibt eine Tabelle mit einer Zeile für jede Eingabegeografie zurück.

  • Wachstumsmesswerte:In der Ausgabe werden die Anzahl der Baseline (start_count: 89.560) und die Anzahl des Vergleichs (end_count: 90.923) angezeigt, was zu einer net_change von +1.363 Orten (+1,52% percentage_change) führt.
  • Grundwahrheitsprüfung: Das Array sample_added_place_ids enthält bestimmte Orts-IDs, die im month2 (Februar 2026) aktiv wurden, während sample_removed_place_ids Orts-IDs enthält, die nicht mehr vorhanden sind.
  • Brücke zur Places API:Sie können diese Beispiel-Orts-IDs direkt an die Place Details API (New) übergeben, um Geschäftsnamen, Adressen und Attribute für neu eröffnete oder geschlossene Unternehmen abzurufen.

Ergebnisse für die Funktion „Places Count Change“.