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/ |
| 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. |