Site Count (/api/wind-toolkit/wind/site_count)
Determine the number of sites containing data for a given point, polygon, or multipoint as specified by a WKT. This is useful for calculating download request size. Details at the download guide.
Request URL
GET /api/wind-toolkit/wind/site_count.format?parameters
Request Parameters
| Parameter | Required | Value | Description |
|---|---|---|---|
| api_key | Yes |
Type: string
Default: None
|
Your developer API key. See API keys for more information. |
| wkt | Yes |
Type: well-known text string
Default: None
|
A well-known text (WKT) representation of the geometry for which to extract data. May be a point, multipoint, or polygon geometry. When a point is passed the site nearest to that point is used. When a multipoint is passed the site nearest each point is used. This can be useful for downloading multiple sites in a single request when those sites are geographically distant from each other. When a polygon is passed all sites that intersect with the given polygon are used. |
Response Fields
The response is composed of service-related informational fields and the results of the data query.
| Field | Value | Description |
|---|---|---|
| errors |
Type: string array
|
A list of error messages |
| warnings |
Type: string array
|
A list of warning messages |
| inputs |
Type: Object Hash
|
Key: Value pairs representing all input parameters |
| outputs |
Type: Object Hash
|
Upon successful completion a list of datasets with a site count for each will be returned. |
Examples
JSON Output Format
GET /api/wind-toolkit/wind/site_count.json?api_key=DEMO_KEY&wkt=POLYGON((-114.9609375 39.50404070558415,-112.67578124999999 39.50404070558415,-112.67578124999999 38.13455657705411,-114.9609375 38.13455657705411,-114.9609375 39.50404070558415)){
"errors": [],
"inputs": {
"wkt": "POLYGON((-114.9609375 39.50404070558415,-112.67578124999999 39.50404070558415,-112.67578124999999 38.13455657705411,-114.9609375 38.13455657705411,-114.9609375 39.50404070558415))"
},
"outputs": {
"wtk_site_count": 888,
"east_wind_site_count": 0,
"west_wind_site_count": 627
}
}
Rate Limits
Standard rate limits apply. No more than 1,000 requests may be made in any hour.
Errors
Standard errors may be returned. In addition, the following service-specific errors may be returned:
| HTTP Status Code | Description |
|---|---|
| 400 | Bad Request: When required parameters are missing. |