[ 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<https://api.weather.gc.ca/> 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-advan... 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<https://api.weather.gc.ca/?lang=fr> à 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-filtr... 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