En français

ECCC logo

TOC > Usage overview

Usage overview

Overview and examples on how to access and use Meteorological Service of Canada open data.

Learn about the available data

The Meteorological Service of Canada provides up-to-date information on past, present and future weather conditions, climate, water and environmental information over Canada and the world. The list of available data is provided here.

How to visualize the data

MSC AniMet

MSC AniMet is a simple tool enabling users to interact with MSC Open Data weather data and create custom weather animations for any area in the world. The resulting animations can be downloaded and shared with a permalink.

Desktop software

MSC open data can be visualized in desktop software by either (A) connecting to MSC GeoMet Web Map Service (WMS) web services or (B) by downloading the raw data from MSC Datamart or MSC GeoMet Web Coverage Service (WCS) and OGC API- Features (WFS 3) web services and loading the raw data in the application.

MSC open data can be interactively visualized in software that supports the Open Geospatial Consortium (OGC) Web Map Service (WMS) standard such as the free and open source software QGIS and in Esri ArcGIS software. Instructions for adding MSC GeoMet WMS services to QGIS and ArcGIS are available. Desktop software may allow users to change the layer colors (WMS styles) and animate the layers amongst the available timesteps. Details on the available WMS parameters are available in the web services section. For downloading raw data, refer to the How to access raw data section.

The following tutorials are available for the QGIS desktop software: add, query and animate WMS layers, add and query OGC API Features layers and add raw data. The following image presents the root of the GeoMet-Weather layer tree in QGIS:

GeoMet-Weather layer tree in QGIS

Interactive web maps and mobile apps

MSC open data can also easily be integrated into interactive maps in browsers and mobile applications.

In a web browser

By using JavaScript libraries such as Leaflet and Openlayers, amongst others, users can integrate data available via MSC GeoMet into their own interactive web maps.

The following tutorial is available for creating interactive web maps with OpenLayers and Leaflet, demonstrating how to add layers, display popup dialog boxes and animate temporal layers.

Below is an example of an OpenLayers web map configured to display weather radar composite Web Map Service (WMS) layers served by MSC GeoMet.

In a mobile application

MSC Geomet Web Map Services (WMS) can also be integrated into mobile applications, with JavaScript libraries such as Leaflet and Openlayers among others. In fact, Environment and Climate Change Canada's WeatherCAN application (available on iOS and Android) uses MSC GeoMet to display high resolution weather radar data on an interactive map:

Example of radar imagery in WeatherCan

For additional information regarding the capabilities and parameters for MSC GeoMet web services (ie. WMS, WCS) refer to the technical MSC GeoMet web services documentation.

On-demand images

MSC Geomet can also serve images on-demand via a WMS GetMap request. See the examples below.

Example 1 - Global Deterministic Prediction System (GDPS) Surface Temperature

The following WMS GetMap request returns an image of the Global Deterministic Prediction System (GDPS) air temperature layer. The image is created on-demand at the time of the request.

https://geo.weather.gc.ca/geomet?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&BBOX=-90,-180,90,180
&CRS=EPSG:4326&WIDTH=600&HEIGHT=301&LAYERS=GDPS.ETA_TT&FORMAT=image/png

Returns:

Global Deterministic Prediction System (GDPS) surface temperature

Example 2 - Global Ice Ocean Prediction System (GIOPS) Sea Water Salinity

The following WMS GetMap request returns an image of the Global Ice Ocean Prediction System (GIOPS) sea water salinity layer. The image is created on-demand at the time of the request.

https://geo.weather.gc.ca/geomet?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetMap&BBOX=-90,-180,90,180
&CRS=EPSG:4326&WIDTH=600&HEIGHT=301&LAYERS=OCEAN.GIOPS.2D_SALW&FORMAT=image/png

Returns:

Sea Water Salinity from the Global Ice Ocean Prediction System (GIOPS) model

Overview of WMS GetMap parameters used in the examples

The examples above define a handful of parameters and send a GetMap request to MSC GeoMet. Below is a short explanation of each parameter in the request:

  • SERVICE - The name of the Open GeoSpatial Consortium Web Service to use in the request. In both examples, the OGC Web Map Service (WMS) is used
  • VERSION - The service version, in this case 1.3.0
  • REQUEST - The specified request type. The WMS services specifies several different request types. In this case, a GetMap request is specified, which returns a map image
  • BBOX - The bounding box of the requested image. In our case, we are making a request for an image that covers the entire surface of the Earth. Coordinates are provided in the units of the Coordinate Reference System defined in the following parameter
  • CRS - The coordinate reference system (CRS) used to create the map image. In both examples, we set the CRS to EPSG:4326 (i.e. WGS 84), the coordinate reference system used for the Global Positioning System (GPS)
  • WIDTH - The width in pixels of the returned image
  • HEIGHT - The height in pixels of the returned image
  • LAYERS - The name of the layer used to create the image. The list and name of the available layers can be retrieved using a WMS GetCapabilities request. For best performances, it is recommended to specify one layer per WMS GetMap request
  • FORMAT - The format of the image returned by the WMS GetMap request. In both cases case, the returned image will be in the PNG format

For further information regarding these and other WMS GetMap parameters, refer to the technical MSC GeoMet web services documentation.

How to access raw data

Raw data web services

Raw MSC data can be retrieved from the MSC GeoMet web services. These web services allow users to retrieve raw data by specifying the geographic coordinates, the cartographic projection, the temporal dimensions and choose amongst available data formats. Details on the available parameters are provided in the web services section of the technical documentation.

The following use case examples are provided:

Raw data at specific geographic locations can be retrieved with a Web Map Service (WMS) GetFeatureInfo request. Details are provided in the technical documentation. Example of a WMS GetFeatureInfo request for temperature from the Global Deterministic Prediction System (GDPS) model over Montreal, Canada.

Raw data for vector data can be retrieved with a OGC API - Features (WFS 3) request. Example of a WFS 3 query for the Winnipeg River hydrometric station daily means which returns the corresponding data as a GeoJSON file.

Raw data for raster data can be retrieved with a Web Coverage Service (WCS) request. Example of a WCS 2 query for the Regional Deterministic Precipitation Analysis (RDPA) model in the netCDF format for a specific time. A tutorial is available for saving a WCS request output to disk. A tip to build WCS queries is to use the Canadian Centre for Climate Services WCS Query builder interface for an RDPA layer and replace the COVERAGEID value from RDPA.* to another available layer.

Raw data download

MSC raw data can be automatically retrieved as soon as it becomes available on the MSC Datamart through the Advanced Message Queuing Protocol (AMQP). Alternatively, the raw data can also be directly downloaded on the web from the MSC Datamart data repository.

Work with raw data from the command line

Data can be manipulated using commands from the GDAL software library. A tutorial showcasing the most common commands of the GDAL software library is available.