Below is a table of measurement data we are looking for when integrating live measurements into our systems. 

The first place to look for this information is our docs: https://docs.solcast.com.au

But in case you are looking for this information in a different format, explained a bit differently or through our 'help' chat tool, here is some basic information relevant to a 'Utility Scale' PV power site:

Create utility scale site measurement request structure

Property name
Description
'period_end' [End of the averaging period in ISO8601 <https://en.wikipedia.org/wiki/ISO_8601]
'period'
[Length of averaging period in ISO8601 <https://en.wikipedia.org/wiki/ISO_8601> duration format]
'total_power'
[Total power for the rooftop site over the specified period measured in megawatts (MW). (double) averaged over the period above (NOT an instantaneous value)]
'availability'
[Percentage of online and available inverters for the utility scale site Values between 0-100 (double)]
'constraint_power_ceiling'
[The maximum output (MW) that the site is constrained to due to an external constraint where during outages or grid operator instructions]

How does the POST command work? 

These measurements are sent over HTTPS to our API via the JSON data format to a unique URL for each utility scale site (see the API Toolkit for examples and your 'resource ID'.
 
Metadata about the utility site (location, capacity, etc) is a once off we can setup for you in our system which will give your Utility Scale PV Power site a unique "resource_id" that defines a URL where these measurements are sent.

POST command format example


An example of this data is below. The resource ID (1234-abcd-1234-abcd) just as an example, your resource ID will be generated once the metadata is provide and the site is created in our system. 

The below is for a single measurement posted to a specific utility scale site in JSON format (note the 'measurement' field).

/utility_scale_sites/1234-abcd-1234-abcd/measurements
{
     "measurement": {
     "period_end": "2018-02-02T03:30:00.0000000Z",
     "availability": 100,
     "period": "PT30S",
     "total_power": 1.23456
   }
}


The below is for multiple measurements posted to a specific utility scale site in JSON format (note the 'measurements' field <- extra 's')

 /utility_scale_sites/1234-abcd-1234-abcd/measurements
{
   "measurements": [{
       "period_end":   "2018-02-02T03:30:00.0000000Z",
       "period": "PT30S",
       "total_power": 1.23456
      },
      {
       "period_end":   "2018-02-02T03:30:30.0000000Z",
       "period": "PT30S",
       "total_power": 1.98765
      },
   ]
 }

Did this answer your question?