Erste Schritte mit Places Insights

Die Funktionen für die Anzahl der Orte sind vordefinierte SQL-Abfragen, die in BigQuery ausgeführt werden. Sie sind die empfohlene Methode, um das Places Insights-Dataset abzufragen und genaue Zählungen und Orts-IDs abzurufen. Sie können das Dataset auch direkt abfragen. Bei den beiden Abfragemethoden werden jedoch unterschiedliche Datenschutzschwellenwerte und Suchbereiche verwendet:

• Funktionen für die Anzahl der Orte können beliebige Zählungen zurückgeben, einschließlich 0. Es wird jedoch ein Mindestsuchbereich von 40,0 × 40,0 Metern (1.600 m^²) erzwungen. Die Funktionen geben auch Orts IDs zurück, mit denen Sie Informationen zu einzelnen Orten abrufen können. Außerdem unterstützen sie die Analyse von POI-Verlaufsdaten in monatlichen Snapshots mit optionalen Datumsfiltern.

• Abfragen für Orts-Datasets können nur Zählungen von 5 und mehr zurückgeben. Niedrige Zählungen von 0 bis 4 werden ausgelassen, um die Differential Privacy zu wahren. Es gibt jedoch keine Einschränkungen hinsichtlich der Größe des Suchbereichs.

Wenn Sie keine komplexen räumlichen Analysen durchführen müssen, empfehlen wir, mit Funktionen für die Anzahl der Orte wie PLACES_COUNT_PER_H3 zu beginnen. Diese Funktion liefert sofortige Informationen zur räumlichen Dichte in standardisierten Rasterzellen, gibt Orts-IDs für die Überprüfung der Ground Truth zurück und ist speziell für das Feature Engineering und ML-Modelle für raumbezogene Daten konzipiert.

Optimale Funktion für die Anzahl der Orte auswählen

Places Insights unterstützt mehrere räumliche Funktionen. Für eine optimierte Abfrageausführung, parallele Verarbeitung und Batch-Skalierbarkeit empfehlen wir die Verwendung der folgenden Funktionen:

• PLACES_COUNT_PER_H3: Gibt eine BigQuery-Tabelle mit der Anzahl der Orte pro H3-Zelle zurück. Diese Funktion wird für die regionale Dichteanalyse und die choroplethe Heatmap-Erstellung empfohlen.
• PLACES_COUNT_V2: Gibt eine Tabelle mit der Anzahl der Orte und Beispiel-Orts-IDs zurück. Diese Funktion akzeptiert einen Tabellen parameter mit Ihren Eingabegeografien. Wenn Sie eine gesamte Tabelle direkt übergeben, kann die BigQuery-Ausführungs-Engine die Arbeitslast verteilen und räumliche Überschneidungen parallel verarbeiten. So ist eine hocheffiziente Batchverarbeitung für Analysen in großem Maßstab möglich.
• PLACES_COUNT_PER_TYPE_V2: Gibt eine Tabelle mit der Anzahl der Orte und Beispiel-Orts-IDs zurück, kategorisiert nach Ortstyp. Ähnlich wie bei PLACES_COUNT_V2 kann BigQuery räumliche Überschneidungen in großen Datasets parallel verarbeiten, wenn Sie Ihre Eingabegeografien als Tabellenparameter übergeben.
• PLACES_COUNT_CHANGE: Gibt eine Tabelle mit der Anzahl der Orte sowie hinzugefügten und entfernten Orts-IDs zwischen zwei bestimmten Monaten zurück. Ähnlich wie bei PLACES_COUNT_V2 kann BigQuery räumliche Überschneidungen in großen Datasets parallel verarbeiten, wenn Sie Ihre Eingabegeografien als Tabellenparameter übergeben.

Neben der Anzahl der Orte geben diese Funktionen auch bis zu 250 Orts IDs pro Element der Antwort zurück.

Orts-IDs können mit folgenden APIs und Tools verwendet werden:

• Places API (New)
• Geocoding API
• Places UI Kit

Hinweis: Sie können auf die Funktionen für die Anzahl der Orte für dieselben Städte und Länder zugreifen, auf die Sie auch sonst Zugriff haben.

Abfragen mit Funktionen für die Anzahl der Orte ausführen

Verwenden Sie das folgende Format, um die Funktionen aufzurufen: [project name (optional)].[table name].[function name].

Wenn Sie den Namen des verknüpften Datasets bei der Einrichtung von Places Insights geändert haben, verwenden Sie Ihren benutzerdefinierten Namen anstelle der Standardtabellennamen. Optional können Sie auch Ihren Projektnamen angeben. Wenn kein Projektname angegeben ist, wird standardmäßig das aktive Projekt verwendet.

Beispiel:

PROJECT_NAME.places_insights___us.PLACES_COUNT_V2

Verwenden Sie ein JSON_OBJECT um Argumente an die Funktion zu übergeben.

Hinweis: Wenn Sie eine Funktion für die Anzahl der Orte verwenden, geben Sie die Funktion in der FROM Klausel an und lassen Sie WITH_AGGREGATION_THRESHOLD weg.

Abfrageergebnisse mit Parametern filtern, bei denen die Groß-/Kleinschreibung beachtet wird

Die Funktionen für die Anzahl der Orte unterstützen viele Filter, um die Suche zu verfeinern. Bei diesen Parametern (z. B. price_level oder types) wird die Groß-/Kleinschreibung beachtet und sie müssen genau mit den Parameternamen übereinstimmen. Eine vollständige Liste der Optionen finden Sie in der Referenz zu Filterparametern.

Verlaufs-Snapshots mit snapshot_date abfragen

Standardmäßig fragen die Funktionen für die Anzahl der Orte den neuesten verfügbaren Datensnapshot ab. Wenn Sie Ortsdaten so analysieren möchten, wie sie in einem bestimmten Monat in der Vergangenheit vorhanden waren, fügen Sie dem JSON_OBJECT den optionalen Parameter snapshot_date hinzu.

• Format: YYYY-MM (z. B. '2026-07')
• Standard:Wenn der Parameter weggelassen wird, fragt die Funktion automatisch den neuesten Snapshot ab.

Im folgenden Beispiel werden die Anzahl der Restaurants in Ihren Suchbereichen abgefragt, wie sie im Snapshot vom Juli 2026 erfasst wurden:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'snapshot_date', '2026-07' -- Optional historical snapshot month
  )
);

Im nächsten Beispiel werden Filter angewendet, um die Suche nach Mindestnutzerbewertung, Preisniveau, Unternehmensstatus und danach zu beschränken, ob Hunde im Restaurant erlaubt sind. Dazu wird die Funktion PLACES_COUNT_V2 verwendet.

Verwenden Sie zuerst Ihre Eingabegeografietabelle oder erstellen Sie eine mit den ausgewählten Geografien:

**Wichtig**: Sie müssen das Dataset mit der Tabelle für die Eingabegeografien in derselben Region wie das verknüpfte Places Insights-Dataset erstellen. Wenn die Standorte nicht übereinstimmen, gibt BigQuery einen Fehler zurück.

-- Create a table for the input geographies
CREATE TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas` AS (
  SELECT
    '1' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9857, 40.7484) AS geo -- Empire State Building
  UNION ALL
  SELECT
    '2' AS geo_id, -- Unique identifier
    ST_GEOGPOINT(-73.9851, 40.7580) AS geo -- Times Square
);

Rufen Sie als Nächstes PLACES_COUNT_V2 mit der Tabelle und dem JSON-Objekt auf, das die Filter enthält. Der Suchradius ist in den JSON-Filtern enthalten und wird um jeden Punkt in der Tabelle my_search_areas angewendet.

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters around each point in 'geo'
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
);

Hinweis: Fügen Sie den Filter business_status hinzu, um die Anzahl der OPERATIONAL-Unternehmen zu erhalten. Andernfalls enthält die Anzahl auch geschlossene Unternehmen.

Beispiel: Anzahl der Restaurants und Markenstandorte mit PLACES_COUNT_V2 abfragen

Im folgenden Beispiel wird die Funktion PLACES_COUNT_V2 mit der benutzerdefinierten Eingabegeografietabelle my_search_areas verwendet, um die Anzahl der Restaurants zu ermitteln, die im Juli 2026 in einem Umkreis von 1.000 Metern um das Empire State Building und den Times Square in New York City in Betrieb waren:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'snapshot_date', '2026-07'
      )
);

Die Antwort ist eine BigQuery-Tabelle mit der geo_id, der Geografie, der Anzahl und einer Stichprobe von Orts-IDs.

Im folgenden Beispiel wird die Funktion PLACES_COUNT_V2 verwendet, um nach bestimmten Marken-IDs zu filtern. In diesem Beispiel filtern wir nach Starbucks-Standorten mit der Marken-ID "1413758728321880760".

Wenn Sie die Marken-IDs für die Marken finden möchten, nach denen Sie filtern möchten, fragen Sie die brands Tabelle für Ihr Dataset ab (z. B. places_insights___us.brands). Weitere Informationen zum Dataset „brands“ finden Sie unter Abfrage mit Markendaten schreiben.

Beispiel: So finden Sie die Marken-ID für „Starbucks“:

SELECT id, name
FROM `PROJECT_NAME.places_insights___us.brands`
WHERE name = "Starbucks"

Nachdem Sie die Marken-IDs erhalten haben, können Sie sie im Filter brand_ids verwenden, wie in der folgenden Abfrage gezeigt:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  TABLE `PROJECT_NAME.YOUR_DATASET.my_search_areas`,
  JSON_OBJECT(
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'brand_ids', ["1413758728321880760"]
      )
);

Hinweis: Die erforderlichen und optionalen Parameter unterscheiden sich für jede Funktion für die Anzahl der Orte wie unter Filterbeschrieben.

Abfrageausgabe mit Google Cloud-Tools visualisieren

Mit Analyse- und Business Intelligence -Tools können Sie Statistiken aus Ihren BigQuery-Daten gewinnen. BigQuery unterstützt mehrere Datenvisualisierungstools von Google und Drittanbietern mit denen Sie die Ergebnisse Ihrer Funktionen für Places Insights-Daten analysieren können.

Ein Beispiel für die Visualisierung der Ergebnisse einer Funktion finden Sie unter Ergebnisse visualisieren in der Referenz zu PLACES_COUNT_PER_H3. Weitere Informationen zur Visualisierung von Places Insights-Ergebnissen finden Sie unter Abfrageergebnisse visualisieren.

Einschränkungen und Anforderungen für Funktionen

Für die Funktionen für die Anzahl der Orte gelten die folgenden Einschränkungen und Anforderungen:

• Die Funktionen unterstützen nur COUNT-Statistiken.
• Ein Mindestsuchbereich von 40,0 × 40,0 Metern (1.600 m²) ist erforderlich.
• Größenbeschränkung für Parameter:Das JSON-Objekt, das als Parameter an die Funktionen übergeben wird, ist auf 1 MB begrenzt. Die Auswirkungen dieser Beschränkung hängen von der Funktionsversion ab:
  • Bei Funktionen der Version 2 (PLACES_COUNT_V2, PLACES_COUNT_PER_TYPE_V2, PLACES_COUNT_CHANGE) gilt diese Beschränkung nur für das JSON-Objekt der Filter. Da Geografien separat über einen Tabellenparameter bereitgestellt werden, können diese Funktionen auf eine viel größere Anzahl von Eingabegeografien skaliert werden, ohne die Beschränkung für die JSON-Größe zu erreichen.
  • Bei PLACES_COUNT_PER_H3, PLACES_COUNT, PLACES_COUNT_PER_TYPE, und PLACES_COUNT_PER_GEO gilt diese Beschränkung für das gesamte JSON-Objekt, einschließlich aller Geografiedefinitionen. Dadurch kann die Anzahl der Geografien begrenzt sein, die in einem einzelnen Aufruf verarbeitet werden können.
• Das Filtern nach Orts-ID oder Adresskomponente wird nicht unterstützt.
• Sie können nur auf die Funktionen für die Anzahl der Orte für die Städte und Länder zugreifen, für die Sie ein Abo abgeschlossen haben. Informationen zum Dataset-Zugriff finden Sie unter Places Insights einrichten.
• Bei Filterparametern (z. B. geography oder types) wird die Groß-/Kleinschreibung beachtet und sie müssen genau mit den Parameternamen übereinstimmen. Andernfalls schlägt die Abfrage fehl.