Ongoing outages and planned service interruptions

Description

Ongoing outages. All of Hydro-Québec’s data used to obtain the following information, in real time, for each ongoing outage:

  • The geographic location of the outage
  • The number of customers without electricity
  • The start time of the outage
  • The cause of the outage, when known
  • When service is expected to be restored

Planned service interruptions. All of Hydro-Québec’s data used to know what service interruptions are planned in the coming days and to obtain the following information for each one:

  • The geographic location of the planned service interruption
  • The number of customers affected
  • The date and times of the interruption and when service is expected to be restored

Files or services

Access to open data is obtained through queries in an application programming interface (API). For more information, consult the Données Québec [in French only] site.

Ongoing outages – API mode

This mode requires the use of three REST-style URLs.

First query: Obtain the updated version of the BIS file (“time stamp”)

Click on the URL below to obtain the service interruption report (BIS) file number.

URL: http://pannes.hydroquebec.com/pannes/donnees/v3_0/bisversion.json

Example of number: 20180418084019.

Second query: Obtain a JSON file containing the list of outages

Add the file number obtained for the previous request at the end of the following URL.

URL: http://pannes.hydroquebec.com/pannes/donnees/v3_0/bismarkers{BIS_VERSION}.json

Example :
http://pannes.hydroquebec.com/pannes/donnees/v3_0/bismarkers20180418084019.json

The list of outages specifies the date of the outage, the time at whichservice is expected to be restored and the geographic coordinates (latitude and longitude) of the area affected.

Sample of the data associated with an outage:

{ "messages": {}, "pannes": [

[ 2, "2018-04-19 10:13:03", "2018-04-19 11:15:00", "P", "[-74.03666800098304, 45.63760774828376]", "L", "4", "44", "9001", "" ],

[ 1, "2018-04-19 08:24:30", "2018-04-19 12:15:00", "P", "[-70.69765492300203, 46.50093403672063]", "L", "4", "44", "7509", "" ],

Interpreting the data

messages: Communication messages

pannes: Number of customers affected by the outage

YYYY-MM-DD HH:MM:SS: Date and start time of the outage (24-hour clock)

YYYY-MM-DD HH:MM:SS: Expected end date of the outage and estimated time the outage will end

P: Outage

[-73.00751272875362, 46.19771470407507]: Coordinates of the outage area

Data associated with the outage status

A: Work assigned

L: Crew at work

R: Crew on the way

"defaut": ""

Data to ignore

4

Data associated with the cause of the outage

11, 12, 13, 14,15, 58, 70, 72, 73, 74, 79 or defaut: Equipment failure

21, 22, 24, 25 ou 26: Weather conditions

31, 32, 33, 34, 41, 42, 43, 44, 54, 55, 56 ou 57: Accident or incident

51: Damage due to vegetation

52 ou 53: Damage caused by an animal

1111: Identifier of the municipality affected

"(number)": Identifier of the outage message

Third query: Download the KMZ file that provides the list of polygons representing the outage areas

Add the file number obtained for the first request to the following URL.

URL: http://pannes.hydroquebec.com/pannes/donnees/v3_0/bispoly{BIS_VERSION}.kmz

Example :

http://pannes.hydroquebec.com/pannes/donnees/v3_0/bispoly20180418084019.kmz

Once the KMZ file is unzipped, open the KML files using a specialized tool such as Google Earth.

Upcoming planned service interruptions – API mode

This mode requires the use of three REST-style URLs.

First query: Obtain the updated version of the AIP file (“time stamp”)

Click on the URL below to obtain the planned service interruption notice (AIP) file number.

http://pannes.hydroquebec.com/pannes/donnees/v3_0/aipversion.json

Second query: Obtain the list of upcoming planned service interruptions (“aipmarkers”)

Add the file number received for the previous request to the following URL.

URL: http://pannes.hydroquebec.com/pannes/donnees/v3_0/aipmarkers{AIP_VERSION}.json

Result: A JSON file is obtained.

Interpreting the data

(number): Number of customers affected by the interruption

(number): Service interruption notice number

YYYY-MM-DD HH:MM:SS: Scheduled start date and time of service interruption

YYYY-MM-DD HH:MM:SS: Scheduled end date and time of service interruption

YYYY-MM-DD HH:MM:SS: Actual start date and time of service interruption

YYYY-MM-DD HH:MM:SS: Actual end date and time of service interruption

YYYY-MM-DD HH:MM:SS: Postponed start date and time of service interruption

YYYY-MM-DD HH:MM:SS: Postponed end date and time of service interruption

YYYY-MM-DD HH:MM:SS: Delayed start date and time of service interruption

YYYY-MM-DD HH:MM:SS: Delayed end date and time of service interruption

Data associated with the cause of the service interruption

11, 12, 13, 14, 58, 70, 72, 73, 74, 79 or defaut: Equipment failure

21, 22, 24, 25 ou 26: Weather conditions

31, 32, 33, 34, 41, 42, 43, 44, 54, 55, 56 ou 57: Accident or incident

51: Damage due to vegetation

52: Damage caused by an animal

53: Damage caused by an animal

10: Equipment code

"(number)": Comment code

1111: Identifier of the municipality

Data associated with the status of the service interruption

A: Work assigned

L: Crew at work

R: Crew on the way

"defaut": ""

[-72.77551433674611, 45.38822735653758]: Coordinates of the service interruption area

Third query: Obtain the KMZ file that provides the list of polygons representing the planned service interruption areas (“aippoly”)

Add the file number obtained for the first request to the following URL.

URL: http://pannes.hydroquebec.com/pannes/donnees/v3_0/aippoly{AIP_VERSION}.kmz

Once the KMZ file is unzipped, open the KML files using a specialized tool such as Google Earth.

Ongoing outages – archive mode

Download the files in KMZ format regarding the outages for the day in question

Open the files using a specialized tool such as Google Earth.

Additional information

  • Editor/Author: Hydro‑Québec
  • Update frequency: 15 minutes
  • Language: French
  • Geographic coverage: Province of Québec, except Alma, Amos, Baie-Comeau, Coaticook, Joliette, Magog, Saguenay, Sherbrooke and Westmount (municipal systems), the territory served by the Coopérative régionale d’électricité de Saint-Jean-Baptiste-de-Rouville (cooperative system) as well as regions supplied by off‑grid systems.
  • Initial distribution: 2018-04-23
  • Licence : Creative Commons CC‑BY‑NC 4.0
  • Notices and conditions of use: :
    • Certain outage areas may not be listed on the maps. Those that are and the times at which service is expected to be restored are approximate, as is the rest of the information (e.g., cause, number of customers affected, etc.).
    • The service status by region indicates the number of customers without power in each region of Québec. It includes the power outages and planned service interruptions that are currently underway. Unlike a power outage, a planned service interruption is an intentional interruption of service for a set period of time to carry out system maintenance.
    • All persons must take the necessary steps to mitigate damage that may be caused by an outage.