En savoir plus sur les filtres de type

Dans l'API Places Aggregate, le filtre de type vous aide à affiner votre recherche en vous permettant de choisir les types de lieux que vous souhaitez inclure ou exclure de la réponse. Vous pouvez créer des listes de types que vous souhaitez et de types que vous ne souhaitez pas, à la fois pour la catégorie principale d'un lieu et pour ses autres détails. Vous pouvez ainsi créer des recherches spécifiques pour trouver exactement les lieux que vous recherchez.

Plus de 200 types de lieux sont disponibles. Pour obtenir la liste complète des types d'établissements acceptés par l'API Places Aggregate, consultez le tableau A sous Types d'établissements pour l'API Places (nouveau).

Fonctionnement des types de lieux

Un lieu peut avoir plusieurs types de lieux :

• Un lieu peut avoir un seul type principal qui reflète sa fonction première. Toutefois, il est possible que le type principal d'un lieu ne soit pas spécifié.

• Un lieu peut avoir un ou plusieurs types secondaires. Les types secondaires sont des catégories supplémentaires qui s'appliquent à un lieu pour fournir des informations complémentaires sur ses caractéristiques et ses services.

Par exemple, un lieu peut spécifier son type principal comme restaurant, mais comme il sert également de bar et propose des services de restauration, il peut également spécifier ses types de lieux secondaires comme bar, food et establishment.

Filtrer par type

Pour filtrer les lieux par type principal, utilisez includedPrimaryTypes et excludedPrimaryTypes dans la requête. Le filtre ne s'applique qu'au type principal d'un lieu. Par exemple, un filtre includedPrimaryTypes pour restaurant ne renvoie que les lieux qui fonctionnent principalement comme des restaurants.

Pour filtrer les lieux par types principal et secondaire, utilisez includedTypes et excludedTypes dans la requête. Le filtre s'applique aux deux types. Par exemple, une valeur bar pour includedTypes renvoie les lieux dont le type principal ou secondaire est bar.

Important : Lorsque vous utilisez plusieurs filtres, il est important de comprendre leur interaction. En particulier, les lieux sont évalués à l'aide de la logique OU au sein d'un même filtre et de la logique ET entre différents filtres.

• Dans un filtre (logique OU) : par exemple, includedTypes: restaurant, bar signifie que le lieu peut être un restaurant ou un bar.
• Entre les filtres (logique AND) : tous les critères de filtrage spécifiés doivent être satisfaits simultanément. Cela signifie que chaque filtre ajoute une restriction à la requête. Seuls les lieux qui répondent à toutes les conditions seront inclus dans les résultats.

Par exemple, si vous définissez includedTypes: restaurant, bar et excludedTypes: hotel, le filtre includedTypes sélectionnera d'abord tous les lieux classés comme restaurant ou bar. Ensuite, le filtre excludedTypes supprimera de cette sélection tous les lieux également classés comme hotel. Par conséquent, la requête renverra les lieux qui sont soit de type restaurant, soit de type bar, mais uniquement s'ils ne sont pas également classés comme hotel dans l'un de leurs types (principal ou secondaire).