Places Insights-Daten und ‑Abfragen

Places Insights-Daten

Places Insights bietet vollständige und Beispiel-Datasets in BigQuery.

Mit den Beispiel-Datasets können Sie Places Insights ausprobieren, um die Benutzerfreundlichkeit und den Wert des Produkts zu bewerten, bevor Sie sich für den Kauf des vollständigen Datasets entscheiden. Das Beispiel-Dataset enthält nur Daten für die Stadt selbst. Sie enthält keine Daten für die umliegende Metropolregion.

Die Beispielliste enthält die Daten für eine Top-Stadt für jedes der unterstützten Länder: Sydney (AU), São Paulo (BR), Toronto (CA), Zürich (CH), Berlin (DE), Madrid (ES), Paris (FR), London (UK), Jakarta (ID), Mumbai (IN), Rom (IT), Tokio (JP), Mexiko-Stadt (MX) und New York City (US).

Die vollständigen Datasets enthalten Daten für jedes unterstützte Land und müssen gekauft werden. Wenn Sie das vollständige Dataset kaufen möchten, füllen Sie das Antragsformular aus. Nur der Datenabonnent muss Zugriff auf das Places Insights-Dataset anfordern. Sobald das Abo in einem BigQuery-Projekt aktiv ist, kann jeder Nutzer mit Zugriff auf dieses Projekt die Places Insights-Daten abfragen.

Jedes Länder-Dataset hat einen eigenen Eintrag, den Sie separat abonnieren müssen. Weitere Informationen zum Abonnieren eines Eintrags finden Sie unter Places Insights einrichten.

Dataset-Schemas

Das Schema für das Places-Dataset für jedes Land besteht aus zwei Teilen:

• Das Kernschema, das für die Datasets aller Länder gilt.
• Ein länderspezifisches Schema, das Schemakomponenten für das jeweilige Land definiert.

Wenn Sie beispielsweise mit dem Dataset für Spanien (ES) arbeiten, müssen Sie sowohl auf das Kernschema als auch auf das ES-spezifische Schema verweisen.

Das Schema für das Dataset „Marken“ definiert drei Felder:

• id: Die Marken-ID.
• name: Der Name der Marke, z. B. „Hertz“ oder „Chase“.
• category: Die Kategorie der Marke auf hoher Ebene, z. B. „Tankstelle“, „Essen und Trinken“ oder „Unterkünfte“.

Places Insights-Daten abfragen

Places Insights bietet zwei Möglichkeiten zum Abfragen der Datasets:

• Dataset direkt mit SQL abfragen: Führen Sie Standard-BigQuery-SQL-Abfragen für die Dataset-Tabellen aus. So haben Sie die größte Flexibilität für komplexes Filtern, Verknüpfen mit Ihren eigenen Daten, benutzerdefinierte Analysen und Unterstützung für zusätzliche Aggregatfunktionen über COUNT hinaus, z. B. AVG, SUM und GROUP BY. Dokumentation ansehen
• Dataset mit Funktionen für die Anzahl der Orte abfragen: Funktionen für die Anzahl der Orte sind vordefinierte, optimierte SQL-Abfragen, die direkt in BigQuery ausgeführt werden und gängige Aufgaben zum Abrufen von Daten vereinfachen. Sie liefern detailliertere Informationen, z. B. Orts-IDs, mit denen Sie Details zu einzelnen Orten abrufen können. Dokumentation ansehen

Direkte Anfragen

Wenn Sie die Daten direkt abfragen, wird ein Aggregationsschwellenwert erzwungen. Ein Ergebnis wird nur zurückgegeben, wenn die Anfrage mindestens fünf Orte aggregiert. Wenn das Ergebnis Ihrer Suchkriterien beispielsweise 0, 1, 2, 3 oder 4 ist, wird es aus der Antwort ausgelassen. Wenn Sie beispielsweise nach der Gesamtzahl der Restaurants in einem bestimmten Gebiet fragen, wird nur dann eine Antwort zurückgegeben, wenn die Gesamtzahl mindestens 5 beträgt. Andernfalls wird keine Antwort zurückgegeben.

Abfragen für die Funktion „Anzahl der Orte“

Funktionen für die Anzahl von Orten können eine Liste von Orts-IDs zurückgeben, mit denen Sie mithilfe anderer GMP-Produkte wie der Places API und dem Places UI Kit Informationen zu einzelnen Orten abrufen können.

Bei Funktionen für die Anzahl der Orte wird kein Aggregationsschwellenwert, sondern eine Mindestsuchfläche von 40,0 × 40,0 Metern (1.600 m²) erzwungen. Das bedeutet, dass Sie immer ein Ergebnis erhalten, solange Ihre Suchanfrage größer als das Mindestsuchgebiet ist. Das gilt auch, wenn es keine Orte gibt, die Ihrer Anfrage entsprechen.

Wann Daten direkt abgefragt und wann Funktionen verwendet werden sollten

Fragen Sie die Daten direkt ab, wenn Sie keine niedrigen Ergebnisanzahlen benötigen, wenn Sie mehr als nur Anzahlwerte erhalten möchten, z. B. AVG, SUM oder COUNTIF, oder wenn Sie komplexere Abfragen wie das Verknüpfen von Datasets ausführen müssen.

Verwenden Sie die Funktionen für Abfragen, wenn Sie wissen müssen, ob es nur wenige oder gar keine Ergebnisse gibt oder wenn Sie einzelne Ortsinformationen wie den Ortsnamen oder die Adresse abrufen müssen.

In dieser Tabelle finden Sie einen detaillierten Vergleich der Unterschiede zwischen direkten Anfragen und Funktionen zum Zählen von Orten.

	Funktionen für die Anzahl der Orte	Direkte Dataset-Abfragen
Vorteile	Gibt Orts-IDs zurück, mit denen andere APIs abgefragt werden können. Es kann eine beliebige Anzahl zurückgegeben werden. Optimiert für Leistung und niedrige Verarbeitungskosten. Einfache Bedienung. Sie müssen keine komplexen Abfragen schreiben. Die Eingabeparameter werden validiert und es wird ein Fehler zurückgegeben, was die Verwendung und das Debugging erleichtert.	Ermöglicht komplexe Abfragen wie erweiterte Filter und Joins. Es wird keine Mindestfläche für die Suche erzwungen. Unterstützt neben COUNT auch zusätzliche Aggregatfunktionen wie AVG, SUM und GROUP BY.
Schnittstelle	Vier vordefinierte SQL-Funktionen, mit denen COUNT-Statistiken generiert werden: Einzelzählung, Zählung nach Typ, Zählung nach geografischer Einheit und Zählung nach H3-Zelle. Mit einem JSON_OBJECT werden Argumente an die Funktion übergeben.	Sie können eigenen SQL-Code schreiben, um Aggregationsfunktionen wie COUNT, COUNT_IF, SUM und AVG. auszuführen. Mit JOIN, GROUP BY, WHERE und anderen Funktionen lassen sich zusätzliche Statistiken generieren.
Einschränkungen	Erzwingt eine Mindestsuchfläche von 40,0 × 40,0 Metern (1.600 m2). Eine Funktion gibt ein Ergebnis zurück, auch wenn die Anzahl der Aggregationen weniger als 5 beträgt, sofern die Mindestsuchfläche erreicht wird.	Ergebnisse mit weniger als 5 Zählungen werden aus den Ergebnissen entfernt (d.h., die Zeile wird ausgeschlossen).
Unterstützte Attributfilter	Filterparameter für die Funktion „Anzahl der Orte“ werden wie die Attributfilter für Direktabfragen unterstützt, mit Ausnahme der folgenden: Ort: id Adresskomponenten Öffnungszeiten Optionen zum Laden von Elektrofahrzeugen Marken	Vollständiges Schema wird unterstützt.