속성 목록

속성명	NGSI-LD 타입	데이터 타입	필수	관측 시각	단위	허용 값 · 범위	설명
`id`	Property	string	필수	해당 없음			데이터 인스턴스 ID
`type`	Property	string	필수	해당 없음		`EnergyConsumption`	모델 타입
`location`	GeoProperty	GeoJSON	필수	선택			위치정보
`address`	Property	Address	선택	쓰지 않음			측정지 주소
`source`	Property	string	선택	쓰지 않음			데이터 제공자
`refDevice`	Relationship	Relationship	선택	해당 없음			에너지 측정 디바이스 인스턴스 ID
`measurementStartAt`	Property	DateTime	선택	쓰지 않음			에너지 사용량 측정 시작 시각
`measurementEndAt`	Property	DateTime	선택	쓰지 않음			에너지 사용량 측정 종료 시각
`consumedBy`	Relationship	Relationship	선택	해당 없음			에너지 사용 대상 (예: 건물, 공장, 가정) 데이터 인스턴스 ID
`hourlyPowerConsumption`	Property	double	선택	선택	Wh `WHR`		1시간 전기 사용량 (단위: Wh)
`hourlyPeakPower`	Property	double	선택	선택	W `WTT`		1시간 최대 전기 수요 (단위: W)
`powerConsumption`	Property	double	선택	선택	kWh `KWH`		전기 사용량 (단위: kWh)
`waterConsumption`	Property	double	선택	선택	m³ `MTQ`		상수 사용량 (단위: ㎥)
`hotWaterConsumption`	Property	double	선택	선택	m³ `MTQ`		온수 사용량 (단위: ㎥)
`heatingConsumption`	Property	double	선택	선택	kWh `KWH`		난방 에너지 사용량 (단위: kWh)
`gasConsumption`	Property	double	선택	선택	m³ `MTQ`		가스 사용량 (단위: ㎥)

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

{
  "id": "urn:datahub:daegu:EnergyConsumption_001",
  "type": "EnergyConsumption",
  "location": {
    "type": "GeoProperty",
    "value": {
      "type": "Point",
      "coordinates": [
        127.1293735,
        37.4114423
      ]
    }
  },
  "consumedBy": {
    "type": "Relationship",
    "object": "urn:datahub:siheung:house_999"
  },
  "measurementStartAt": {
    "type": "Property",
    "value": "2022-02-11T15:00:00Z",
    "observedAt": "2022-03-11T15:10:00Z"
  },
  "measurementEndAt": {
    "type": "Property",
    "value": "2022-03-11T15:00:00Z",
    "observedAt": "2022-03-11T15:10:00Z"
  },
  "powerConsumption": {
    "type": "Property",
    "value": 200.2,
    "observedAt": "2022-03-11T15:10:00Z"
  },
  "waterConsumption": {
    "type": "Property",
    "value": 8,
    "observedAt": "2022-03-11T15:10:00Z"
  },
  "hotWaterConsumption": {
    "type": "Property",
    "value": 5.8,
    "observedAt": "2022-03-11T15:10:00Z"
  }
}

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

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

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

EnergyConsumption

버전

속성 목록

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

관계 모델

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

이 URI 를 기계로 받는 법