Dans l'API Places Aggregate, le filtre de type vous permet de cibler votre recherche en choisissant les types d'établissements que vous souhaitez inclure dans la réponse ou en exclure. Vous pouvez créer des listes de types que vous souhaitez inclure et de types que vous ne souhaitez pas inclure, à la fois pour la catégorie principale d'un établissement et pour ses autres détails. Vous pouvez ainsi créer des recherches spécifiques pour trouver exactement les établissements que vous recherchez.
Plus de 200 types d'établissements sont disponibles. Pour obtenir la liste complète des types compatibles avec l'API Places Aggregate, consultez le tableau A sous Types d'établissements pour l'API Places (nouveau).
Fonctionnement des types d'établissements
Un établissement peut avoir plusieurs types :
Un établissement peut avoir un seul type principal qui reflète sa fonction principale. Toutefois, dans certains cas, le type principal peut ne pas être spécifié pour un établissement.
Un établissement peut avoir un ou plusieurs types secondaires. Les types secondaires sont des catégories supplémentaires qui s'appliquent à un établissement pour fournir des informations supplémentaires sur ses caractéristiques et ses services.
Par exemple, un établissement peut spécifier restaurant comme type principal, mais comme il sert également de bar et propose des services de restauration, il peut également spécifier bar, food et establishment comme types d'établissement secondaires.
Filtrer par type
Pour filtrer les établissements par type principal, utilisez includedPrimaryTypes et excludedPrimaryTypes dans la requête. Le filtre ne s'applique qu'au type principal d'un établissement. Par exemple, un filtre includedPrimaryTypes pour restaurant ne renvoie que les établissements qui fonctionnent principalement comme des restaurants.
Pour filtrer les établissements à la fois par type principal et secondaire, utilisez includedTypes et excludedTypes dans la requête. Le filtre s'applique aux deux types. Par exemple, un includedTypes de bar renvoie les établissements dont le type principal ou secondaire est bar.