2:37 p.m.
[ 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