Share via


Electricity Maps (Independent Publisher) (Preview)

You can use Electricity Maps API to get information about where the electricity in a specific area comes from, how much carbon was emitted to produce it, and to get historical data, live data and forecasts.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Vitalii Sorokin
URL https://www.electricitymaps.com/
Email sorokindva@gmail.com
Connector Metadata
Publisher Vitalii Sorokin
Website https://www.electricitymaps.com/
Privacy policy https://www.electricitymaps.com/privacy-policy
Categories Data

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True
Base Product URL string The base URL of subscribed product at Electricity Maps True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Check API Health

Verify that the Electricity Maps API is up.

Get Available Zones

A list of countries and zones by code (zone being the country is divided by zones seen on app.electricitymap.org).

Get Carbon Intensity Forecast

Retrieves the forecasted carbon intensity (in gCO2eq/kWh) of an area. It can either be queried by zone identifier or by geolocation.

Get Carbon Intensity History

Retrieves the last 24h of carbon intensity (in gCO2eq/kWh) of an area. It can either be queried by zone identifier or by geolocation. The resolution is 60 minutes.

Get Live Carbon Intensity

Retrieves the last known carbon intensity (in gCO2eq/kWh) of electricity consumed in an area. It can either be queried by zone identifier or by geolocation.

Get Live Power Breakdown

Retrieves the last known data about the origin of electricity in an area.

Get Power Breakdown History

Retrieves the last 24h of power consumption and production breakdown of an area, which represents the physical origin of electricity broken down by production type. It can either be queried by zone identifier or by geolocation. The resolution is 60 minutes.

Get Power Consumption Forecast

Retrieves the forecasted power consumption breakdown of an area, which represents the physical origin of electricity broken down by production type. It can either be queried by zone identifier or by geolocation.

Get Power Production Forecast

Retrieves the forecasted power production breakdown of an area by production type. It can either be queried by zone identifier or by geolocation.

Check API Health

Verify that the Electricity Maps API is up.

Returns

Name Path Type Description
State
monitors.state string

Current API State.

Status
status string

Current API Status.

Get Available Zones

A list of countries and zones by code (zone being the country is divided by zones seen on app.electricitymap.org).

Returns

Name Path Type Description
Zones
Zones array of object

Zone List.

Name
Zones.Name string

Name

Zone Name
Zones.Details.zoneName string

Name of zone.

Country Name
Zones.Details.countryName string

Name of country.

Get Carbon Intensity Forecast

Retrieves the forecasted carbon intensity (in gCO2eq/kWh) of an area. It can either be queried by zone identifier or by geolocation.

Parameters

Name Key Required Type Description
Country or Zone
zone string

A string representing the zone identifier.

Longitude
lon string

Longitude(if querying with a geolocation).

Latitude
lat string

Latitude (if querying with a geolocation).

Returns

Name Path Type Description
Forecasts
forecast array of object

Array of carbon intensity forecasts.

Carbon Intensity
forecast.carbonIntensity number

Forecasted carbon intensity (gCO2eq/kWh).

Date and Time
forecast.datetime string

Forecast datetime in ISO format.

Updated At
updatedAt string

Date and time when data has been updated.

Zone
zone string

Country or Zone.

Get Carbon Intensity History

Retrieves the last 24h of carbon intensity (in gCO2eq/kWh) of an area. It can either be queried by zone identifier or by geolocation. The resolution is 60 minutes.

Parameters

Name Key Required Type Description
Country or Zone
zone string

A string representing the zone identifier.

Longitude
lon string

Longitude(if querying with a geolocation).

Latitude
lat string

Latitude (if querying with a geolocation).

Emission Factor Type
emissionFactorType string

Type of emission factors used for computing the carbon intensity.

Disable Estimated Data
disableEstimations boolean

If estimated data should be disabled.

Returns

Name Path Type Description
History
history array of object

Array of carbon intensity history records.

Carbon Intensity
history.carbonIntensity number

Historical carbon intensity value(gCO2eq/kWh).

Created At
history.createdAt string

Date and time when record was created.

Date and Time
history.datetime string

Date and time for current carbon intensity.

Emission Factor Type
history.emissionFactorType string

Type of emission factors used for computing the carbon intensity.

Estimation Method
history.estimationMethod string

Estimation method used for computing the carbon intensity.

Is Estimated
history.isEstimated boolean

Was estimated method enabled.

Updated At
history.updatedAt string

Date and time when record was updated.

Zone
zone string

Country or Zone.

Get Live Carbon Intensity

Retrieves the last known carbon intensity (in gCO2eq/kWh) of electricity consumed in an area. It can either be queried by zone identifier or by geolocation.

Parameters

Name Key Required Type Description
Country or Zone
zone string

A string representing the zone identifier.

Longitude
lon string

Longitude(if querying with a geolocation).

Latitude
lat string

Latitude (if querying with a geolocation).

Emission Factor Type
emissionFactorType string

Type of emission factors used for computing the carbon intensity.

Disable Estimated Data
disableEstimations boolean

If estimated data should be disabled.

Returns

Name Path Type Description
Carbon Intensity
carbonIntensity number

Live carbon intensity value(gCO2eq/kWh).

Date and Time
datetime string

Date and time for current carbon intensity.

Emission Factor Type
emissionFactorType string

Type of emission factors used for computing the carbon intensity.

Estimation Method
estimationMethod string

Estimation method used for computing the carbon intensity.

Is Estimated
isEstimated boolean

Was estimated method enabled.

Updated At
updatedAt string

Date and time when record was updated.

Zone
zone string

Country or Zone.

Get Live Power Breakdown

Retrieves the last known data about the origin of electricity in an area.

Parameters

Name Key Required Type Description
Country or Zone
zone string

A string representing the zone identifier.

Longitude
lon string

Longitude(if querying with a geolocation).

Latitude
lat string

Latitude (if querying with a geolocation).

Disable Estimated Data
disableEstimations boolean

If estimated data should be disabled.

Returns

Name Path Type Description
Created At
createdAt string

Date and time when data has been created.

Date and Time
datetime string

Date and time for current power breakdown.

Estimation Method
estimationMethod string

Estimation method used for computing the power breakdown.

Fossil Free Percentage
fossilFreePercentage number

Percentage of the power consumption breakdown coming from renewables or fossil-free power plants.

Is Estimated
isEstimated boolean

Was estimated method enabled.

Battery Discharge
powerConsumptionBreakdown.battery discharge number

Battery discharge consumption in MW.

Biomass
powerConsumptionBreakdown.biomass number

Biomass power consumption(in MW).

Coal
powerConsumptionBreakdown.coal number

Coal power consumption(in MW).

Gas
powerConsumptionBreakdown.gas number

Gas power consumption(in MW).

Geothermal
powerConsumptionBreakdown.geothermal number

Geothermal power consumption(in MW).

Hydro
powerConsumptionBreakdown.hydro number

Hydro power consumption(in MW).

Hydro Discharge
powerConsumptionBreakdown.hydro discharge number

Hydro discharge consumption(in MW).

Nuclear
powerConsumptionBreakdown.nuclear number

Nuclear power consumption(in MW).

Oil
powerConsumptionBreakdown.oil number

Oil power consumption(in MW).

Solar
powerConsumptionBreakdown.solar number

Solar power consumption(in MW).

Unknown
powerConsumptionBreakdown.unknown number

Unknown power consumption(in MW).

Wind
powerConsumptionBreakdown.wind number

Wind power consumption(in MW).

Total Consumption
powerConsumptionTotal number

Power Consumption Total(in MW).

Power Export Total
powerExportTotal number

Total Power Export(in MW).

Power Import Total
powerImportTotal number

Total Power Import (in MW).

Battery Discharge
powerProductionBreakdown.battery discharge number

Battery discharge production in MW.

Biomass
powerProductionBreakdown.biomass number

Biomass power production in MW.

Coal
powerProductionBreakdown.coal number

Coal power production in MW.

Gas
powerProductionBreakdown.gas number

Gas power production in MW.

Geothermal
powerProductionBreakdown.geothermal number

Geothermal power production in MW.

Hydro
powerProductionBreakdown.hydro number

Hydro power production in MW.

Hydro discharge
powerProductionBreakdown.hydro discharge number

Hydro discharge production in MW.

Nuclear
powerProductionBreakdown.nuclear number

Nuclear power production in MW.

Oil
powerProductionBreakdown.oil number

Oil power production in MW.

Solar
powerProductionBreakdown.solar number

Solar power production in MW.

Unknown
powerProductionBreakdown.unknown number

Unknown power production in MW.

Wind
powerProductionBreakdown.wind number

Wind power production in MW.

Total Production
powerProductionTotal number

Power Production Total(in MW).

Renewables Percentage
renewablePercentage number

Percentage of renewable energy.

Updated At
updatedAt string

Date and time when data has been updated.

Zone
zone string

Country or Zone.

Get Power Breakdown History

Retrieves the last 24h of power consumption and production breakdown of an area, which represents the physical origin of electricity broken down by production type. It can either be queried by zone identifier or by geolocation. The resolution is 60 minutes.

Parameters

Name Key Required Type Description
Country or Zone
zone string

A string representing the zone identifier.

Longitude
lon string

Longitude(if querying with a geolocation).

Latitude
lat string

Latitude (if querying with a geolocation).

Disable Estimated Data
disableEstimations boolean

If estimated data should be disabled.

Returns

Name Path Type Description
history
history array of object
Date and Time
history.datetime string

Power breakdown data date and time.

Estimation Method
history.estimationMethod string

Estimation method used for computing the power breakdown.

Fossil Free Percentage
history.fossilFreePercentage number

Percentage of the power consumption breakdown coming from renewables or fossil-free power plants.

Is Estimated
history.isEstimated boolean

Was estimated method enabled.

Battery Discharge
history.powerConsumptionBreakdown.battery discharge number

Battery discharge consumption in MW.

Biomass
history.powerConsumptionBreakdown.biomass number

Biomass power consumption(in MW).

Coal
history.powerConsumptionBreakdown.coal number

Coal power consumption(in MW).

Gas
history.powerConsumptionBreakdown.gas number

Gas power consumption(in MW).

Geothermal
history.powerConsumptionBreakdown.geothermal number

Geothermal power consumption(in MW).

Hydro
history.powerConsumptionBreakdown.hydro number

Hydro power consumption(in MW).

Hydro Discharge
history.powerConsumptionBreakdown.hydro discharge number

Hydro discharge consumption(in MW).

Nuclear
history.powerConsumptionBreakdown.nuclear number

Nuclear power consumption(in MW).

Oil
history.powerConsumptionBreakdown.oil number

Oil power consumption(in MW).

Solar
history.powerConsumptionBreakdown.solar number

Solar power consumption(in MW).

Unknown
history.powerConsumptionBreakdown.unknown number

Unknown power consumption(in MW).

Wind
history.powerConsumptionBreakdown.wind number

Wind power consumption(in MW).

Total Consumption
history.powerConsumptionTotal number

Power Consumption Total(in MW).

Power Export Total
history.powerExportTotal number

Total Power Export(in MW).

Power Import Total
history.powerImportTotal number

Total Power Import (in MW).

Battery Discharge
history.powerProductionBreakdown.battery discharge number

Battery discharge production in MW.

Biomass
history.powerProductionBreakdown.biomass number

Biomass power production in MW.

Coal
history.powerProductionBreakdown.coal number

Coal power production in MW.

Gas
history.powerProductionBreakdown.gas number

Gas power production in MW.

Geothermal
history.powerProductionBreakdown.geothermal number

Geothermal power production in MW.

Hydro
history.powerProductionBreakdown.hydro number

Hydro power production in MW.

Hydro discharge
history.powerProductionBreakdown.hydro discharge number

Hydro discharge production in MW.

Nuclear
history.powerProductionBreakdown.nuclear number

Nuclear power production in MW.

Oil
history.powerProductionBreakdown.oil number

Oil power production in MW.

Solar
history.powerProductionBreakdown.solar number

Solar power production in MW.

Unknown
history.powerProductionBreakdown.unknown number

Unknown power production in MW.

Wind
history.powerProductionBreakdown.wind number

Wind power production in MW.

Total Production
history.powerProductionTotal number

Power Production Total(in MW).

Renewables Percentage
history.renewablePercentage number

Percentage of renewable energy.

Zone
zone string

Country or Zone.

Get Power Consumption Forecast

Retrieves the forecasted power consumption breakdown of an area, which represents the physical origin of electricity broken down by production type. It can either be queried by zone identifier or by geolocation.

Parameters

Name Key Required Type Description
Country or Zone
zone string

A string representing the zone identifier.

Longitude
lon string

Longitude(if querying with a geolocation).

Latitude
lat string

Latitude (if querying with a geolocation).

Returns

Name Path Type Description
Power Consumption Forecast
forecast array of object

Power Consumption forecast data.

Date and Time
forecast.datetime string

Date and time for the forecast.

Biomass
forecast.powerConsumptionBreakdown.biomass number

Biomass power consumption forecast.

Coal
forecast.powerConsumptionBreakdown.coal number

Coal power consumption forecast.

Gas
forecast.powerConsumptionBreakdown.gas number

Gas power consumption forecast.

Hydro
forecast.powerConsumptionBreakdown.hydro number

Hydro power consumption forecast.

Nuclear
forecast.powerConsumptionBreakdown.nuclear number

Nuclear power consumption forecast.

Solar
forecast.powerConsumptionBreakdown.solar number

Solar power consumption forecast.

Unknown
forecast.powerConsumptionBreakdown.unknown number

Unknown power consumption forecast.

Wind
forecast.powerConsumptionBreakdown.wind number

Wind power consumption forecast.

Total Consumption
forecast.powerConsumptionTotal number

Power Consumption Total Forecast.

Updated At
updatedAt string

Date and time when forecast has been updated.

Zone
zone string

Country or Zone.

Get Power Production Forecast

Retrieves the forecasted power production breakdown of an area by production type. It can either be queried by zone identifier or by geolocation.

Parameters

Name Key Required Type Description
Country or Zone
zone string

A string representing the zone identifier.

Longitude
lon string

Longitude(if querying with a geolocation).

Latitude
lat string

Latitude (if querying with a geolocation).

Returns

Name Path Type Description
Power Production Forecast
forecast array of object

Power Production forecast data.

Date and Time
forecast.datetime string

Date and time for the forecast.

Biomass
forecast.powerProductionBreakdown.biomass number

Biomass power production forecast.

Coal
forecast.powerProductionBreakdown.coal number

Coal power production forecast.

Gas
forecast.powerProductionBreakdown.gas number

Gas power production forecast.

Hydro
forecast.powerProductionBreakdown.hydro number

Hydro power production forecast.

Nuclear
forecast.powerProductionBreakdown.nuclear number

Nuclear power production forecast.

Oil
forecast.powerProductionBreakdown.oil number

Oil power production forecast.

Solar
forecast.powerProductionBreakdown.solar number

Solar power production forecast.

Unknown
forecast.powerProductionBreakdown.unknown number

Unknown power production forecast.

Wind
forecast.powerProductionBreakdown.wind number

Wind power production forecast.

Total Production
forecast.powerProductionTotal number

Power Production Total Forecast.

Updated At
updatedAt string

Date and time when forecast has been updated.

Zone
zone string

Country or Zone.