POI-Änderungen zwischen Monaten abfragen (PLACES_COUNT_CHANGE)

Die Funktion PLACES_COUNT_CHANGE berechnet Änderungen bei der Anzahl der Orte 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 für geografische Einheiten, sodass Sie Wachstumstrends und kommerzielle Veränderungen an vielen Standorten gleichzeitig auswerten können.

Syntax

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

Parameter

  • PROJECT_NAME: Der Name Ihres Google Cloud-Projekts.
  • LINKED_DATASET_NAME: Der Name des BigQuery-Datasets mit den Places Insights-Funktionen (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 ID für jede geografische Einheit.
    • geo (GEOGRAPHY): Das BigQuery-GEOGRAPHY-Objekt, das das Gebiet darstellt. Dies kann ein Punkt, ein Polygon oder ein anderer geografischer Typ sein.
  • filters (JSON): Ein JSON-Objekt mit Schlüssel-Wert-Paaren zum Filtern der Orte. Weitere Informationen finden Sie unter Filter parameter. Es muss die folgenden Filter enthalten:
    • month1 (STRING): Der erste Monat, für den Orte gesucht werden sollen.
    • month2 (STRING): Der zweite Monat, für den Orte gesucht werden sollen.

Ausgabetabellenschema

Die Funktion PLACES_COUNT_CHANGE gibt eine Tabelle mit 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 Veränderung von „month1“ zu „month2“.
compound_monthly_growth_rate FLOAT64 Die zusammengesetzte monatliche Wachstumsrate von „month1“ zu „month2“.
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 von Beispiel-Orts-IDs, die in „month2“, aber nicht in „month1“ vorhanden sind.
sample_removed_place_ids ARRAY<STRING> Eine Liste von Beispiel-Orts-IDs, die in „month1“, aber nicht in „month2“ vorhanden sind.

Die Ergebnisse werden absteigend nach percentage_change und start_count 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 die geografische Einheit fallen (oder in den geography_radius, wenn das geo ein Punkt ist und der Radius in den filters angegeben ist) in den zwei Monaten, die in month1 und month2 in den filters angegeben sind. Anhand dieser Orte werden weitere nützliche Statistiken wie die prozentuale Veränderung und die zusammengesetzte monatliche Wachstumsrate vom ersten zum zweiten Monat berechnet.

Die Anzahl umfasst nur Orte, die alle im JSON-Objekt filters definierten Bedingungen erfüllen.

Beispiel: Änderungen bei der Anzahl der Orte zwischen zwei Monaten berechnen

In diesem Beispiel wird gezeigt, wie Sie die Änderungen bei der Anzahl der Orte zwischen zwei bestimmten Monaten mit den Parametern month1 und month2 und einem Radius von 5.000 Metern von einem bestimmten geografischen Punkt aus 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.

  • Wachstumsstatistiken:Die Ausgabe zeigt die Ausgangszahl (start_count: 89.560) und die Vergleichszahl (end_count: 90.923), was eine net_change von +1.363 Orten ergibt (+1,52% percentage_change).
  • Überprüfung der Ground Truth:Das Array sample_added_place_ids enthält eine Liste bestimmter Orts-IDs, die in month2 (Februar 2026) aktiv wurden, während sample_removed_place_ids Orts-IDs enthält, die nicht mehr vorhanden sind.
  • Verbindung zur Places API: Sie können diese Beispiel-Orts-IDs direkt an die Place Details API (New) übergeben, um Namen, Adressen und Attribute von neu eröffneten oder geschlossenen Unternehmen abzurufen.

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