New Documentation: Advanced Filtering with CQL2 on GeoMet-OGC-API // Nouvelle documentation : Filtrage avancé avec CQL2 sur GeoMet-OGC-API
by Announcement list for the MSC-Datamart. Liste d'information pour le Datamart du SMC
(English follows)
Chers usagers des données ouvertes du SMC,
J’aimerais porter à votre attention cette annonce ci-dessous adressée aux usagers de nos services web géospatiaux concernant l’ajout de documentation autour de fonctionnalités reliées à GeoMet-OGC-API.
Plus particulièrement, il est expliqué comment utiliser notre API pour la recherche de données avec filtrage avancé, telle que la recherche de bulletins<https://eccc-msc.github.io/open-data/msc-data/bulletins/readme_bulletins_fr/>. Le script PERL<https://dd.meteo.gc.ca/today/bulletins/doc/CMC_Bulletin_Search_Help_fr.pdf>, actuellement disponible sur le Datamart du SMC<https://dd.meteo.gc.ca/today/bulletins/doc/> n’étant plus maintenu et désuet, nous encourageons vivement nos usagers à migrer vers ces services, maintenant documentés en détail. Une annonce sera envoyée lorsque ce script sera retiré de nos services.
Merci de nous faire part de toute question ou commentaire afin de nous aider à améliorer notre documentation.
Bonne lecture et excellent week-end.
Cordialement,
Sandrine
===================
Dear MSC open data users,
I would like to bring to your attention this announcement below addressed to users of our geospatial web services concerning the addition of documentation on features related to GeoMet-OGC-API.
More specifically, it explains how to use our API for advanced data filtering , such as searching for bulletins<https://eccc-msc.github.io/open-data/msc-data/bulletins/readme_bulletins_en/>. As the PERL script<https://dd.meteo.gc.ca/today/bulletins/doc/CMC_Bulletin_Search_Help_en.pdf> currently available on the MSC Datamart<https://dd.weather.gc.ca/today/bulletins/doc/> is no longer maintained and is obsolete, we strongly encourage our users to migrate to these services, which are now documented in detail. An announcement will be sent when this script is removed from our services.
Please send us any questions or comments you may have to help us improve our documentation.
Enjoy reading and have a great weekend.
Best regards,
Sandrine
------------
Sandrine Edouard
Responsable d'unité, Intendance des données et accès aux données ouvertes du SMC
Direction des Opérations du Centre canadien de prévision météorologique et environnementale
Environnement et Changement climatique Canada, Gouvernement du Canada
dps-client(a)ec.gc.ca<mailto:dps-client@ec.gc.ca> / Tél (M365) : 1-438-801 0700
Liste de diffusion dd_info : https://comm.collab.science.gc.ca/mailman3/postorius/lists/dd_info
Unit Manager, Data Stewardship and MSC Open Data Access
Canadian Centre for Meteorological and Environmental Prediction Operations
Environment and Climate Change Canada, Government of Canada
dps-client(a)ec.gc.ca<mailto:dps-client@ec.gc.ca> / Phone (M365): 1-438-801 0700
dd_info mailing list: https://comm.collab.science.gc.ca/mailman3/postorius/lists/dd_info
[cid:image001.png@01DC9CC9.5412A5A0]
From: geomet-info(a)comm.collab.science.gc.ca<mailto:geomet-info@comm.collab.science.gc.ca> <geomet-info(a)comm.collab.science.gc.ca<mailto:geomet-info@comm.collab.science.gc.ca>>
Sent: Wednesday, February 11, 2026 9:49 AM
To: Announcements mailing list for users of MSC GeoMet API / geospatial web services. Liste de distribution d'information pour les usagers de l'API / services web géospatiaux GeoMet du SMC. <geomet-info(a)comm.collab.science.gc.ca<mailto:geomet-info@comm.collab.science.gc.ca>>
Subject: [GeoMet-Info] New Documentation: Advanced Filtering with CQL2 on GeoMet-OGC-API // Nouvelle documentation : Filtrage avancé avec CQL2 sur GeoMet-OGC-API
[ 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