POI-Änderungen zwischen Monaten abfragen (PLACES_COUNT_CHANGE)

Die Funktion PLACES_COUNT_CHANGE berechnet Änderungen bei der Anzahl der Orte von Interesse 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 Geografien, 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 Geografien. Diese Tabelle muss die folgenden Spalten enthalten:
    • geo_id (STRING): Eine eindeutige ID für jede Geografie.
    • 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 Filter parameter. Es 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.

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 Ä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 der Geografie liegen (oder innerhalb von der geography_radius, wenn das geo ein Punkt ist und der Radius in den filters angegeben ist), und zwar in den beiden Monaten, die in month1 und month2 in den filters angegeben sind. Anhand dieser Orte werden weitere nützliche Statistiken wie die prozentuale Ä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 von Interesse zwischen zwei Monaten berechnen

In diesem Beispiel wird gezeigt, wie Sie die Änderungen bei der Anzahl der Orte von Interesse zwischen zwei bestimmten Monaten mit den Parametern month1 und month2 und einem Radius von 5.000 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 (+1,52% percentage_change) ergibt.
  • Überprüfung der Ground Truth:Das Array sample_added_place_ids listet bestimmte Orts-IDs auf, die in month2 (Februar 2026) aktiv wurden, während sample_removed_place_ids Orts-IDs auflistet, 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 nach Namen, Adressen und Attributen von neu eröffneten oder geschlossenen Unternehmen zu suchen.

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