Services Web maintenant offerts par le Service hydrographique du Canada

Services Web donnant accès aux données officielles pour la navigation de courants de surface et niveaux d’eau modélisés.

Conditions d'utilisation du site Web public des marées, courants et niveaux d'eau

Si vous désirez utiliser les services Web offerts par le Service hydrographique du Canada et le site Web public des marées, courants et niveaux d'eau, veuillez lire le contrat de licence.

Si vous acceptez les modalités du Service hydrographique du Canada et du contrat de licence du site Web public sur les marées, courants et niveaux d'eau, veuillez cliquer sur le bouton "J'accepte".

L’accès au service web pour la navigation de courants de surface modélisés et la couverture géographique a été désactivé le 16 juin 2022.

Les données sont encore disponibles.

La documentation est disponible auprès d’Environnement et Changement climatique Canada.

Sur cette page

Documentation (de l’interface Rest-API)

Le SHC est présentement en processus de transformation dans toutes ses activités de livraison des produits et services. Deux des éléments essentiels sur lesquels travaille le SHC, concernent la modernisation de la base de données des niveaux d’eau (observations, prévisions, prédictions) et le développement de nouveaux services de diffusion de ces données dont cette interface de programmation REST-API.

Pour recevoir des informations et des avis de mise à jour de cette interface, veuillez nous transmettre votre nom et courriel à l’adresse suivante : shcinfo@dfo-mpo.gc.ca.

Afin de vous familiariser avec ce nouvel API public, les usagers peuvent parcourir la documentation disponible en anglais seulement sur le site Web suivant : https://api-iwls.dfo-mpo.gc.ca/swagger-ui.html.

Exemple :

  1. Pour trouver les identifiants (ID) de vos stations d’intérêts : https://api-iwls.dfo-mpo.gc.ca/api/v1/stations.
  2. Utiliser la requête suivante pour obtenir les niveaux d’eau officiels (wlo) pour la station Vieux-Québec (ID code : 5cebf1e23d0f4a073c4bc0f6) du 1er au 2 octobre 2020 : https://api-iwls.dfo-mpo.gc.ca/api/v1/stations/5cebf1e23d0f4a073c4bc0f6/data?time-series-code=wlo&from=2020-10-01T00:00:00Z&to=2020-10-01T00:30:00Z
      
    [{"eventDate":"2020-10-01T00:00:00Z","qcFlagCode":"1","value":3.903,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:03:00Z","qcFlagCode":"1","value":3.865,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:06:00Z","qcFlagCode":"1","value":3.825,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:09:00Z","qcFlagCode":"1","value":3.784,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:12:00Z","qcFlagCode":"1","value":3.743,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:15:00Z","qcFlagCode":"1","value":3.7,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:18:00Z","qcFlagCode":"1","value":3.661,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:21:00Z","qcFlagCode":"1","value":3.62,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:24:00Z","qcFlagCode":"1","value":3.578,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:27:00Z","qcFlagCode":"1","value":3.538,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true},
{"eventDate":"2020-10-01T00:30:00Z","qcFlagCode":"1","value":3.495,"timeSeriesId":"5cebf1e23d0f4a073c4bc0e1","reviewed":true}]
  3. Remplacer l’ID de la station “5cebf1e23d0f4a073c4bc0f6” par celui de votre station d’intérêt ;
  4. Changer la valeur du paramètre “Time-series-code” pour utiliser soit :
    • wlo – Niveau d’eau observé
    • wlf ou wlf-spine – Prévisions des niveaux d’eau (aux stations opérationnelles seulement)
    • wlp – Niveaux d’eau prédits aux 15 minutes
    • wlp-hilo – Prédictions des hautes et basses mers (Tables de marées)
  5. Ajuster la période de temps “From” et “To” en utilisant le format ISO 8061 UTC.

qcFlagCode

Les indicateurs utilisés à tous les niveaux de contrôle de la qualité s'inspirent des normes de l'UNESCO en matière de données océanographiques.

Valeur Indicateur Définition
1 Bon Test réussi de contrôle de qualité
2 Non évalué, non-disponible ou inconnu Utilisé pour les données dont les tests de contrôle de qualité n’ont pas été effectués ou l’information sur la qualité n’est pas disponible
3 Questionnable ou suspect Données dont les tests de contrôle de qualité non critiques ont échoué
4 Mauvais Données dont les tests de contrôle de qualité critiques ont échoué
9 Donnée manquante Utilisé comme substitut lorsque les données sont manquantes

Service Web donnant accès aux données de prévisions SPINE de niveaux d’eau

Spécifications techniques pour y accéder.

Ce document décrit les spécifications techniques pour accéder au service Web de prévisions et d’interpolation des niveaux d’eau entre Montréal et Saint-Joseph-de-la-Rive communément appelé SPINE.

Description

Le service Web de prévisions SPINE a été développé par le Service hydrographique du Canada (SHC) et est disponible gratuitement sous licence. Ce système permet d’obtenir les niveaux d’eau à un moment et une position spécifiée par l’usager, jusqu’à 30 jours dans le futur, pour le chenal de navigation du fleuve Saint-Laurent entre le port de Montréal et Saint-Joseph-de-la-Rive.

Ce système s’appuie, d’une part, sur les prévisions de niveaux d’eau qui sont basées sur un modèle hydrodynamique qui tient en compte diverses conditions météorologiques et, d’autre part, sur les observations en temps réel du réseau d’enregistreurs permanents de niveaux d’eau. Afin d'accroître la précision, les prévisions du modèle numérique sont ajustées aux observations de niveaux d'eau pour l'ensemble du secteur. De plus, une matrice de précision accompagne les données de prévision.

Afin d’accéder au service web il suffit de suivre les étapes décrites dans ces spécifications techniques.

Accès et restrictions

Veuillez prendre le temps de consulter la licence.

Données

Le service Web utilise SOAP et XML comme protocole de communication et la langue anglaise pour l’appel des méthodes et l’échange des données. Le service possède une description en XML accessible en langage WSDL (i.e. : https://ws-shc.qc.dfo-mpo.gc.ca/spine?wsdl). Cette description est utile pour générer automatiquement (à l’aide d’outils comme WSDL2Java d’Apache Axis) du code pour communiquer avec le service.

Date de modification :