속성 목록

속성명	NGSI-LD 타입	데이터 타입	필수	관측 시각	단위	허용 값 · 범위	설명
`id`	Property	string	필수	해당 없음			악취 측정 데이터 인스턴스 ID
`type`	Property	string	필수	해당 없음		`OdorObserved`	모델 타입
`location`	GeoProperty	GeoJSON	필수	선택			위치정보
`address`	Property	Address	선택	쓰지 않음			측정지 주소
`source`	Property	string	선택	쓰지 않음			데이터 제공자
`refDevice`	Relationship	Relationship	선택	해당 없음			측정기 인스턴스 ID
`h2s`	Property	double	선택	선택	ppm `59`	최소 0	황화수소(H₂S) 농도 (단위: ppm)
`nh3`	Property	double	선택	선택	ppm `59`	최소 0	암모니아(NH₃) 농도 (단위: ppm)
`voc`	Property	double	선택	선택	ppm `59`	최소 0	휘발성유기화합물(VOC) 농도 (단위: ppm)

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

{
  "id": "urn:datahub:siheung:OdorObserved_001",
  "type": "OdorObserved",
  "location": {
    "type": "GeoProperty",
    "value": {
      "type": "Point",
      "coordinates": [
        127.1293735,
        37.4114423
      ]
    }
  },
  "h2s": {
    "type": "Property",
    "value": 0.1,
    "observedAt": "2022-03-11T20:09:55Z"
  },
  "nh3": {
    "type": "Property",
    "value": 0.04,
    "observedAt": "2022-03-11T20:09:55Z"
  },
  "voc": {
    "type": "Property",
    "value": 1.6,
    "observedAt": "2022-03-11T20:09:55Z"
  }
}

같은 도메인의 다른 모델 (환경)

AirQualityObserved

대기질 관측 데이터

ExtremeTemperatureDisasterImpactAssessmentInput

폭염한파 영향평가 입력 데이터

ExtremeTemperatureDisasterImpactAssessmentResult

폭염한파 영향평가 결과 데이터

HydrologicalDisasterImpactAssessmentInput

홍수가뭄 영향평가 입력 데이터

HydrologicalDisasterImpactAssessmentResult

홍수가뭄 영향평가 결과 데이터

Manhole

맨홀 데이터

WaterLevelObserved

수위 관측 데이터

WaterQualityObserved

수질 관측 데이터

WeatherObserved

날씨 관측 데이터

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

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

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