속성 목록

속성명	NGSI-LD 타입	데이터 타입	필수	관측 시각	단위	허용 값 · 범위	설명
`id`	Property	string	필수	해당 없음			수위 측정 데이터 인스턴스 ID
`type`	Property	string	필수	해당 없음		`WaterLevelObserved`	모델 타입
`location`	GeoProperty	GeoJSON	필수	쓰지 않음			위치정보
`address`	Property	Address	선택	쓰지 않음			측정지 주소
`waterDepth`	Property	double	선택	쓰지 않음	m `MTR`		수심 (수면부터 바닥면까지 높이) (단위: m)
`waterLevel`	Property	double	필수	쓰지 않음	m `MTR`		수위 (수면부터 측정지점까지 높이) (단위: m)
`refDevice`	Relationship	Relationship	선택	해당 없음			측정기 인스턴스 ID

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

{
  "id": "urn:climate:waterLevelMeter_50F8A5FFFE0EF3D4",
  "type": "WaterLevelObserved",
  "location": {
    "type": "GeoProperty",
    "value": {
      "type": "Point",
      "coordinates": [
        127.00146743322,
        37.45252538949
      ]
    }
  },
  "waterLevel": {
    "type": "Property",
    "value": 0.03
  },
  "refDevice": {
    "type": "Relationship",
    "object": "urn:climate:waterlevelmeter:50F8A5FFFE0EF3D4"
  }
}

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

AirQualityObserved

대기질 관측 데이터

ExtremeTemperatureDisasterImpactAssessmentInput

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

ExtremeTemperatureDisasterImpactAssessmentResult

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

HydrologicalDisasterImpactAssessmentInput

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

HydrologicalDisasterImpactAssessmentResult

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

Manhole

맨홀 데이터

OdorObserved

악취 관측 데이터

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

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

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