NREL (Independent Publisher) (Preview)

The National Renewable Energy Laboratory's developer network helps developers access and use energy data via Web services, including renewable energy and alternative fuel data. NREL is a national laboratory of the U.S. Department of Energy, Office of Energy Efficiency and Renewable Energy, operated by the Alliance for Sustainable Energy, LLC.

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 Troy Taylor
URL https://www.hitachisolutions.com
Email [email protected]
Connector Metadata
Publisher Troy Taylor
Website http://www.nrel.gov/
Privacy policy https://www.nrel.gov/security.html
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

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get all alternative fuel stations

Return a full list of alternative fuel stations that match your query.

Get an alternative fuel station by ID

Fetch the details of a specific alternative fuel station given the station's ID.

Get nearest alternative fuel station

Return the nearest alternative fuel stations within a distance of a given location.

Get solar resource data

Returns various types of solar data for US locations. The service currently returns data for average Direct Normal Irradiance, average Global Horizontal Irradiance, and average Tilt at Latitude.

Get standard work specifications

Retrieve standard work specification details for home energy upgrades.

Get utility rates

This service returns annual average utility rates ($/kWH) for residential, commercial and industrial sectors as well as the local utility name for a specific location. This service does not return complex rate information. The data source is Ventyx Research Inc. and the Energy Information Agency (EIA), and was updated with 2012 numbers.

Get utility rates by census region

Given a location and Census Bureau region level (block, blockgroup, tract), return the Census Bureau ID, utility rate and company information.

Query solar dataset

Returns information about data available for a given location for the solar resource database used by the PVWatts® Calculator and PVWatts v8 API.

Get all alternative fuel stations

Return a full list of alternative fuel stations that match your query.

Parameters

Name Key Required Type Description
Status
status string

Return stations that match the given status. A single status, or a comma-separated list of multiple statuses, may be given.

Access
access string

Return stations with the given access type.

Fuel Type
fuel_type string

Return stations that supply any of the given fuel types. A single fuel type, or a comma-separated list of multiple fuel types, may be given.

Cards Accepted
cards_accepted string

Return stations that accept any of the given payment methods. A single payment method, or a comma-separated list of multiple payment methods, may be given.

Owner Type
owner_type string

Return stations owned by the given types of owners. A single owner type, or a comma-separated list of multiple owner types, may be given.

Federal Agency
federal_agency string

Return stations owned by the given federal agency. A federal agency code, or a comma-separated list of multiple federal agency codes, may be given.

CNG Fill Type
cng_fill_type string

Return only CNG stations that provide the specified type of dispensing capability. A single type, or a comma separated list of multiple types, may be given.

CNG PSA
cng_psa string

Return only CNG stations that provide the specified PSI pressure. A single pressure level, or a comma separated list of multiple pressure levels, may be given.

CNG Vehicle Class
cng_vehicle_class string

Return only CNG stations that can accommodate the specified vehicle class size or greater.

E85 Has Blender Pump
e85_has_blender_pump string

If true, then return only E85 stations that also have a blender pump capable of providing mid-level ethanol blends.

EV Network
ev_network string

Return only electric charging stations that belong to the given network. A single network, or a comma separated list of multiple networks, may be given.

EV Charging Level
ev_charging_level string

Return only electric charging stations that provide the given level of electric vehicle supply equipment (EVSE).

EV Connector Type
ev_connector_type string

Return only electric charging stations that provide the given connector types.

HY Is Retail
hy_is_retail string

Return only hydrogen stations that match the value. A single retail value, or a comma-separated list of multiple retail values, may be given.

LNG Vehicle Class
lng_vehicle_class string

Return only LNG stations that can accommodate the specified vehicle class size or greater.

LPG Include Secondary
lpg_include_secondary string

If false, then exclude LPG stations that do not meet the criteria to be considered primary.

State
state string

Return only stations within the given state. State must be given as a two character state code (eg, "CO" for Colorado). A single state, or a comma-separate list of multiple states, may be given.

Zip
zip string

Return only stations within the given ZIP code. ZIP codes must be exactly 5 digits long. A single ZIP code, or a comma-separate list of multiple ZIP codes, may be given.

Country
country string

Return only stations within the given country code.

Limit
limit string

The maximum number of results to return. An explicit limit of up to 200 may be passed in, or the special all string may be passed in to return all results.

Returns

Name Path Type Description
Station Locator URL
station_locator_url string

The station locator URL address.

Total Results
total_results integer

The totals.

Total
station_counts.total integer

The total.

Total
station_counts.fuels.BD.total integer

The total.

Total
station_counts.fuels.E85.total integer

The total.

Total
station_counts.fuels.ELEC.total integer

The total.

Total
station_counts.fuels.ELEC.stations.total integer

The total.

Total
station_counts.fuels.HY.total integer

The total.

Total
station_counts.fuels.LNG.total integer

The total.

Total
station_counts.fuels.CNG.total integer

The total.

Total
station_counts.fuels.LPG.total integer

The total.

Fuel Stations
fuel_stations array of object
Access Code
fuel_stations.access_code string

The access code.

Access Days Times
fuel_stations.access_days_time string

The access days and times.

Access Detail Code
fuel_stations.access_detail_code string

The access detail code.

Cards Accepted
fuel_stations.cards_accepted string

The cards accepted.

Date Last Confirmed
fuel_stations.date_last_confirmed string

The date last confirmed.

Expected Date
fuel_stations.expected_date string

The expected date.

Fuel Type Code
fuel_stations.fuel_type_code string

The fuel type code.

Groups With Access Code
fuel_stations.groups_with_access_code string

The groups with access code.

ID
fuel_stations.id integer

The identifier.

Open Date
fuel_stations.open_date string

The open date.

Owner Type Code
fuel_stations.owner_type_code string

The owner type code.

Status Code
fuel_stations.status_code string

The status code.

Restricted Access
fuel_stations.restricted_access boolean

Whether access is restricted.

Station Name
fuel_stations.station_name string

The station name.

Station Phone
fuel_stations.station_phone string

The station phone number.

Updated At
fuel_stations.updated_at string

When updated at.

Facility Type
fuel_stations.facility_type string

The facility type.

Geocode Status
fuel_stations.geocode_status string

The geocode status.

Latitude
fuel_stations.latitude float

The latitude.

Longitude
fuel_stations.longitude float

The longitude.

City
fuel_stations.city string

The city.

Intersection Directions
fuel_stations.intersection_directions string

The intersection directions.

Plus 4
fuel_stations.plus4 string

The zip code plus 4.

State
fuel_stations.state string

The state.

Street Address
fuel_stations.street_address string

The street address.

Zip
fuel_stations.zip string

The zip code.

Country
fuel_stations.country string

The country.

BD Blends
fuel_stations.bd_blends string

The biodiesel blends.

CNG Dispenser Num
fuel_stations.cng_dispenser_num integer

The CNG dispenser number.

CNG Fill Type Code
fuel_stations.cng_fill_type_code string

The CNG fill type code.

CNG PSI
fuel_stations.cng_psi string

The CNG PSI.

CNG Renewable Source
fuel_stations.cng_renewable_source string

The CNG renewable source.

CNG Vehicle Class
fuel_stations.cng_vehicle_class string

The CNG vehicle class.

E85 Blender Pump
fuel_stations.e85_blender_pump string

The E85 blender pump.

E85 Other Ethanol Blends
fuel_stations.e85_other_ethanol_blends string

The E85 other ethanol blends.

EV Connector Types
fuel_stations.ev_connector_types string

The EV connector types.

EV DC Fast Num
fuel_stations.ev_dc_fast_num string

The EV DC fast number.

EV Level 1 EVSE Num
fuel_stations.ev_level1_evse_num string

The EV Level 1 EVSE number.

EV Level 2 EVSE Num
fuel_stations.ev_level2_evse_num string

The EV Level 2 EVSE number.

EV Network
fuel_stations.ev_network string

The EV network.

EV Network Web
fuel_stations.ev_network_web string

The EV network web.

EV Other EVSE
fuel_stations.ev_other_evse string

The EV other EVSE.

EV Pricing
fuel_stations.ev_pricing string

The EV pricing.

EV Renewable Source
fuel_stations.ev_renewable_source string

The EV renewable source.

HY Is Retail
fuel_stations.hy_is_retail string

The HY is retail.

HY Pressures
fuel_stations.hy_pressures string

The HY pressures.

HY Standards
fuel_stations.hy_standards string

The HY standards.

HY Status Link
fuel_stations.hy_status_link string

The HY status link.

LNG Renewable Source
fuel_stations.lng_renewable_source string

The LNG renewable source.

LNG Vehicle Class
fuel_stations.lng_vehicle_class string

The LNG vehicle class.

LPG Primary
fuel_stations.lpg_primary string

The LPG primary.

LPG Nozzle Types
fuel_stations.lpg_nozzle_types string

The LPG nozzle types.

NG Fill Type Code
fuel_stations.ng_fill_type_code string

The NG fill type code.

NG PSI
fuel_stations.ng_psi string

The NG PSI.

NG Vehicle Class
fuel_stations.ng_vehicle_class string

The NG vehicle class.

RD Blends
fuel_stations.rd_blends string

The RD blends.

RD Blends Fr
fuel_stations.rd_blends_fr string

The RD blends fr.

RD Blended With Biodiesel
fuel_stations.rd_blended_with_biodiesel string

The RD blended with biodiesel.

RD Max Biodiesel Level
fuel_stations.rd_max_biodiesel_level string

The RD max biodiesel level.

Access Days Time Fr
fuel_stations.access_days_time_fr string

The access days times fr.

Intersection Directions Fr
fuel_stations.intersection_directions_fr string

The intersection directions fr.

BD Blends Fr
fuel_stations.bd_blends_fr string

The BD blends fr.

Groups With Access Code Fr
fuel_stations.groups_with_access_code_fr string

The groups with access code fr.

EV Pricing Fr
fuel_stations.ev_pricing_fr string

The EV pricing fr.

Get an alternative fuel station by ID

Fetch the details of a specific alternative fuel station given the station's ID.

Parameters

Name Key Required Type Description
Station ID
id True string

The unique ID of the station to find.

Returns

Name Path Type Description
Access Code
alt_fuel_station.access_code string

The access code.

Access Days Times
alt_fuel_station.access_days_time string

The access days times.

Access Detail Code
alt_fuel_station.access_detail_code string

The access detail code.

Cards Accepted
alt_fuel_station.cards_accepted string

The cards accepted.

Date Last Confirmed
alt_fuel_station.date_last_confirmed string

The date last confirmed.

Expected Date
alt_fuel_station.expected_date string

The expected date.

Fuel Type Code
alt_fuel_station.fuel_type_code string

The fuel type code.

Groups With Access Code
alt_fuel_station.groups_with_access_code string

The groups with access code.

ID
alt_fuel_station.id integer

The identifier.

Open Date
alt_fuel_station.open_date string

The open date.

Owner Type Code
alt_fuel_station.owner_type_code string

The owner type code.

Status Code
alt_fuel_station.status_code string

The status code.

Restricted Access
alt_fuel_station.restricted_access boolean

Whether access is restricted.

Station Name
alt_fuel_station.station_name string

The station name.

Station Phone
alt_fuel_station.station_phone string

The station phone number.

Updated At
alt_fuel_station.updated_at string

When updated at.

Facility Type
alt_fuel_station.facility_type string

The facility type.

Geocode Status
alt_fuel_station.geocode_status string

The geocode status.

Latitude
alt_fuel_station.latitude float

The latitude.

Longitude
alt_fuel_station.longitude float

The longitude.

City
alt_fuel_station.city string

The city.

Intersection Directions
alt_fuel_station.intersection_directions string

The intersection directions.

Plus 4
alt_fuel_station.plus4 string

The plus 4.

State
alt_fuel_station.state string

The state.

Street Address
alt_fuel_station.street_address string

The street address.

Zip
alt_fuel_station.zip string

The zip code.

Country
alt_fuel_station.country string

The country.

BD Blends
alt_fuel_station.bd_blends string

The BD blends.

CNG Dispenser Num
alt_fuel_station.cng_dispenser_num integer

The CNG dispenser number.

CNG Fill Type Code
alt_fuel_station.cng_fill_type_code string

The CNG fill type code.

CNG PSI
alt_fuel_station.cng_psi string

The CNG PSI.

CNG Renewable Source
alt_fuel_station.cng_renewable_source string

The CNG renewable source.

CNG Vehicle Class
alt_fuel_station.cng_vehicle_class string

The CNG vehicle class.

E85 Blender Pump
alt_fuel_station.e85_blender_pump string

The E85 blender pump.

E85 Other Ethanol Blends
alt_fuel_station.e85_other_ethanol_blends string

The E85 other ethanol blends.

EV Connector Types
alt_fuel_station.ev_connector_types string

The EV connector types.

EV DC Fast Num
alt_fuel_station.ev_dc_fast_num integer

The EV DC fast number.

EV Level 1 EVSE Num
alt_fuel_station.ev_level1_evse_num string

The EV level 1 EVSE number.

EV Level 2 EVSE Num
alt_fuel_station.ev_level2_evse_num string

The EV level 2 EVSE number.

EV Network
alt_fuel_station.ev_network string

The EV network.

EV Network Web
alt_fuel_station.ev_network_web string

The EV network web.

EV Other EVSE
alt_fuel_station.ev_other_evse string

The EV other EVSE.

EV Pricing
alt_fuel_station.ev_pricing string

The EV pricing.

EV Renewable Source
alt_fuel_station.ev_renewable_source string

The EV renewable source.

HY Is Retail
alt_fuel_station.hy_is_retail string

The HY is retail.

HY Pressures
alt_fuel_station.hy_pressures string

The HY pressures.

HY Standards
alt_fuel_station.hy_standards string

The HY standards.

HY Status Link
alt_fuel_station.hy_status_link string

The HY status link.

LNG Renewable Source
alt_fuel_station.lng_renewable_source string

The LNG renewable source.

LNG Vehicle Class
alt_fuel_station.lng_vehicle_class string

The LNG vehicle class.

LPG Primary
alt_fuel_station.lpg_primary string

The LPG primary.

LPG Nozzle Types
alt_fuel_station.lpg_nozzle_types string

The LPG nozzle types.

NG Fill Type Code
alt_fuel_station.ng_fill_type_code string

The NG fill type code.

NG PSI
alt_fuel_station.ng_psi string

The NG PSI.

NG Vehicle Class
alt_fuel_station.ng_vehicle_class string

The NG vehicle class.

RD Blends
alt_fuel_station.rd_blends string

The RD blends.

RD Blends Fr
alt_fuel_station.rd_blends_fr string

The RD blends fr.

RD Blended With Biodiesel
alt_fuel_station.rd_blended_with_biodiesel string

The RD blended with biodiesel.

RD Max Biodiesel Level
alt_fuel_station.rd_max_biodiesel_level string

The RD max biodiesel level.

Access Days Times Fr
alt_fuel_station.access_days_time_fr string

The access days times fr.

Intersection Directions Fr
alt_fuel_station.intersection_directions_fr string

The intersection directions fr.

BD Blends Fr
alt_fuel_station.bd_blends_fr string

The BD blends fr.

Groups With Access Code Fr
alt_fuel_station.groups_with_access_code_fr string

The groups with access code fr.

EV Pricing Fr
alt_fuel_station.ev_pricing_fr string

The EV pricing fr.

Get nearest alternative fuel station

Return the nearest alternative fuel stations within a distance of a given location.

Parameters

Name Key Required Type Description
Location
location string

A free-form input describing the address of the location. Required if latitude and longitude not given.

Latitude
latitude float

The latitude for the location to use. Required if address not given.

Longitude
longitude float

The longitude for the location to use. Required if address not given.

Radius
radius number

The radius (in miles) around the search location to search for stations within.

Status
status string

Return stations that match the given status. A single status, or a comma-separated list of multiple statuses, may be given.

Access
access string

Return stations with the given access type.

Fuel Type
fuel_type string

Return stations that supply any of the given fuel types. A single fuel type, or a comma-separated list of multiple fuel types, may be given.

Cards Accepted
cards_accepted string

Return stations that accept any of the given payment methods. A single payment method, or a comma-separated list of multiple payment methods, may be given.

Owner Type
owner_type string

Return stations owned by the given types of owners. A single owner type, or a comma-separated list of multiple owner types, may be given.

Federal Agency
federal_agency string

Return stations owned by the given federal agency. A federal agency code, or a comma-separated list of multiple federal agency codes, may be given.

CNG Fill Type
cng_fill_type string

Return only CNG stations that provide the specified type of dispensing capability. A single type, or a comma separated list of multiple types, may be given.

CNG PSA
cng_psa string

Return only CNG stations that provide the specified PSI pressure. A single pressure level, or a comma separated list of multiple pressure levels, may be given.

CNG Vehicle Class
cng_vehicle_class string

Return only CNG stations that can accommodate the specified vehicle class size or greater.

E85 Has Blender Pump
e85_has_blender_pump string

If true, then return only E85 stations that also have a blender pump capable of providing mid-level ethanol blends.

EV Network
ev_network string

Return only electric charging stations that belong to the given network. A single network, or a comma separated list of multiple networks, may be given.

EV Charging Level
ev_charging_level string

Return only electric charging stations that provide the given level of electric vehicle supply equipment (EVSE).

EV Connector Type
ev_connector_type string

Return only electric charging stations that provide the given connector types.

HY Is Retail
hy_is_retail string

Return only hydrogen stations that match the value. A single retail value, or a comma-separated list of multiple retail values, may be given.

LNG Vehicle Class
lng_vehicle_class string

Return only LNG stations that can accommodate the specified vehicle class size or greater.

LPG Include Secondary
lpg_include_secondary string

If false, then exclude LPG stations that do not meet the criteria to be considered primary.

State
state string

Return only stations within the given state. State must be given as a two character state code (eg, "CO" for Colorado). A single state, or a comma-separate list of multiple states, may be given.

Zip
zip string

Return only stations within the given ZIP code. ZIP codes must be exactly 5 digits long. A single ZIP code, or a comma-separate list of multiple ZIP codes, may be given.

Country
country string

Return only stations within the given country code.

Limit
limit string

The maximum number of results to return. An explicit limit of up to 200 may be passed in, or the special all string may be passed in to return all results.

Offset
offset integer

Offset the results found (can be used with the limit parameter to paginate the results).

Returns

Name Path Type Description
Latitude
latitude float

The latitude.

Longitude
longitude float

The longitude.

Location Country
location_country string

The location country.

Value
precision.value integer

The value.

Name
precision.name string

The name.

Types
precision.types array of string
Station Locator URL
station_locator_url string

The station locator URL address.

Total Results
total_results integer

The totals.

Total
station_counts.total integer

The total.

Total
station_counts.fuels.BD.total integer

The total.

Total
station_counts.fuels.E85.total integer

The total.

Total
station_counts.fuels.ELEC.total integer

The total.

Total
station_counts.fuels.ELEC.stations.total integer

The total.

Total
station_counts.fuels.HY.total integer

The total.

Total
station_counts.fuels.LNG.total integer

The total.

Total
station_counts.fuels.CNG.total integer

The total.

Total
station_counts.fuels.LPG.total integer

The total.

Offset
offset integer

The offset.

Fuel Stations
fuel_stations array of object
Access Code
fuel_stations.access_code string

The access code.

Access Days Times
fuel_stations.access_days_time string

The access days and times.

Access Detail Code
fuel_stations.access_detail_code string

The access detail code.

Cards Accepted
fuel_stations.cards_accepted string

The cards accepted.

Date Last Confirmed
fuel_stations.date_last_confirmed string

The date last confirmed.

Expected Date
fuel_stations.expected_date string

The expected date.

Fuel Type Code
fuel_stations.fuel_type_code string

The fuel type code.

Groups With Access Code
fuel_stations.groups_with_access_code string

The groups with access code.

ID
fuel_stations.id integer

The identifier.

Open Date
fuel_stations.open_date string

The open date.

Owner Type Code
fuel_stations.owner_type_code string

The owner type code.

Status Code
fuel_stations.status_code string

The status code.

Restricted Access
fuel_stations.restricted_access string

Whether access is restricted.

Station Name
fuel_stations.station_name string

The station name.

Station Phone
fuel_stations.station_phone string

The station phone number.

Updated At
fuel_stations.updated_at string

When updated at.

Facility Type
fuel_stations.facility_type string

The facility type.

Geocode Status
fuel_stations.geocode_status string

The geocode status.

Latitude
fuel_stations.latitude float

The latitude.

Longitude
fuel_stations.longitude float

The longitude.

City
fuel_stations.city string

The city.

Intersection Directions
fuel_stations.intersection_directions string

The intersection directions.

Plus 4
fuel_stations.plus4 string

The zip code plus 4.

State
fuel_stations.state string

The state.

Street Address
fuel_stations.street_address string

The street address.

Zip
fuel_stations.zip string

The zip code.

Country
fuel_stations.country string

The country.

BD Blends
fuel_stations.bd_blends string

The biodiesel blends.

CNG Dispenser Num
fuel_stations.cng_dispenser_num integer

The CNG dispenser number.

CNG Fill Type Code
fuel_stations.cng_fill_type_code string

The CNG fill type code.

CNG PSI
fuel_stations.cng_psi string

The CNG PSI.

CNG Renewable Source
fuel_stations.cng_renewable_source string

The CNG renewable source.

CNG Vehicle Class
fuel_stations.cng_vehicle_class string

The CNG vehicle class.

E85 Blender Pump
fuel_stations.e85_blender_pump string

The E85 blender pump.

E85 Other Ethanol Blends
fuel_stations.e85_other_ethanol_blends string

The E85 other ethanol blends.

EV Connector Types
fuel_stations.ev_connector_types string

The EV connector types.

EV DC Fast Num
fuel_stations.ev_dc_fast_num string

The EV DC fast number.

EV Level 1 EVSE Num
fuel_stations.ev_level1_evse_num string

The EV Level 1 EVSE number.

EV Level 2 EVSE Num
fuel_stations.ev_level2_evse_num string

The EV Level 2 EVSE number.

EV Network
fuel_stations.ev_network string

The EV network.

EV Network Web
fuel_stations.ev_network_web string

The EV network web.

EV Other EVSE
fuel_stations.ev_other_evse string

The EV other EVSE.

EV Pricing
fuel_stations.ev_pricing string

The EV pricing.

EV Renewable Source
fuel_stations.ev_renewable_source string

The EV renewable source.

HY Is Retail
fuel_stations.hy_is_retail string

The HY is retail.

HY Pressures
fuel_stations.hy_pressures string

The HY pressures.

HY Standards
fuel_stations.hy_standards string

The HY standards.

HY Status Link
fuel_stations.hy_status_link string

The HY status link.

LNG Renewable Source
fuel_stations.lng_renewable_source string

The LNG renewable source.

LNG Vehicle Class
fuel_stations.lng_vehicle_class string

The LNG vehicle class.

LPG Primary
fuel_stations.lpg_primary string

The LPG primary.

LPG Nozzle Types
fuel_stations.lpg_nozzle_types string

The LPG nozzle types.

NG Fill Type Code
fuel_stations.ng_fill_type_code string

The NG fill type code.

NG PSI
fuel_stations.ng_psi string

The NG PSI.

NG Vehicle Class
fuel_stations.ng_vehicle_class string

The NG vehicle class.

RD Blends
fuel_stations.rd_blends string

The RD blends.

RD Blends Fr
fuel_stations.rd_blends_fr string

The RD blends fr.

RD Blended With Biodiesel
fuel_stations.rd_blended_with_biodiesel string

The RD blended with biodiesel.

RD Max Biodiesel Level
fuel_stations.rd_max_biodiesel_level string

The RD max biodiesel level.

Access Days Time Fr
fuel_stations.access_days_time_fr string

The access days times fr.

Intersection Directions Fr
fuel_stations.intersection_directions_fr string

The intersection directions fr.

BD Blends Fr
fuel_stations.bd_blends_fr string

The BD blends fr.

Groups With Access Code Fr
fuel_stations.groups_with_access_code_fr string

The groups with access code fr.

EV Pricing Fr
fuel_stations.ev_pricing_fr string

The EV pricing fr.

Station
fuel_stations.ev_network_ids.station array of string

The station.

Posts
fuel_stations.ev_network_ids.posts array of string

The posts.

Distance
fuel_stations.distance float

The distance.

Distance KM
fuel_stations.distance_km float

The distance in kilometers.

Get solar resource data

Returns various types of solar data for US locations. The service currently returns data for average Direct Normal Irradiance, average Global Horizontal Irradiance, and average Tilt at Latitude.

Parameters

Name Key Required Type Description
Address
address string

The address to use. Required if lat/lon not provided.

Latitude
lat float

The latitude for the location to use. Required if address not given.

Longitude
lon float

The longitude for the location to use. Required if address not given.

Returns

Name Path Type Description
Version
version string

The current version of the web service.

Sources
metadata.sources array of string

The sources.

Address
inputs.address string

The address.

Latitude
inputs.lat string

The latitude.

Longitude
inputs.lon string

The longitude.

Annual
outputs.avg_dni.annual float

The annual value.

January
outputs.avg_dni.monthly.jan float

The January value.

February
outputs.avg_dni.monthly.feb float

The February value.

March
outputs.avg_dni.monthly.mar float

The March value.

April
outputs.avg_dni.monthly.apr float

The April value.

May
outputs.avg_dni.monthly.may float

The May value.

June
outputs.avg_dni.monthly.jun float

The June value.

July
outputs.avg_dni.monthly.jul float

The July value.

August
outputs.avg_dni.monthly.aug float

The August value.

September
outputs.avg_dni.monthly.sep float

The September value.

October
outputs.avg_dni.monthly.oct float

The October value.

November
outputs.avg_dni.monthly.nov float

The November value.

December
outputs.avg_dni.monthly.dec float

The December value.

Annual
outputs.avg_ghi.annual float

The annual value.

January
outputs.avg_ghi.monthly.jan float

The January value.

February
outputs.avg_ghi.monthly.feb float

The February value.

March
outputs.avg_ghi.monthly.mar float

The March value.

April
outputs.avg_ghi.monthly.apr float

The April value.

May
outputs.avg_ghi.monthly.may float

The May value.

June
outputs.avg_ghi.monthly.jun float

The June value.

July
outputs.avg_ghi.monthly.jul float

The July value.

August
outputs.avg_ghi.monthly.aug float

The August value.

September
outputs.avg_ghi.monthly.sep float

The September value.

October
outputs.avg_ghi.monthly.oct float

The October value.

November
outputs.avg_ghi.monthly.nov float

The November value.

December
outputs.avg_ghi.monthly.dec float

The December value.

Annual
outputs.avg_lat_tilt.annual float

The annual value.

January
outputs.avg_lat_tilt.monthly.jan float

The January value.

February
outputs.avg_lat_tilt.monthly.feb float

The February value.

March
outputs.avg_lat_tilt.monthly.mar float

The March value.

April
outputs.avg_lat_tilt.monthly.apr float

The April value.

May
outputs.avg_lat_tilt.monthly.may float

The May value.

June
outputs.avg_lat_tilt.monthly.jun float

The June value.

July
outputs.avg_lat_tilt.monthly.jul float

The July value.

August
outputs.avg_lat_tilt.monthly.aug float

The August value.

September
outputs.avg_lat_tilt.monthly.sep float

The September value.

October
outputs.avg_lat_tilt.monthly.oct float

The October value.

November
outputs.avg_lat_tilt.monthly.nov float

The November value.

December
outputs.avg_lat_tilt.monthly.dec float

The December value.

Get standard work specifications

Retrieve standard work specification details for home energy upgrades.

Parameters

Name Key Required Type Description
NID
nid integer

The unique identifier of a standard work specification entry.

Spec
spec string

The specification ID for a given specification.

Housing Type
ht integer

The unique identifier of a housing type to filter on. Single Family Homes: 1, Multi-Family Homes: 2, Manufactured Housing: 3

Section
section integer

A section identifier. These can be found next to each section in the website navigation and detail pages.

Topic
topic integer

A topic identifier. These can be found next to each topic in the website navigation and detail pages.

Subtopic
subtopic integer

A subtopic identifier. These are the last 2 digits of the Subtopic headers. (Must be entered as a 2 digit number)

Returns

Name Path Type Description
array of object
Classification
classification string

The SWS classification identifier for the specification.

Title
title string

The title of the specification.

Section
section string

The section the specification belongs to.

Topic
topic string

The topic the specification belongs to.

Subtopic
subtopic string

The subtopic the specification belongs to.

Desired Outcome
desired_outcome string

The desired outcome field.

Housing Types
housing_types array of string

An array of housing type strings that apply to this specification.

Details
details array of object
Objective
details.objective string

The objective.

Title
details.title string

The title.

Classification
details.classification string

The classification.

Specification
details.specification string

The specification.

Housing Type
details.housing_type array of string

The housing type.

Get utility rates

This service returns annual average utility rates ($/kWH) for residential, commercial and industrial sectors as well as the local utility name for a specific location. This service does not return complex rate information. The data source is Ventyx Research Inc. and the Energy Information Agency (EIA), and was updated with 2012 numbers.

Parameters

Name Key Required Type Description
Address
address string

The address to use. Required if lat/lon not provided.

Latitude
lat float

The latitude for the location to use. Required if address not given.

Longitude
lon float

The longitude for the location to use. Required if address not given.

Radius
radius number

The radius (in miles) around the search location to search for utility rates with intersecting boundaries. With the default radius of 0, only utility rates whose boundaries contain the search location point will be returned.

Limit
limit integer

The maximum number of results to return. If no limit is specified then all matching results will be returned.

Returns

Name Path Type Description
Address
inputs.address string

The address.

Latitude
inputs.lat string

The latitude.

Longitude
inputs.lon string

The longitude.

Version
version string

The current version of the web service.

Sources
metadata.sources array of string

The sources.

Company ID
outputs.company_id string

The identifier of the utility company. If there are multiple utility companies serving the location, the IDs will be returned as a pipe-delimited string.

Utility Name
outputs.utility_name string

The name of the utility company. If there are multiple utility companies serving the location, the names will be returned as a pipe-delimited string.

Utility Info
outputs.utility_info array of object
Company ID
outputs.utility_info.company_id string

The identifier of the utility company. If there are multiple utility companies serving the location, the IDs will be returned as a pipe-delimited string.

Utility Name
outputs.utility_info.utility_name string

The name of the utility company. If there are multiple utility companies serving the location, the names will be returned as a pipe-delimited string.

Commercial
outputs.commercial float

The commercial electricity rate ($/kWh).

Industrial
outputs.industrial float

The industrial electricity rate ($/kWh).

Residential
outputs.residential float

The residential electricity rate ($/kWh).

Get utility rates by census region

Given a location and Census Bureau region level (block, blockgroup, tract), return the Census Bureau ID, utility rate and company information.

Parameters

Name Key Required Type Description
ID
id integer

Identifying number provided by requester.

Address
address string

The address to use. Required if lat/lon not provided.

Latitude
lat float

The latitude for the location to use. Required if address not given.

Longitude
lon float

The longitude for the location to use. Required if address not given.

Region
region string

The Census Bureau region level to return.

Returns

Name Path Type Description
Address
inputs.address string

The address.

Region
inputs.region string

The region.

ID
inputs.id string

The identifier.

Latitude
inputs.lat string

The latitude.

Longitude
inputs.lon string

The longitude.

ID
outputs.id integer

The identifier.

UID
outputs.uid string

The unique identifier.

Census Region
outputs.census_region string

The census region.

Company ID
outputs.company_id string

The identifier of the utility company. If there are multiple utility companies serving the location, the IDs will be returned as a pipe-delimited string.

Utility Name
outputs.utility_name string

The name of the utility company. If there are multiple utility companies serving the location, the names will be returned as a pipe-delimited string.

Utility Info
outputs.utility_info array of object
Company ID
outputs.utility_info.company_id string

The identifier of the utility company. If there are multiple utility companies serving the location, the IDs will be returned as a pipe-delimited string.

Utility Name
outputs.utility_info.utility_name string

The name of the utility company. If there are multiple utility companies serving the location, the names will be returned as a pipe-delimited string.

Commercial
outputs.commercial float

The commercial electricity rate ($/kWh).

Industrial
outputs.industrial float

The industrial electricity rate ($/kWh).

Residential
outputs.residential float

The residential electricity rate ($/kWh).

Version
version string

The current version of the web service.

Sources
metadata.sources array of string

The sources.

Query solar dataset

Returns information about data available for a given location for the solar resource database used by the PVWatts® Calculator and PVWatts v8 API.

Parameters

Name Key Required Type Description
Address
address string

The address to use. Required if lat/lon not provided.

Latitude
lat float

The latitude for the location to use. Required if address not given.

Longitude
lon float

The longitude for the location to use. Required if address not given.

Radius
radius number

The radius (in miles) around the search location to search for utility rates with intersecting boundaries. With the default radius of 0, only utility rates whose boundaries contain the search location point will be returned.

All
all integer

Return all stations within the radius. The closest stations will still be returned individually.

Returns

Name Path Type Description
Version
version string

The current version of the web service.

Address
inputs.address string

The address.

Latitude
inputs.lat float

The latitude.

Longitude
inputs.lon float

The longitude.

Radius
inputs.radius string

The radius.

ID
outputs.tmy2.id string

The identifier.

City
outputs.tmy2.city string

The city.

State
outputs.tmy2.state string

The state.

Timezone
outputs.tmy2.timezone integer

The timezone.

Latitude
outputs.tmy2.lat float

The latitude.

Longitude
outputs.tmy2.lon float

The longitude.

Elevation
outputs.tmy2.elevation integer

The elevation.

Distance
outputs.tmy2.distance integer

The distance.

Weather Data Source
outputs.tmy2.weather_data_source string

The weather data source.

ID
outputs.tmy3.id string

The identifier.

City
outputs.tmy3.city string

The city.

State
outputs.tmy3.state string

The state.

Timezone
outputs.tmy3.timezone integer

The timezone.

Latitude
outputs.tmy3.lat float

The latitude.

Longitude
outputs.tmy3.lon float

The longitude.

Elevation
outputs.tmy3.elevation integer

The elevation.

Distance
outputs.tmy3.distance integer

The distance.

Weather Data Source
outputs.tmy3.weather_data_source string

The weather data source.

ID
outputs.intl.id string

The identifier.

City
outputs.intl.city string

The city.

State
outputs.intl.state string

The state.

Timezone
outputs.intl.timezone integer

The timezone.

Latitude
outputs.intl.lat float

The latitude.

Longitude
outputs.intl.lon float

The longitude.

Elevation
outputs.intl.elevation integer

The elevation.

Distance
outputs.intl.distance integer

The distance.

Weather Data Source
outputs.intl.weather_data_source string

The weather data source.

ID
outputs.nsrdb.id string

The identifier.

City
outputs.nsrdb.city string

The city.

State
outputs.nsrdb.state string

The state.

Country
outputs.nsrdb.country string

The country.

Latitude
outputs.nsrdb.lat float

The latitude.

Longitude
outputs.nsrdb.lon float

The longitude.

Distance
outputs.nsrdb.distance integer

The distance.

Timezone
outputs.nsrdb.timezone integer

The timezone.

Elevation
outputs.nsrdb.elevation integer

The elevation.

Resolution
outputs.nsrdb.resolution integer

The resolution.

Weather Data Source
outputs.nsrdb.weather_data_source string

The weather data source.