[ le français suit ]

Dear MSC GeoMet Users,

The MSC GeoMet team is pleased to announce the availability of new documentation for advanced data filtering on GeoMet-OGC-API using the Common Query Language (CQL2) standard! This documentation provides comprehensive guidance and examples for constructing powerful, server-side queries against our OGC API - Features collections.

📖 What's Covered in the Documentation

• OGC API Basics: An overview of the OGC API - Features and OGC API - Coverages standards, including main endpoints, common query parameters (format, bounding box, datetime), and pagination strategies.
• CQL2 Filtering: Detailed guidance on using the ?filter query parameter to build expressive, server-side queries that reduce the amount of data returned and retrieve only features of interest.
• Spatial, Temporal, and Property Filtering: Step-by-step examples for filtering by bounding box, datetime ranges, and collection-specific properties, with support for combining multiple filter parameters.

🔍 CQL2 Filtering Capabilities

• Exact matches: Filter features where an attribute has an exact value (e.g., station number, bulletin type).
• Partial keyword searches: Use the LIKE operator with % wildcards for flexible text matching across attribute values.
• Comparison operators: Filter numeric or temporal values using >, <, >=, <=, and BETWEEN.
• Logical operators: Combine conditions with AND, OR, and NOT for precise, multi-criteria queries.
• Spatial predicates: Use INTERSECTS, DISJOINT, and BBOX to filter features based on geometry and geographic location.

💡 Practical Examples Included
       The documentation includes a wide range of real-world examples, from simple single-parameter queries to complex multi-parameter filters, including:

• Searching meteorological bulletins by type, issuing office, or identifier.
• Filtering climate observations by temperature, wind, humidity, and precipitation ranges.
• Identifying regions of elevated wildfire risk using combined weather criteria.
• Querying Air Quality Health Index (AQHI) observations within specific geographic areas.
• Using curl commands and Python scripts with the pygeofilter module for programmatic access.

Access the full documentation: https://eccc-msc.github.io/open-data/msc-geomet/ogc_api_en/#ogc-api-advanced-filtering-with-cql2

We hope this new documentation helps you get the most out of GeoMet-OGC-API's powerful filtering capabilities. As always, we welcome your feedback!

Sincere regards,

The MSC GeoMet development team

---

Chers utilisateurs de GeoMet du SMC,

L'équipe GeoMet du SMC est heureuse d'annoncer la disponibilité d'une nouvelle documentation sur le filtrage avancé de données sur GeoMet-OGC-API à l'aide du standard Common Query Language (CQL2) ! Cette documentation fournit des instructions complètes et des exemples pour construire des requêtes puissantes côté serveur sur nos collections de l'API OGC.

📖 Contenu de la documentation

• Bases de l'API OGC : Un aperçu des standards OGC API - Features et OGC API - Coverages, incluant les points d'accès principaux, les paramètres de requête courants (format, boîte englobante, datetime) et les stratégies de pagination.
• Filtrage CQL2 : Des instructions détaillées sur l'utilisation du paramètre de requête ?filter pour construire des requêtes expressives côté serveur qui réduisent la quantité de données retournées et récupèrent uniquement les entités d'intérêt.
• Filtrage spatial, temporel et par propriété : Des exemples étape par étape pour filtrer par boîte englobante, plages de dates, et propriétés spécifiques aux collections, avec la possibilité de combiner plusieurs paramètres de filtrage.

🔍 Capacités de filtrage CQL2

• Correspondances exactes : Filtrer les entités pour lesquelles un attribut a une valeur exacte (p. ex., numéro de station, type de bulletin).
• Recherches par mots-clés partiels : Utiliser l'opérateur LIKE avec les caractères génériques % pour une recherche textuelle flexible dans les valeurs d'attributs.
• Opérateurs de comparaison : Filtrer les valeurs numériques ou temporelles à l'aide de >, <, >=, <= et BETWEEN.
• Opérateurs logiques : Combiner les conditions avec AND, OR et NOT pour des requêtes précises à critères multiples.
• Prédicats spatiaux : Utiliser INTERSECTS, DISJOINT et BBOX pour filtrer les entités en fonction de la géométrie et de la localisation géographique.

💡 Exemples pratiques inclus

       La documentation comprend un large éventail d'exemples concrets, allant de requêtes simples à paramètre unique à des filtres complexes à paramètres multiples, incluant :

• Recherche de bulletins météorologiques par type, bureau émetteur ou identifiant.
• Filtrage des observations climatiques par plages de température, vent, humidité et précipitations.
• Identification de régions à risque élevé de feux de forêt à l'aide de critères météorologiques combinés.
• Requêtes sur les observations de la Cote air santé (CAS) dans des zones géographiques spécifiques.
• Utilisation de commandes curl et de scripts Python avec le module pygeofilter pour un accès programmatique.

Accédez à la documentation complète : https://eccc-msc.github.io/open-data/msc-geomet/ogc_api_fr/#ogc-api-filtrage-avance-avec-cql2

Nous espérons que cette nouvelle documentation vous aidera à tirer le meilleur parti des puissantes capacités de filtrage de GeoMet-OGC-API. Comme toujours, nous accueillons vos commentaires !

Salutations sincères,

L'équipe de développement de GeoMet du SMC