속성 목록

속성명	NGSI-LD 타입	데이터 타입	필수	관측 시각	단위	허용 값 · 범위	설명
`id`	Property	string	필수	해당 없음			맨홀 데이터 인스턴스 ID
`type`	Property	string	필수	해당 없음		`Manhole`	모델 타입
`location`	GeoProperty	GeoJSON	필수	쓰지 않음			위치정보
`isDoorOpen`	Property	boolean	선택	선택			맨홀 뚜껑 열림 여부
`h2s`	Property	double	선택	선택	ppm `59`	최소 0	황화수소 (단위: ppm)
`nh3`	Property	double	선택	선택	ppm `59`	최소 0	암모니아 (단위: ppm)
`floodRiskLevel`	Property	integer	선택	선택		최소 0	홍수 위험 레벨 (0 이상의 정수값)
`refDevice`	Relationship	Relationship	선택	해당 없음			측정기 인스턴스 ID

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

{
  "id": "urn:climate:manhole:0017B2FFFE5021CC",
  "type": "Manhole",
  "location": {
    "type": "GeoProperty",
    "value": {
      "type": "Point",
      "coordinates": [
        127.0016024664,
        37.45281751374
      ]
    }
  },
  "isDoorOpen": {
    "type": "Property",
    "value": false,
    "observedAt": "2025-04-16T16:21:02.000Z"
  },
  "h2s": {
    "type": "Property",
    "value": 0,
    "observedAt": "2025-04-16T16:21:02.000Z"
  },
  "nh3": {
    "type": "Property",
    "value": 0,
    "observedAt": "2025-04-16T16:21:02.000Z"
  },
  "floodRiskLevel": {
    "type": "Property",
    "value": 0,
    "observedAt": "2025-04-16T16:21:02.000Z"
  },
  "refDevice": {
    "type": "Relationship",
    "object": "urn:climate:manhole:0017B2FFFE5021CC"
  }
}

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

AirQualityObserved

대기질 관측 데이터

ExtremeTemperatureDisasterImpactAssessmentInput

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

ExtremeTemperatureDisasterImpactAssessmentResult

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

HydrologicalDisasterImpactAssessmentInput

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

HydrologicalDisasterImpactAssessmentResult

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

OdorObserved

악취 관측 데이터

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

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

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