PLACES_COUNT_PER_GEO-Funktion

Die Funktion PLACES_COUNT_PER_GEO verwendet ein Array von geografischen Gebieten, die durchsucht werden sollen, und gibt eine Tabelle mit der Anzahl der Orte pro Gebiet zurück. Wenn Sie beispielsweise ein Array von Postleitzahlen als Suchbereich angeben, enthält die Antwort eine Tabelle mit einer separaten Zeile für jede Postleitzahl.

Da die Funktion PLACES_COUNT_PER_GEO eine Tabelle zurückgibt, rufen Sie sie mit einer FROM-Klausel auf.

• Eingabeparameter:

  • Erforderlich: Der geographies-Filterparameter, der den Suchbereich angibt. Der Parameter geographies akzeptiert ein Array von Werten, die durch den BigQuery-Datentyp GEOGRAPHY definiert sind, der Punkte, Linestrings und Polygone unterstützt.

  • Optional: Zusätzliche Filterparameter, um die Suche zu verfeinern.

• Liefert:

  • Eine Tabelle mit einer Zeile pro geografischem Gebiet. Die Tabelle enthält die Spalten geography (GEOGRAPHY), count (INT64) und place_ids (ARRAY<STRING>). place_ids enthält bis zu 250 Orts-IDs für jedes geografische Gebiet.

Beispiel: Anzahl der Restaurants in jedem Bezirk von New York City berechnen

In diesem Beispiel wird eine Tabelle mit der Anzahl der geöffneten Restaurants pro Bezirk in New York City generiert.

In diesem Beispiel wird das öffentliche BigQuery-Dataset United States Census Bureau Data verwendet, um die Grenzen für die drei Bezirke in New York City abzurufen: „Queens“, „Kings“ und „New York“. Die Grenzen der einzelnen Bezirke sind in der Spalte county_geom enthalten.

In diesem Beispiel wird dann die BigQuery-Funktion ST_SIMPLIFY verwendet, um eine vereinfachte Version von county_geom zurückzugeben. Die Funktion ST_SIMPLIFY ersetzt nahezu gerade Verkettungen von Kanten durch eine einzelne lange Kante.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

Beispiel: Anzahl pro Bezirk berechnen, gefiltert nach Marke

Im folgenden Beispiel wird der Filter brand_ids verwendet, um die Anzahl der Orte und Beispiel-Orts-IDs für bestimmte Marken wie Starbucks "1413758728321880760" abzurufen:

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ["OPERATIONAL"]
      )
);

Ergebnisse visualisieren

Die folgenden Bilder zeigen diese Daten in Looker Studio als Karte mit ausgefüllten Bereichen, einschließlich der Umrisse der einzelnen Bezirke:

So importieren Sie Ihre Daten in Looker Studio:

1. Führen Sie die obige Funktion aus, um die Ergebnisse zu generieren.

2. Klicken Sie in den BigQuery-Ergebnissen auf Öffnen in -> Looker Studio. Ihre Ergebnisse werden automatisch in Looker Studio importiert.

3. Looker Studio erstellt eine Standardberichtsseite und initialisiert sie mit einem Titel, einer Tabelle und einem Balkendiagramm der Ergebnisse.

   

4. Wählen Sie alles auf der Seite aus und löschen Sie es.

5. Klicken Sie auf Einfügen -> Karte mit ausgefüllten Bereichen, um dem Bericht eine Karte mit ausgefüllten Bereichen hinzuzufügen.

6. Konfigurieren Sie unter Diagrammtypen -> Einrichtung die Felder wie unten dargestellt:

   

7. Die ausgefüllte Karte wird wie oben dargestellt. Optional können Sie Diagrammtypen -> Stile auswählen, um das Erscheinungsbild der Karte weiter zu konfigurieren.

Weitere Informationen und ein Beispiel zur Visualisierung von Places Insights-Ergebnissen finden Sie unter Abfrageergebnisse visualisieren.