속성 목록

속성명	NGSI-LD 타입	데이터 타입	필수	관측 시각	단위	허용 값 · 범위	설명
`id`	Property	string	필수	해당 없음			데이터 인스턴스 ID
`type`	Property	string	필수	해당 없음		`EVDRDaily`	모델 타입
`address`	Property	Address	선택	쓰지 않음			DR 이력 수집 대상 도시
`source`	Property	string	선택	쓰지 않음			DR 서비스 데이터 제공자
`measurementStartAt`	Property	DateTime	필수	쓰지 않음			DR 이력 수집 시작 시각
`customerLoadReduction`	Property	double	선택	필수	kWh `KWH`		일간 국민(마이너스) DR 참여고객의 부하감축량 (kWh)
`minusDRCount`	Property	integer	선택	필수			일간 국민(마이너스) DR 발령 횟수
`minusDRIncentiveFee`	Property	integer	선택	필수			일간 국민(마이너스) DR 인센티브 비용 (원)
`customerLoadIncrease`	Property	double	선택	필수	kWh `KWH`		일간 플러스 DR 참여고객의 부하증대량 (kWh)
`plusDRCount`	Property	integer	선택	필수			일간 플러스 DR 발령 횟수
`plusDRIncentiveFee`	Property	integer	선택	필수			일간 플러스 DR 인센티브 비용 (원)

예제 (NGSI-LD 정규 표현법)

{
  "@context": [
    "http://uri.etsi.org/ngsi-ld/core-context.jsonld",
    "http://uri.citydatahub.kr/ngsi-ld/context/v1/core.jsonld"
  ],
  "id": "urn:drmanagement:DRDaily_01",
  "type": "EVDRDaily",
  "address": {
    "type": "Property",
    "value": {
      "addressCountry": "KR",
      "addressRegion": "경기도",
      "addressLocality": "성남시"
    }
  },
  "source": {
    "type": "Property",
    "value": "DR 관제 시스템"
  },
  "measurementStartAt": {
    "type": "Property",
    "value": "2023-04-28T15:00:00Z"
  },
  "customerLoadReduction": {
    "observedAt": "2023-04-28T15:50:00Z",
    "type": "Property",
    "value": 207.2
  },
  "minusDRCount": {
    "observedAt": "2023-04-28T15:50:00Z",
    "type": "Property",
    "value": 10
  },
  "minusDRIncentiveFee": {
    "observedAt": "2023-04-28T15:50:00Z",
    "type": "Property",
    "value": 35000
  },
  "customerLoadIncrease": {
    "observedAt": "2023-04-28T15:50:00Z",
    "type": "Property",
    "value": 6398.4
  },
  "plusDRCount": {
    "observedAt": "2023-04-28T15:50:00Z",
    "type": "Property",
    "value": 4
  },
  "plusDRIncentiveFee": {
    "observedAt": "2023-04-28T15:50:00Z",
    "type": "Property",
    "value": 14000
  }
}

이 URI 를 기계로 받는 법

같은 주소가 Accept 헤더에 따라 세 가지를 돌려줍니다. 리다이렉트 없이 200 을 직접 반환하며 모든 응답에 Vary: Accept 가 붙습니다.

Accept	받는 것
`text/html`	지금 보고 있는 이 문서
`application/json`	모델 정의(원본)
`application/ld+json`	모델 정의 JSON-LD (+ `@context` Link 헤더)

curl -H 'Accept: application/json' http://uri.citydatahub.kr/ngsi-ld/models/EVDRDaily
curl http://uri.citydatahub.kr/ngsi-ld/schemas/EVDRDaily                   # 정본 스키마(FQN 키)
curl 'http://uri.citydatahub.kr/ngsi-ld/schemas/EVDRDaily?keys=compact'    # 짧은 이름 키 스키마
curl http://uri.citydatahub.kr/ngsi-ld/models/EVDRDaily/example            # 예시 데이터(정규 표현) — 과거 버전은 …/versions/{버전}/example
curl http://uri.citydatahub.kr/ngsi-ld/context/v1/core.jsonld                    # @context

검증용 스키마는 모델 주소가 아니라 스키마 주소 /ngsi-ld/schemas/EVDRDaily 에서 받습니다 — 정의(이 문서)와 검증 계약(스키마)을 나눕니다. 이 타입의 식별자(데이터에 찍히는 값)는 http://uri.citydatahub.kr/vocab/EVDRDaily 입니다.

공개되는 스키마는 최신 버전 하나입니다 — 버전을 지정해 스키마를 받는 공개 경로는 없습니다. 과거 버전 문서는 /ngsi-ld/models/EVDRDaily/versions/{버전} 에서 볼 수 있습니다.

EVDRDaily

버전

속성 목록

예제 (NGSI-LD 정규 표현법)

관계 모델

같은 도메인의 다른 모델 (에너지)

이 URI 를 기계로 받는 법