Weitere Informationen zu Typfiltern

Mit dem type-Filter in der Places Aggregate API können Sie Ihre Suche eingrenzen, indem Sie auswählen, welche Arten von Orten in die Antwort aufgenommen oder aus ihr ausgeschlossen werden sollen. Sie können Listen mit Typen erstellen, die Sie für die Hauptkategorie eines Orts und für seine anderen Details wünschen bzw. nicht wünschen. So können Sie gezielte Suchanfragen erstellen, um genau die Orte zu finden, die Sie suchen.

Es sind über 200 Orts-Typen verfügbar. Eine vollständige Liste der unterstützten Typen finden Sie in der Tabelle A unter Orts-Typen für die Places API (New).

So funktionieren Ortstypen

Ein Ort kann mehrere Ortstypen haben:

• Ein Ort kann einen primären Typ haben, der seine primäre Funktion widerspiegelt. In einigen Fällen ist der primäre Typ für einen Ort jedoch nicht angegeben.

• Ein Ort kann einen oder mehrere sekundäre Typen haben. Sekundäre Typen sind zusätzliche Kategorien, die auf einen Ort angewendet werden, um ergänzende Informationen zu den Merkmalen und Dienstleistungen des Orts bereitzustellen.

Ein Ort kann beispielsweise den primären Typ als restaurant angeben. Da er aber auch als Bar dient und Speisen anbietet, kann er auch die sekundären Ortstypen als bar, food und establishment angeben.

Nach Typ filtern

Wenn Sie Orte nach primärem Typ filtern möchten, verwenden Sie includedPrimaryTypes und excludedPrimaryTypes in der Anfrage. Der Filter gilt nur für den primären Typ eines Orts. Ein includedPrimaryTypes-Filter für restaurant gibt beispielsweise nur Orte zurück, die hauptsächlich als Restaurants dienen.

Wenn Sie Orte nach primären und sekundären Typen filtern möchten, verwenden Sie includedTypes und excludedTypes in der Anfrage. Der Filter gilt für beide Typen. Wenn Sie beispielsweise includedTypes auf bar festlegen, werden Orte zurückgegeben, die bar als primären oder sekundären Typ haben.

Wichtig:Wenn Sie mehrere Filter verwenden, ist es wichtig, die Interaktion zwischen den Filtern zu verstehen. Insbesondere werden Orte innerhalb desselben Filters mit der ODER-Logik und über verschiedene Filter hinweg mit der UND-Logik ausgewertet.

• Innerhalb eines Filters (ODER-Logik): includedTypes: restaurant, bar bedeutet beispielsweise, dass der Ort entweder restaurant oder bar sein kann.
• Filterübergreifend (UND-Logik): Alle angegebenen Filterkriterien müssen gleichzeitig erfüllt sein. Das bedeutet, dass mit jedem Filter eine weitere Einschränkung für die Abfrage hinzugefügt wird und nur Orte, die alle Bedingungen erfüllen, in den Ergebnissen enthalten sind.

Wenn Sie beispielsweise includedTypes: restaurant, bar und excludedTypes: hotel festlegen, werden mit dem Filter includedTypes zuerst alle Orte ausgewählt, die entweder als restaurant oder als bar kategorisiert sind. Zweitens werden durch den Filter excludedTypes alle Orte aus dieser Auswahl entfernt, die auch als hotel kategorisiert sind. Daher werden in der Abfrage Orte zurückgegeben, die entweder restaurant oder bar sind, aber nur, wenn sie in keinem ihrer Typen (primär oder sekundär) auch als hotel klassifiziert sind.