속성 목록

속성명	NGSI-LD 타입	데이터 타입	필수	관측 시각	단위	허용 값 · 범위	설명
`id`	Property	string	필수	해당 없음			데이터 인스턴스 ID
`type`	Property	string	필수	해당 없음		`VehicleTraffic`	모델 타입
`location`	GeoProperty	GeoJSON	필수	선택			위치정보
`address`	Property	Address	필수	쓰지 않음			측정지 주소
`name`	Property	string	선택	쓰지 않음			측정지 도로명
`source`	Property	string	선택	쓰지 않음			데이터 제공자
`refDevice`	Relationship	Relationship	선택	해당 없음			측정기 인스턴스 ID
`measurementStartAt`	Property	DateTime	필수	쓰지 않음			통행량 측정 시작 시각
`measurementEndAt`	Property	DateTime	필수	쓰지 않음			통행량 측정 종료 시각
`trafficPerVehicleType`	Property	TrafficPerVehicleType	선택	쓰지 않음			차량 타입별 교통량 정보
`trafficPerLane`	Property	TrafficPerLane	선택	쓰지 않음			차선별 교통량 정보
`averageSpeed`	Property	double	선택	선택	km/h `KMH`		평균 속도 (단위: Km/h)
`trafficVolume`	Property	integer	선택	선택			통행량

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

{
  "id": "urn:datahub:daegu:VehicleTraffic_001",
  "type": "VehicleTraffic",
  "location": {
    "type": "GeoProperty",
    "value": {
      "type": "Point",
      "coordinates": [
        127.1293735,
        37.4114423
      ]
    }
  },
  "address": {
    "type": "Property",
    "value": {
      "addressCountry": "KR",
      "addressRegion": "경기도",
      "addressLocality": "성남시"
    }
  },
  "measurementStartAt": {
    "type": "Property",
    "value": "2022-03-11T10:05:00Z"
  },
  "measurementEndAt": {
    "type": "Property",
    "value": "2022-03-11T10:10:00Z"
  },
  "trafficPerVehicleType": {
    "type": "Property",
    "value": [
      {
        "vehicleType": "승용차",
        "trafficVolume": 1500,
        "averageSpeed": 70.1
      },
      {
        "vehicleType": "트럭소",
        "trafficVolume": 1500,
        "averageSpeed": 55.1
      }
    ]
  },
  "trafficPerLane": {
    "type": "Property",
    "value": [
      {
        "laneNumber": 1,
        "trafficVolume": 2000,
        "averageSpeed": 75.1
      },
      {
        "laneNumber": 2,
        "trafficVolume": 1000,
        "averageSpeed": 37.6
      }
    ]
  },
  "averageSpeed": {
    "type": "Property",
    "value": 62.6,
    "observedAt": "2022-03-11T10:10:00Z"
  },
  "trafficVolume": {
    "type": "Property",
    "value": 3000,
    "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/VehicleTraffic
curl http://uri.citydatahub.kr/ngsi-ld/schemas/VehicleTraffic                   # 정본 스키마(FQN 키)
curl 'http://uri.citydatahub.kr/ngsi-ld/schemas/VehicleTraffic?keys=compact'    # 짧은 이름 키 스키마
curl http://uri.citydatahub.kr/ngsi-ld/models/VehicleTraffic/example            # 예시 데이터(정규 표현) — 과거 버전은 …/versions/{버전}/example
curl http://uri.citydatahub.kr/ngsi-ld/context/v1/core.jsonld                    # @context

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

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

VehicleTraffic

버전

속성 목록

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

관계 모델

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

이 URI 를 기계로 받는 법