Filterparameter

Sie können auf Funktionen für die Anzahl von Orten Filter anwenden. Verwenden Sie dazu die Parameter, die in der folgenden Tabelle beschrieben sind. Die erforderlichen Parameter unterscheiden sich je nach Funktion:

Beim Filternamen und seinem Wert wird die Groß- und Kleinschreibung berücksichtigt. Sie müssen sie genau so angeben, wie sie in der Tabelle zu sehen sind. Andernfalls gibt die Abfrage einen Fehler wegen eines ungültigen Arguments zurück.

Filtername Beschreibung Typ Unterstützte Werte
geography

Für PLACES_COUNT, PLACES_COUNT_PER_TYPE und PLACES_COUNT_PER_H3

Gibt einen Bereich für die Suche an. Jeder Typ von GEOGRAPHY wird unterstützt, z. B. Point, LineString, und Polygon.

Sie können den Parameter geography in Kombination mit geography_radius verwenden, um Ihrem Suchbereich einen Puffer hinzuzufügen.

Es gilt ein Mindestsuchbereich von 40,0 × 40,0 Metern (1.600 m2). Wenn Sie einen Suchbereich unter diesem Limit angeben, gibt die Funktion einen Fehler wegen eines ungültigen Arguments zurück.

GEOGRAPHY Jeder Typ von GEOGRAPHY.
geographies

Nur für PLACES_COUNT_PER_GEO

Gibt eine Liste von Bereichen für die Suche an. Jeder Typ von GEOGRAPHY wird unterstützt, z. B. Point, LineString, und Polygon.

Sie können den Parameter geographies in Kombination mit geography_radius verwenden, um Ihrem Suchbereich einen Puffer hinzuzufügen. Der Puffer wird allen angegebenen geografischen Einheiten hinzugefügt.

Es gilt ein Mindestsuchbereich von 40,0 × 40,0 Metern (1.600 m2). Wenn Sie einen Suchbereich unter diesem Limit angeben, gibt die Funktion einen Fehler wegen eines ungültigen Arguments zurück.

ARRAY<GEOGRAPHY> Jeder Typ von GEOGRAPHY.
geography_radius

Fügt der angegebenen geografischen Einheit einen Radius oder Puffer in Metern hinzu. Der Standardwert ist 0.

Der angegebene Wert muss einen Mindestsuch bereich von 40,0 × 40,0 Metern (1.600 m2) definieren. Für eine Point Geografie, beträgt der Mindestradius daher 23 Meter.

INT64 Der Mindestwert ist 0.
h3_resolution

Nur für PLACES_COUNT_PER_H3

Die H3-Auflösung, die zum Aggregieren der Anzahl von Orten in H3-Zellen verwendet wird.

INT64 Zwischen 0 und 11.
types

Gibt die zu berücksichtigenden Ortstypen an.

Jeder Ort enthält eine Reihe von Ortstypen, z. B. "restaurant" und "cafe". Wenn keine Typen angegeben sind, werden alle Ortstypen im Ergebnis berücksichtigt.

ARRAY<STRING>

Eine vollständige Liste der möglichen Werte finden Sie unter Ortstypen.

Beispiel:

["restaurant", "cafe", "bar"]

primary_type

Gibt die zu berücksichtigenden primären Typen an.

Ein Ort kann nur einen primären Typ haben. Dieser Typ beschreibt den Ort am besten.

Wenn keine primären Typen angegeben sind, werden alle primären Ortstypen im Ergebnis berücksichtigt.

ARRAY<STRING>

Eine vollständige Liste der möglichen Werte finden Sie unter Ortstypen.

Beispiel:

["restaurant", "cafe", "bar"]

brand_ids

Nur für PLACES_COUNT_PER_H3, PLACES_COUNT_V2 und PLACES_COUNT_PER_TYPE_V2

Gibt die zu berücksichtigenden Marken-IDs an.

Jeder Ort kann mit Marken-IDs verknüpft werden. Wenn keine Marken-IDs angegeben sind, werden alle Marken (und Orte ohne Markenbezug) im Ergebnis berücksichtigt.

Hinweis: Markendaten werden nur in bestimmten Ländern unterstützt. Derzeit: USA (US), Kanada (CA), Vereinigtes Königreich (GB) und Australien (AU).

ARRAY<STRING>

Ein Array von Marken-IDs. Weitere Informationen zu Markendaten finden Sie unter Abfrage mit Markendaten schreiben.

Beispiel:

["brand_001", "brand_002"]

min_rating Gibt die zu berücksichtigende Mindestbewertung für Orte an.

Die Bewertung eines Ortes basiert auf Nutzerrezensionen und liegt zwischen 1,0 und 5,0.

Wenn Sie eine Bewertung außerhalb dieses Bereichs angeben, gibt die Funktion einen Fehler wegen eines ungültigen Arguments zurück.

FLOAT Zwischen 1,0 und 5,0.
max_rating

Gibt die zu berücksichtigende Höchstbewertung für Orte an.

Die Bewertung eines Ortes basiert auf Nutzerrezensionen und liegt zwischen 1,0 und 5,0.

Wenn Sie eine Bewertung außerhalb dieses Bereichs angeben, gibt die Funktion einen Fehler wegen eines ungültigen Arguments zurück.

FLOAT Zwischen 1,0 und 5,0.
min_user_rating_count

Gibt die zu berücksichtigende Mindestanzahl von Nutzerbewertungen an.

Die Anzahl der Nutzerbewertungen ist die Gesamtzahl der Rezensionen für einen Ort.

Der Mindestwert ist 0. Wenn Sie einen Wert unter 0 angeben, gibt die Funktion einen Fehler wegen eines ungültigen Arguments zurück.

INT64 Der Mindestwert ist 0.
max_user_rating_count

Gibt die zu berücksichtigende Höchstanzahl von Nutzerbewertungen an.

Die Anzahl der Nutzerbewertungen ist die Gesamtzahl der Rezensionen für einen Ort.

Der Mindestwert ist 0. Wenn Sie einen Wert unter 0 angeben, gibt die Funktion einen Fehler wegen eines ungültigen Arguments zurück.

INT64 Der Mindestwert ist 0.
price_level

Gibt die zu berücksichtigenden Preisklassen an.

Sie können mehrere Preisklassen angeben.

ARRAY<STRING>

Unterstützte Werte:

"PRICE_LEVEL_FREE"

"PRICE_LEVEL_INEXPENSIVE"

"PRICE_LEVEL_MODERATE"

"PRICE_LEVEL_EXPENSIVE"

"PRICE_LEVEL_VERY_EXPENSIVE"

Beispiel:

["PRICE_LEVEL_MODERATE","PRICE_LEVEL_EXPENSIVE"]

business_status Gibt den zu berücksichtigenden Unternehmensstatus an. Sie können mehrere Unternehmensstatus angeben. ARRAY<STRING>

Unterstützte Werte:

"OPERATIONAL"

"CLOSED_TEMPORARILY"

"CLOSED_PERMANENTLY"

"FUTURE_OPENING"

Beispiel:

["OPERATIONAL","CLOSED_TEMPORARILY"]

takeout Berücksichtigt Orte, die Gerichte zum Mitnehmen anbieten. BOOLEAN TRUE, FALSE
delivery Berücksichtigt Orte, die einen Lieferservice anbieten. BOOLEAN TRUE, FALSE
dine_in Berücksichtigt Orte, die den Verzehr von Speisen und Getränken vor Ort anbieten. BOOLEAN TRUE, FALSE
curbside_pickup Berücksichtigt Orte, die eine Abholung vor dem Laden anbieten. BOOLEAN TRUE, FALSE
reservable Berücksichtigt Orte, die reserviert werden können. BOOLEAN TRUE, FALSE
outdoor_seating Berücksichtigt Orte, die Sitzgelegenheiten im Freien anbieten. BOOLEAN TRUE, FALSE
live_music Berücksichtigt Orte, die Livemusik anbieten. BOOLEAN TRUE, FALSE
allows_dogs Berücksichtigt Orte, an denen Hunde erlaubt sind. BOOLEAN TRUE, FALSE
restroom Berücksichtigt Orte, die Toiletten anbieten. BOOLEAN TRUE, FALSE
serves_breakfast Berücksichtigt Orte, die Frühstück anbieten. BOOLEAN TRUE, FALSE
serves_lunch Berücksichtigt Orte, die Mittagessen anbieten. BOOLEAN TRUE, FALSE
serves_dinner Berücksichtigt Orte, die Abendessen anbieten. BOOLEAN TRUE, FALSE
serves_beer Berücksichtigt Orte, die Bier anbieten. BOOLEAN TRUE, FALSE
serves_wine Berücksichtigt Orte, die Wein anbieten. BOOLEAN TRUE, FALSE
serves_brunch Berücksichtigt Orte, die Brunch anbieten. BOOLEAN TRUE, FALSE
serves_vegetarian_food Berücksichtigt Orte, die vegetarische Gerichte anbieten. BOOLEAN TRUE, FALSE
serves_cocktails Berücksichtigt Orte, die Cocktails anbieten. BOOLEAN TRUE, FALSE
serves_dessert Berücksichtigt Orte, die Desserts anbieten. BOOLEAN TRUE, FALSE
serves_coffee Berücksichtigt Orte, die Kaffee anbieten. BOOLEAN TRUE, FALSE
menu_for_children Berücksichtigt Orte, die Speisekarten für Kinder anbieten. BOOLEAN TRUE, FALSE
good_for_children Berücksichtigt Orte, die für Kinder geeignet sind. BOOLEAN TRUE, FALSE
good_for_groups Berücksichtigt Orte, die für Gruppen geeignet sind. BOOLEAN TRUE, FALSE
good_for_watching_sports Berücksichtigt Orte, die für Sportübertragungen geeignet sind. BOOLEAN TRUE, FALSE
accepts_credit_cards Berücksichtigt Orte, an denen Kreditkarten akzeptiert werden. BOOLEAN TRUE, FALSE
accepts_debit_cards Berücksichtigt Orte, an denen Debitkarten akzeptiert werden. BOOLEAN TRUE, FALSE
accepts_cash_only Berücksichtigt Orte, an denen nur Bargeld akzeptiert wird. BOOLEAN TRUE, FALSE
accepts_nfc Berücksichtigt Orte, an denen NFC-Zahlungen akzeptiert werden. BOOLEAN TRUE, FALSE
free_parking_lot Berücksichtigt Orte mit kostenlosen Parkplätzen. BOOLEAN TRUE, FALSE
paid_parking_lot Berücksichtigt Orte mit gebührenpflichtigen Parkplätzen. BOOLEAN TRUE, FALSE
free_street_parking Berücksichtigt Orte mit kostenlosen Parkplätzen an der Straße. BOOLEAN TRUE, FALSE
paid_street_parking Berücksichtigt Orte mit gebührenpflichtigen Parkplätzen an der Straße. BOOLEAN TRUE, FALSE
valet_parking Berücksichtigt Orte mit Einparkservice. BOOLEAN TRUE, FALSE
free_garage_parking Berücksichtigt Orte mit kostenlosen Parkplätzen im Parkhaus. BOOLEAN TRUE, FALSE
paid_garage_parking Berücksichtigt Orte mit gebührenpflichtigen Parkplätzen im Parkhaus. BOOLEAN TRUE, FALSE
wheelchair_accessible_parking Berücksichtigt Orte mit rollstuhlgerechten Parkplätzen. BOOLEAN TRUE, FALSE
wheelchair_accessible_entrance Berücksichtigt Orte mit rollstuhlgerechten Eingängen. BOOLEAN TRUE, FALSE
wheelchair_accessible_restroom Berücksichtigt Orte mit rollstuhlgerechten Toiletten. BOOLEAN TRUE, FALSE
wheelchair_accessible_seating Berücksichtigt Orte mit rollstuhlgerechten Sitzplätzen. BOOLEAN TRUE, FALSE