New Documentation: Advanced Filtering with CQL2 on GeoMet-OGC-API // Nouvelle documentation : Filtrage avancé avec CQL2 sur GeoMet-OGC-API
by Pelletier,Étienne (ECCC)
[ 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