estimatedSupplyPointReadings

Return actual readings within the requested period blended with estimated readings produced by the selected algorithm. The default strategy (EXTRAPOLATE_FORWARD) appends estimated records after the last actual reading. FILL_GAPS interpolates interior gaps between actual readings. ESTIMATE_MISSING_READING estimates a single missing boundary reading with automatically detected direction.

Arguments

deviceId : ID

Optional meter device identifier to filter readings.

endAt : DateTime!


            required

The end of the requested period (exclusive, timezone-aware).

estimationStrategy : EstimationStrategy default: EXTRAPOLATE_FORWARD

The algorithm strategy to apply when readings are missing or incomplete. Defaults to EXTRAPOLATE_FORWARD.

marketName : String!


            required

The market this supply point belongs to.

readingType : ReadingTypes!


            required

The reading type to estimate. PEAK is not supported.

registerId : ID

Optional register identifier to filter readings.

startAt : DateTime!


            required

The start of the requested period (inclusive, timezone-aware).

supplyPointId : String!


            required

The market-level external identifier of the supply point (e.g. ICP number).

timeGranularity : TimeGranularities!


            required

The time granularity for aggregating readings.

timezone : String!


            required

IANA timezone name used for aggregation boundaries (e.g. 'Pacific/Auckland').

Returns

[EstimatedSupplyPointReadingType]

Possible Errors

Allowed Viewers

Customer

Partner User

Third party

Required Permissions

Can estimate meter readings

Query Complexity

Examples

The example data in the variables and responses below are autogenerated values designed to resemble real inputs. They do not represent actual customer data, and in some cases may require additional validation.

query EstimatedSupplyPointReadings(
  $deviceId: ID,
  $endAt: DateTime!,
  $estimationStrategy: EstimationStrategy,
  $marketName: String!,
  $readingType: ReadingTypes!,
  $registerId: ID,
  $startAt: DateTime!,
  $supplyPointId: String!,
  $timeGranularity: TimeGranularities!,
  $timezone: String!
) {
  estimatedSupplyPointReadings(
    deviceId: $deviceId,
    endAt: $endAt,
    estimationStrategy: $estimationStrategy,
    marketName: $marketName,
    readingType: $readingType,
    registerId: $registerId,
    startAt: $startAt,
    supplyPointId: $supplyPointId,
    timeGranularity: $timeGranularity,
    timezone: $timezone
  ) {
    intervalEnd
    intervalStart
    isEstimated
    quality
    value
  }
}

{
  "deviceId": "75028317",
  "endAt": "2013-08-26T11:32:57.114306+00:00",
  "estimationStrategy": "EXTRAPOLATE_FORWARD",
  "marketName": "mouth-assume-American-card-coach",
  "readingType": "INTERVAL",
  "registerId": "82237154",
  "startAt": "1982-02-08T10:41:44.101010+00:00",
  "supplyPointId": "54591622",
  "timeGranularity": "FIVE_MIN",
  "timezone": "outside-subject-happy-future-fact"
}

{
  "data": {
    "estimatedSupplyPointReadings": [
      {
        "intervalEnd": "2019-04-22T13:20:13.818109+00:00",
        "intervalStart": "2004-05-01T07:37:56.720708+00:00",
        "isEstimated": true,
        "quality": "west-thought-career-necessary-bit",
        "value": "1.0"
      }
    ]
  }
}