Energy Optimization - RE Data Explorer Technical Potential
GET {{nrel_developer_url}}/opencarto/rede/v1/technical-potential/config?wkt=POINT(77.216 28.644)
Utility Rates (GET /api/utility_rates/v3)
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.
Version 3 is the current version of the utility rates API. Previous versions have been deprecated and its users are encouraged to migrate to this newly enhanced version.
Response Fields
The response is composed of service-related informational fields and the results of the data query.
| Field | Value | Description |
|---|---|---|
| inputs | Type: collection | The input parameters received in the request. |
| version | Type: string | The current version of the web service. |
| errors | Type: array of strings | Any error messages resulting from the request. |
| warnings | Type: array of strings | Any warning messages resulting from the request. |
| metadata | Type: collection | Any metadata associated with the request (sources, etc) |
| outputs | Type: collection | The data outputs from the request. (see output fields for more detail) |
| utility_name | Type: 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. |
| company_id | Type: integer | The ID of the utility company. If there are multiple utility companies serving the location, the IDs will be returned as a pipe-delimited string. |
| utility_info | Type: collection | An array of hashes containing the name(s) and ID(s) of the utility company or companies serving the location. |
| residential | Type: decimal | The residential electricity rate ($/kWh). |
| commercial | Type: decimal | The commercial electricity rate ($/kWh). |
| industrial | Type: decimal | The industrial electricity rate ($/kWh). |
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
address | null | Type: string | |
| Default: None | |||
| The address to use. Required if lat/lon not provided. | |||
radius | null | Type: decimal | |
| Default: 0 | |||
| Range: 0.0 to 200.0 | |||
| 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 | null | | Type: integer
Default: None
The maximum number of results to return. If no limit is specified then all matching results will be returned. |
| wkt | string | | |
| jobId | string | | |
RESPONSES
status: OK
{"inputs":{"wkt":"POINT(77.216 28.644)"},"metadata":{"version":"1.0.0","resultset":{"count":1}},"status":200,"outputs":[{"id":6,"region":{"id":6,"label":"India"},"availableResources":[{"resource":{"id":17,"key":"wind_t200","label":"Wind T-200","defaultPowerDensity":3},"inputFields":[{"fieldId":3,"fieldName":"excludeProtectedAreas"},{"fieldId":7,"fieldName":"limitBySlope"},{"fieldId":6,"fieldName":"limitToTransmissionCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":17,"fieldName":"powerDensity"},{"fieldId":5,"fieldName":"limitToRoadCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":9,"fieldName":"limitByWindSpeed","defaultValue":{"min":3,"max":null}},{"fieldId":8,"fieldName":"limitByGeographicExtent","fieldValues":["Andaman and Nicobar","Andhra Pradesh","Arunachal Pradesh","Assam","Bihar","Chandigarh","Chhattisgarh","Dadra and Nagar Haveli","Daman and Diu","Delhi","Goa","Gujarat","Haryana","Himachal Pradesh","Jammu \u0026 Kashmir","Jharkhand","Karnataka","Kerala","Lakshadweep","Madhya Pradesh","Maharashtra","Manipur","Meghalaya","Mizoram","Nagaland","Orissa","Puducherry","Punjab","Rajasthan","Sikkim","Tamil Nadu","Telangana","Tripura","Uttarakhand","Uttar Pradesh","West Bengal"]},{"fieldId":4,"fieldName":"limitByLandUse","fieldValues":["Barren or Sparsely Vegetated","Cropland/Grassland Mosaic","Cropland/Woodland Mosaic","Deciduous Broadleaf Forest","Dryland Cropland and Pasture","Evergreen Broadleaf Forest","Evergreen Needleleaf Forest","Grassland","Herbaceous Wetland","Irrigated Cropland and Pasture","Mixed Forest","Mixed Shrubland/Grassland","Mixed Tundra","Savanna","Shrubland","Snow or Ice","Urban and Built-Up Land","Water Bodies","Wooded Tundra","Wooded Wetland"]}]},{"resource":{"id":20,"key":"wind_t255","label":"Wind T-255","defaultPowerDensity":3},"inputFields":[{"fieldId":3,"fieldName":"excludeProtectedAreas"},{"fieldId":7,"fieldName":"limitBySlope"},{"fieldId":6,"fieldName":"limitToTransmissionCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":17,"fieldName":"powerDensity"},{"fieldId":5,"fieldName":"limitToRoadCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":9,"fieldName":"limitByWindSpeed","defaultValue":{"min":3,"max":null}},{"fieldId":8,"fieldName":"limitByGeographicExtent","fieldValues":["Andaman and Nicobar","Andhra Pradesh","Arunachal Pradesh","Assam","Bihar","Chandigarh","Chhattisgarh","Dadra and Nagar Haveli","Daman and Diu","Delhi","Goa","Gujarat","Haryana","Himachal Pradesh","Jammu \u0026 Kashmir","Jharkhand","Karnataka","Kerala","Lakshadweep","Madhya Pradesh","Maharashtra","Manipur","Meghalaya","Mizoram","Nagaland","Orissa","Puducherry","Punjab","Rajasthan","Sikkim","Tamil Nadu","Telangana","Tripura","Uttarakhand","Uttar Pradesh","West Bengal"]},{"fieldId":4,"fieldName":"limitByLandUse","fieldValues":["Barren or Sparsely Vegetated","Cropland/Grassland Mosaic","Cropland/Woodland Mosaic","Deciduous Broadleaf Forest","Dryland Cropland and Pasture","Evergreen Broadleaf Forest","Evergreen Needleleaf Forest","Grassland","Herbaceous Wetland","Irrigated Cropland and Pasture","Mixed Forest","Mixed Shrubland/Grassland","Mixed Tundra","Savanna","Shrubland","Snow or Ice","Urban and Built-Up Land","Water Bodies","Wooded Tundra","Wooded Wetland"]}]},{"resource":{"id":18,"key":"wind_t237","label":"Wind T-237","defaultPowerDensity":3},"inputFields":[{"fieldId":3,"fieldName":"excludeProtectedAreas"},{"fieldId":7,"fieldName":"limitBySlope"},{"fieldId":6,"fieldName":"limitToTransmissionCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":17,"fieldName":"powerDensity"},{"fieldId":5,"fieldName":"limitToRoadCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":9,"fieldName":"limitByWindSpeed","defaultValue":{"min":3,"max":null}},{"fieldId":8,"fieldName":"limitByGeographicExtent","fieldValues":["Andaman and Nicobar","Andhra Pradesh","Arunachal Pradesh","Assam","Bihar","Chandigarh","Chhattisgarh","Dadra and Nagar Haveli","Daman and Diu","Delhi","Goa","Gujarat","Haryana","Himachal Pradesh","Jammu \u0026 Kashmir","Jharkhand","Karnataka","Kerala","Lakshadweep","Madhya Pradesh","Maharashtra","Manipur","Meghalaya","Mizoram","Nagaland","Orissa","Puducherry","Punjab","Rajasthan","Sikkim","Tamil Nadu","Telangana","Tripura","Uttarakhand","Uttar Pradesh","West Bengal"]},{"fieldId":4,"fieldName":"limitByLandUse","fieldValues":["Barren or Sparsely Vegetated","Cropland/Grassland Mosaic","Cropland/Woodland Mosaic","Deciduous Broadleaf Forest","Dryland Cropland and Pasture","Evergreen Broadleaf Forest","Evergreen Needleleaf Forest","Grassland","Herbaceous Wetland","Irrigated Cropland and Pasture","Mixed Forest","Mixed Shrubland/Grassland","Mixed Tundra","Savanna","Shrubland","Snow or Ice","Urban and Built-Up Land","Water Bodies","Wooded Tundra","Wooded Wetland"]}]},{"resource":{"id":15,"key":"csp","label":"CSP","defaultPowerDensity":29},"inputFields":[{"fieldId":3,"fieldName":"excludeProtectedAreas"},{"fieldId":7,"fieldName":"limitBySlope"},{"fieldId":6,"fieldName":"limitToTransmissionCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":2,"fieldName":"limitBySolarResource","defaultValue":{"min":2,"max":9}},{"fieldId":17,"fieldName":"powerDensity"},{"fieldId":5,"fieldName":"limitToRoadCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":8,"fieldName":"limitByGeographicExtent","fieldValues":["Andaman and Nicobar","Andhra Pradesh","Arunachal Pradesh","Assam","Bihar","Chandigarh","Chhattisgarh","Dadra and Nagar Haveli","Daman and Diu","Delhi","Goa","Gujarat","Haryana","Himachal Pradesh","Jammu \u0026 Kashmir","Jharkhand","Karnataka","Kerala","Lakshadweep","Madhya Pradesh","Maharashtra","Manipur","Meghalaya","Mizoram","Nagaland","Orissa","Puducherry","Punjab","Rajasthan","Sikkim","Tamil Nadu","Telangana","Tripura","Uttarakhand","Uttar Pradesh","West Bengal"]},{"fieldId":4,"fieldName":"limitByLandUse","fieldValues":["Barren or Sparsely Vegetated","Cropland/Grassland Mosaic","Cropland/Woodland Mosaic","Deciduous Broadleaf Forest","Dryland Cropland and Pasture","Evergreen Broadleaf Forest","Evergreen Needleleaf Forest","Grassland","Herbaceous Wetland","Irrigated Cropland and Pasture","Mixed Forest","Mixed Shrubland/Grassland","Mixed Tundra","Savanna","Shrubland","Snow or Ice","Urban and Built-Up Land","Water Bodies","Wooded Tundra","Wooded Wetland"]}]},{"resource":{"id":19,"key":"wind_t245","label":"Wind T-245","defaultPowerDensity":3},"inputFields":[{"fieldId":3,"fieldName":"excludeProtectedAreas"},{"fieldId":7,"fieldName":"limitBySlope"},{"fieldId":6,"fieldName":"limitToTransmissionCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":17,"fieldName":"powerDensity"},{"fieldId":5,"fieldName":"limitToRoadCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":9,"fieldName":"limitByWindSpeed","defaultValue":{"min":3,"max":null}},{"fieldId":8,"fieldName":"limitByGeographicExtent","fieldValues":["Andaman and Nicobar","Andhra Pradesh","Arunachal Pradesh","Assam","Bihar","Chandigarh","Chhattisgarh","Dadra and Nagar Haveli","Daman and Diu","Delhi","Goa","Gujarat","Haryana","Himachal Pradesh","Jammu \u0026 Kashmir","Jharkhand","Karnataka","Kerala","Lakshadweep","Madhya Pradesh","Maharashtra","Manipur","Meghalaya","Mizoram","Nagaland","Orissa","Puducherry","Punjab","Rajasthan","Sikkim","Tamil Nadu","Telangana","Tripura","Uttarakhand","Uttar Pradesh","West Bengal"]},{"fieldId":4,"fieldName":"limitByLandUse","fieldValues":["Barren or Sparsely Vegetated","Cropland/Grassland Mosaic","Cropland/Woodland Mosaic","Deciduous Broadleaf Forest","Dryland Cropland and Pasture","Evergreen Broadleaf Forest","Evergreen Needleleaf Forest","Grassland","Herbaceous Wetland","Irrigated Cropland and Pasture","Mixed Forest","Mixed Shrubland/Grassland","Mixed Tundra","Savanna","Shrubland","Snow or Ice","Urban and Built-Up Land","Water Bodies","Wooded Tundra","Wooded Wetland"]}]},{"resource":{"id":21,"key":"wind_t325","label":"Wind T-325","defaultPowerDensity":3},"inputFields":[{"fieldId":3,"fieldName":"excludeProtectedAreas"},{"fieldId":7,"fieldName":"limitBySlope"},{"fieldId":6,"fieldName":"limitToTransmissionCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":17,"fieldName":"powerDensity"},{"fieldId":5,"fieldName":"limitToRoadCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":9,"fieldName":"limitByWindSpeed","defaultValue":{"min":3,"max":null}},{"fieldId":8,"fieldName":"limitByGeographicExtent","fieldValues":["Andaman and Nicobar","Andhra Pradesh","Arunachal Pradesh","Assam","Bihar","Chandigarh","Chhattisgarh","Dadra and Nagar Haveli","Daman and Diu","Delhi","Goa","Gujarat","Haryana","Himachal Pradesh","Jammu \u0026 Kashmir","Jharkhand","Karnataka","Kerala","Lakshadweep","Madhya Pradesh","Maharashtra","Manipur","Meghalaya","Mizoram","Nagaland","Orissa","Puducherry","Punjab","Rajasthan","Sikkim","Tamil Nadu","Telangana","Tripura","Uttarakhand","Uttar Pradesh","West Bengal"]},{"fieldId":4,"fieldName":"limitByLandUse","fieldValues":["Barren or Sparsely Vegetated","Cropland/Grassland Mosaic","Cropland/Woodland Mosaic","Deciduous Broadleaf Forest","Dryland Cropland and Pasture","Evergreen Broadleaf Forest","Evergreen Needleleaf Forest","Grassland","Herbaceous Wetland","Irrigated Cropland and Pasture","Mixed Forest","Mixed Shrubland/Grassland","Mixed Tundra","Savanna","Shrubland","Snow or Ice","Urban and Built-Up Land","Water Bodies","Wooded Tundra","Wooded Wetland"]}]},{"resource":{"id":13,"key":"axis1","label":"1 Axis Tracking PV System","defaultPowerDensity":31},"inputFields":[{"fieldId":3,"fieldName":"excludeProtectedAreas"},{"fieldId":7,"fieldName":"limitBySlope"},{"fieldId":6,"fieldName":"limitToTransmissionCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":17,"fieldName":"powerDensity"},{"fieldId":18,"fieldName":"limitBySolarResource","defaultValue":{"min":2,"max":9}},{"fieldId":5,"fieldName":"limitToRoadCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":8,"fieldName":"limitByGeographicExtent","fieldValues":["Andaman and Nicobar","Andhra Pradesh","Arunachal Pradesh","Assam","Bihar","Chandigarh","Chhattisgarh","Dadra and Nagar Haveli","Daman and Diu","Delhi","Goa","Gujarat","Haryana","Himachal Pradesh","Jammu \u0026 Kashmir","Jharkhand","Karnataka","Kerala","Lakshadweep","Madhya Pradesh","Maharashtra","Manipur","Meghalaya","Mizoram","Nagaland","Orissa","Puducherry","Punjab","Rajasthan","Sikkim","Tamil Nadu","Telangana","Tripura","Uttarakhand","Uttar Pradesh","West Bengal"]},{"fieldId":4,"fieldName":"limitByLandUse","fieldValues":["Barren or Sparsely Vegetated","Cropland/Grassland Mosaic","Cropland/Woodland Mosaic","Deciduous Broadleaf Forest","Dryland Cropland and Pasture","Evergreen Broadleaf Forest","Evergreen Needleleaf Forest","Grassland","Herbaceous Wetland","Irrigated Cropland and Pasture","Mixed Forest","Mixed Shrubland/Grassland","Mixed Tundra","Savanna","Shrubland","Snow or Ice","Urban and Built-Up Land","Water Bodies","Wooded Tundra","Wooded Wetland"]}]},{"resource":{"id":14,"key":"fixlat","label":"Fixed Tilt PV System","defaultPowerDensity":36},"inputFields":[{"fieldId":3,"fieldName":"excludeProtectedAreas"},{"fieldId":7,"fieldName":"limitBySlope"},{"fieldId":6,"fieldName":"limitToTransmissionCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":17,"fieldName":"powerDensity"},{"fieldId":18,"fieldName":"limitBySolarResource","defaultValue":{"min":2,"max":9}},{"fieldId":5,"fieldName":"limitToRoadCorridors","fieldValues":{"distance":[1,5,10,15,20,50,100],"units":["kilometers"]}},{"fieldId":8,"fieldName":"limitByGeographicExtent","fieldValues":["Andaman and Nicobar","Andhra Pradesh","Arunachal Pradesh","Assam","Bihar","Chandigarh","Chhattisgarh","Dadra and Nagar Haveli","Daman and Diu","Delhi","Goa","Gujarat","Haryana","Himachal Pradesh","Jammu \u0026 Kashmir","Jharkhand","Karnataka","Kerala","Lakshadweep","Madhya Pradesh","Maharashtra","Manipur","Meghalaya","Mizoram","Nagaland","Orissa","Puducherry","Punjab","Rajasthan","Sikkim","Tamil Nadu","Telangana","Tripura","Uttarakhand","Uttar Pradesh","West Bengal"]},{"fieldId":4,"fieldName":"limitByLandUse","fieldValues":["Barren or Sparsely Vegetated","Cropland/Grassland Mosaic","Cropland/Woodland Mosaic","Deciduous Broadleaf Forest","Dryland Cropland and Pasture","Evergreen Broadleaf Forest","Evergreen Needleleaf Forest","Grassland","Herbaceous Wetland","Irrigated Cropland and Pasture","Mixed Forest","Mixed Shrubland/Grassland","Mixed Tundra","Savanna","Shrubland","Snow or Ice","Urban and Built-Up Land","Water Bodies","Wooded Tundra","Wooded Wetland"]}]}]}],"errors":[]}