속성 목록

속성명	NGSI-LD 타입	데이터 타입	필수	관측 시각	허용 값 · 범위	설명
`id`	Property	string	필수	해당 없음		데이터 인스턴스 ID
`type`	Property	string	필수	해당 없음	`TrafficEvent`	모델 타입
`location`	GeoProperty	GeoJSON	필수	선택		위치정보
`address`	Property	Address	필수	쓰지 않음		측정지 주소
`name`	Property	string	선택	쓰지 않음		측정지 도로명
`source`	Property	string	선택	쓰지 않음		데이터 제공자
`refDevice`	Relationship	Relationship	선택	해당 없음		이벤트 검출기 인스턴스 ID
`vehicleType`	Property	string	선택	선택	`승용차이륜차버스소버스대트럭소` 외 1 · 전체	차량 타입 (허용값은 표 7-6 참고)
`trafficEventType`	Property	string	필수	선택	`차량-차량 충돌차량-사람 충돌차량-기물 충돌무단횡단끼어들기` 외 8 · 전체	돌발 교통 이벤트 타입

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

{
  "id": "urn:datahub:daegu:TrafficEvent_001",
  "type": "TrafficEvent",
  "location": {
    "type": "GeoProperty",
    "value": {
      "type": "Point",
      "coordinates": [
        127.1293735,
        37.4114423
      ]
    }
  },
  "address": {
    "type": "Property",
    "value": {
      "addressCountry": "KR",
      "addressRegion": "경기도",
      "addressLocality": "성남시"
    }
  },
  "vehicleType": {
    "type": "Property",
    "value": "승용차",
    "observedAt": "2022-03-11T10:10:00Z"
  },
  "trafficEventType": {
    "type": "Property",
    "value": "과속",
    "observedAt": "2022-03-11T10: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/TrafficEvent
curl http://uri.citydatahub.kr/ngsi-ld/schemas/TrafficEvent                   # 정본 스키마(FQN 키)
curl 'http://uri.citydatahub.kr/ngsi-ld/schemas/TrafficEvent?keys=compact'    # 짧은 이름 키 스키마
curl http://uri.citydatahub.kr/ngsi-ld/models/TrafficEvent/example            # 예시 데이터(정규 표현) — 과거 버전은 …/versions/{버전}/example
curl http://uri.citydatahub.kr/ngsi-ld/context/v1/core.jsonld                    # @context

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

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

TrafficEvent

버전

속성 목록

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

관계 모델

같은 도메인의 다른 모델 (교통)

이 URI 를 기계로 받는 법