Dataset mit Funktionen für die Anzahl der Orte abfragen

Funktionen für die Anzahl von Orten sind vordefinierte SQL-Abfragen, die in BigQuery ausgeführt werden und eine Ergänzung zur direkten Abfrage des Datasets darstellen. Der Hauptunterschied zwischen dem direkten Abfragen der Daten und der Verwendung einer Funktion besteht darin, dass bei Funktionen kein Mindestanzahlschwellenwert, sondern ein Mindestsuchbereich erzwungen wird:

• Ortsdatensätze abfragen können nur Zählungen ab 5 zurückgeben, es gibt aber keine Einschränkungen für die Größe des Suchbereichs.
• Funktionen für die Anzahl der Orte können beliebige Anzahlen zurückgeben, einschließlich 0, erzwingen aber eine Mindestsuchfläche von 40,0 × 40,0 Metern (1.600 m²). Funktionen können auch Orts-IDs zurückgeben, mit denen Informationen zu einzelnen Orten abgerufen werden können.

Sie sollten Funktionen für die Anzahl der Orte verwenden, wenn es wichtig ist zu wissen, wann eine Anfrage keine Ergebnisse zurückgibt oder wenn Sie niedrige Anzahlen von Orten unter 5 benötigen. Sie ist auch nützlich, wenn Sie einzelne Ortsinformationen benötigen, um Ihre Ergebnisse zu überprüfen.

Die Funktionen für die Anzahl der Orte liefern nur Anzahlwerte. Wenn Sie komplexere Abfragen wie Datenverknüpfungen ausführen oder zusätzliche Informationen wie die durchschnittliche Bewertung einer Gruppe von Orten abrufen möchten, fragen Sie das Dataset direkt ab.

Unterstützte Funktionen für die Anzahl der Orte und Länder

Places Insights unterstützt die folgenden Funktionen:

• PLACES_COUNT: Gibt eine einzelne Zeile mit der Anzahl der Orte zurück.
• PLACES_COUNT_PER_TYPE: Gibt eine BigQuery-Tabelle mit der Anzahl der Orte nach Ortstyp zurück.
• PLACES_COUNT_PER_GEO: Gibt eine BigQuery-Tabelle mit der Anzahl der Orte nach geografischen Einheiten zurück.
• PLACES_COUNT_PER_H3: Gibt eine BigQuery-Tabelle mit der Anzahl der Orte pro H3-Zelle zurück.

Zusammen mit der Anzahl der Orte geben die Funktionen PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO und PLACES_COUNT_PER_H3 auch bis zu 250 Orts-IDs pro Element der Antwort zurück. Alle Filterparameter ansehen

Orts-IDs können für Folgendes verwendet werden:

• Places API (New)
• Geocoding API
• UI-Kit für Places

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

Abfragen mit Funktionen schreiben

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 hier aufgeführten Standardtabellennamen. Sie können optional auch den Namen Ihres Projekts angeben. Wenn keine angegeben ist, wird standardmäßig das aktive Projekt verwendet.

Beispiel:

PROJECT_NAME.places_insights___us.PLACES_COUNT

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

Hinweis: Wenn Sie eine Funktion für die Anzahl der Orte> verwenden, wird die Funktion in der FROM-Klausel angegeben und WITH_AGGREGATION_THRESHOLD wird ausgelassen.

Ergebnisse filtern

Die Funktionen für die Anzahl der Orte unterstützen viele Filter, um Ihre Suche einzugrenzen. Bei diesen Parametern (z. B. price_level oder types) wird die Groß-/Kleinschreibung beachtet und sie müssen exakt mit den Parameternamen übereinstimmen. Vollständige Liste der Optionen

Im nächsten Beispiel wenden Sie Filter an, um die Suche nach Mindestnutzerbewertung, Preisniveau, Unternehmensstatus und ob Hunde im Restaurant erlaubt sind, einzuschränken:

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"],
      'min_rating', 1.3,
      'price_level', ['PRICE_LEVEL_INEXPENSIVE', 'PRICE_LEVEL_MODERATE'],
      'allows_dogs', TRUE
      )
) as count;

Hinweis :Fügen Sie den Filter business_status ein, damit die Anzahl der OPERATIONAL-Unternehmen angezeigt wird. Andernfalls enthält die Anzahl auch geschlossene Unternehmen.

Beispiel für die Funktion „Anzahl der Orte“

Im folgenden Beispiel wird die PLACES_COUNT-Funktion verwendet, um die Anzahl der betriebsbereiten Restaurants im Umkreis von 1.000 Metern um das Empire State Building in New York City zurückzugeben:

SELECT `PROJECT_NAME.places_insights___us.PLACES_COUNT`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'business_status', ['OPERATIONAL'],
      'types', ["restaurant"]
      )
) as count;

Die Antwort enthält eine einzelne Anzahl:

In diesem Beispiel wird mit der BigQuery-Funktion ST_GEOGPOINT ein GEOGRAPHY-Wert aus einem Punkt zurückgegeben und dann an den Parameter geography übergeben. Außerdem wird der Suchradius um den Punkt und der zu suchende Ortstyp "restaurant" übergeben.

Hinweis :Die erforderlichen und optionalen Parameter unterscheiden sich für jede Funktion zum Zählen von Orten, wie unter Filtern beschrieben.

Anzahl der Orte nach Typ, geografischer Einheit oder H3-Beispiel

Zusammen mit der Anzahl der Orte geben die Funktionen PLACES_COUNT_PER_TYPE, PLACES_COUNT_PER_GEO und PLACES_COUNT_PER_H3 auch bis zu 250 Orts-IDs für die in der Antwort enthaltenen Orte zurück.

Die Funktion PLACES_COUNT_PER_TYPE gibt beispielsweise eine Tabelle mit der Anzahl der Orte pro Ortstyp zurück. Die Antwort enthält ein Array von Orts-IDs für die Orte, die den einzelnen Typen entsprechen. Sie können die zurückgegebenen Orts-IDs verwenden, um Informationen zu den einzelnen Orten abzurufen.

Der folgende Funktionsaufruf gibt die Anzahl der Orte mit den Typen restaurant, cafe und bar zurück:

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'geography', ST_GEOGPOINT(-73.9857, 40.7484), -- Empire State Building
      'geography_radius', 1000, -- Radius in meters
      'types', ["restaurant", "cafe", "bar"],
      'business_status', ['OPERATIONAL']
      )
);

Diese Funktion gibt eine Tabelle mit drei Spalten zurück: type, count und sample_place_ids. In der Spalte count wird die Anzahl der Orte für jede type angezeigt und in der Spalte sample_place_ids sind bis zu 250 Orts-IDs für jede type aufgeführt.

Hinweis :Wenn Sie Informationen zu einem Ort abrufen möchten, verwenden Sie die Orts-ID, um die Places API oder das Places UI Kit aufzurufen. Ein Beispiel finden Sie unter Places-Insights-Daten mit Beispiel-Place-IDs validieren.

Ergebnisse visualisieren

Analyse- und Business Intelligence-Tools sind entscheidend, um Erkenntnisse aus Ihren BigQuery-Daten zu 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. Weitere Informationen und ein Beispiel für die Visualisierung von Places Insights-Ergebnissen finden Sie unter Abfrageergebnisse visualisieren.

Beschränkungen und Anforderungen

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

• Es werden nur COUNT-Statistiken unterstützt.
• Die Mindestsuchfläche beträgt 40,0 × 40,0 Meter (1.600 m²).
• Die Eingabegröße für den Parameter für die Anzahl der Orte ist auf 1 MB begrenzt.
• Das Filtern nach Orts-ID, Marken, Lademöglichkeiten für Elektrofahrzeuge oder Adresskomponenten wird nicht unterstützt.
• Sie können nur für die Städte und Länder, für die Sie ein Abo abgeschlossen haben, auf die Funktionen für die Anzahl der Orte zugreifen. Informationen zum Einrichten des Dataset-Zugriffs finden Sie unter Places Insights einrichten.
• Bei Filterparametern (z. B. geography oder types) wird die Groß-/Kleinschreibung berücksichtigt. Sie müssen exakt mit den Parameternamen übereinstimmen, da die Abfrage sonst fehlschlägt.