Places Insights-Daten und ‑Abfragen

Places Insights-Daten

Places Insights bietet vollständige Datasets und Beispieldatasets in BigQuery.

Mit den Beispiel-Datasets können Sie Places Insights ausprobieren und die Nutzerfreundlichkeit und den Wert des Produkts beurteilen, 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.

Der Beispieleintrag enthält Daten für eine Top-Stadt für jedes der unterstützten Länder:

Amsterdam (NL)	Helsinki (FI)	Plovdiv (BG)
Ankara (TR)	Hongkong (HK)	Riffa (BH)
Arequipa (PE)	Jakarta (ID)	Rom (IT)
Athen (GR)	Dschidda (SA)	Santiago (CL)
Bad Gastein (AT)	Johannesburg (ZA)	São Paulo (BR)
Berlin (DE)	Kuala Lumpur (MY)	Schardscha (AE)
Brünn (CZ)	Lissabon (PT)	Singapur (SG)
Brüssel (BE)	London (GB)	Stockholm (SE)
Bukarest (RO)	Lusail (QA)	Sydney (AU)
Buenos Aires (AR)	Madrid (ES)	Taipeh (TW)
Busan (KR)	Manila (PH)	Tel Aviv-Jaffa (IL)
Kairo (EG)	Medellín (CO)	Tokio (JP)
Chiang Mai (TH)	Mexiko-Stadt (MX)	Toronto (CA)
Kopenhagen (DK)	Mumbai (IN)	Warschau (PL)
Cork (IE)	New York City (USA)	Wellington (NZ)
Debrecen (HU)	Oslo (NO)	Zürich (CH)
Hanoi (VN)	Paris (FR)

Die vollständigen Datasets enthalten Daten für jedes unterstützte Land und müssen gekauft werden. Wenn Sie sich für Places Insights registrieren 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 des Orts-Datasets 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 dieses Land definiert.

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

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

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

Places Insights-Daten abfragen

Places Insights bietet zwei Möglichkeiten, die Datasets abzufragen:

• Dataset direkt mit SQL abfragen: Führen Sie Standard-BigQuery-SQL-Abfragen für die Dataset-Tabellen aus. Dies bietet die größte Flexibilität für komplexe Filter, die Verknüpfung mit Ihren eigenen Daten, benutzerdefinierte Analysen und die Unterstützung zusätzlicher Aggregationsfunktionen über COUNT hinaus, z. B. AVG, SUM und GROUP BY. Weitere Informationen finden Sie in der Dokumentation.
• Dataset mit Places Count-Funktionen abfragen: Places Count-Funktionen sind vordefinierte, optimierte SQL-Abfragen, die direkt in BigQuery ausgeführt werden und gängige Datenabrufaufgaben vereinfachen. Sie bieten detailliertere Informationen, z. B. Orts-IDs, mit denen Sie Details zu einzelnen Orten abrufen können. Weitere Informationen finden Sie in der Dokumentation.

Direkte Abfragen

Bei der direkten Abfrage der Daten wird ein Aggregationsschwellenwert erzwungen. Ein Ergebnis wird nur zurückgegeben, wenn die Abfrage mindestens 5 Orte aggregiert. Wenn Ihre Suchkriterien beispielsweise zu einer Anzahl von 0, 1, 2, 3 oder 4 führen, wird das Ergebnis in der Antwort weggelassen. Eine Abfrage der Gesamtzahl der Restaurants in einem bestimmten Gebiet liefert beispielsweise nur dann eine Antwort, wenn die Gesamtzahl 5 oder höher ist. Andernfalls wird keine Antwort zurückgegeben.

Abfragen für die Funktion „Places Count“

Places Count-Funktionen können eine Liste von Orts-IDs zurückgeben, mit denen sich Informationen zu einzelnen Orten über andere GMP-Produkte wie die Places API und das Places UI Kit abrufen lassen.

Für die Places Count-Funktionen wird kein Aggregationsschwellenwert erzwungen, sondern ein Mindestsuchbereich von 40,0 m x 40,0 m (1.600 m²). Das bedeutet, dass Sie immer ein Ergebnis erhalten, solange Ihre Suchanfrage größer als der minimale Suchbereich ist, auch wenn keine Orte mit Ihrer Anfrage übereinstimmen.

Wann Daten direkt abgefragt und wann Funktionen verwendet werden sollten

Fragen Sie die Daten direkt ab, wenn Sie keine niedrigen Ergebniszahlen benötigen, wenn Sie über die Anzahl hinausgehende Informationen erhalten möchten, z. B. AVG, SUM oder COUNTIF, oder wenn Sie komplexere Abfragen durchführen müssen, z. B. das Zusammenführen von Datasets.

Verwenden Sie die Funktionen, wenn Sie wissen möchten, ob es wenige oder keine Ergebnisse gibt, oder wenn Sie Informationen zu einzelnen Orten wie den Namen oder die Adresse abrufen möchten.

Diese Tabelle enthält einen detaillierten Vergleich der Unterschiede zwischen direkten Abfragen und Funktionen zur Zählung von Orten.

	Funktionen zum Zählen von Orten	Direkte Dataset-Abfragen
Vorteile	Gibt Orts-IDs zurück, die zum Abfragen anderer APIs verwendet werden können. Kann eine beliebige Anzahl zurückgeben. Optimiert für Leistung und niedrige Verarbeitungskosten. Einfach zu verwenden. Sie müssen keine komplexen Abfragen schreiben. Validiert die Eingabeparameter und gibt einen Fehler zurück, was die Verwendung und Fehlerbehebung erleichtert.	Ermöglicht komplexe Abfragen wie erweiterte Filter und Joins. Es wird kein Mindestsuchbereich erzwungen. Unterstützt zusätzliche Aggregatfunktionen über COUNT hinaus, z. B. AVG, SUM und GROUP BY.
Schnittstelle	Vier vordefinierte SQL-Funktionen, die COUNT-Statistiken generieren: Einzelne Anzahl, Anzahl pro Typ, Anzahl pro Region, Anzahl pro H3-Zelle. Ein JSON_OBJECT übergibt Argumente an die Funktion.	Schreiben Sie Ihren eigenen SQL-Code, um Aggregatfunktionen wie COUNT, COUNT_IF, SUM und AVG. auszuführen. Zusätzliche Informationen können mit JOIN, GROUP BY, WHERE und anderen Funktionen generiert werden.
Einschränkungen	Erzwingt einen Mindestsuchbereich von 40,0 m × 40,0 m (1.600 m2). Eine Funktion gibt ein Ergebnis zurück, auch wenn die Aggregationsanzahl kleiner als 5 ist, solange der Mindestsuchbereich erfüllt ist.	Ergebnisse mit weniger als 5 Zählungen werden aus den Ergebnissen weggelassen (d.h. die Zeile wird ausgeschlossen).
Unterstützte Attributfilter	Filterparameter für die Funktion „Places Count“ unterstützen dieselben Filter wie die Attributfilter für direkte Abfragen, mit folgenden Ausnahmen: Ort id Adresskomponenten	Vollständiges Schema wird unterstützt.