实体：警报

开放许可

文件自动生成

全局描述：由指定位置的用户或设备发出的警报

版本： 0.0.3

属性列表

^{_{[*] 如果属性中没有类型，是因为它可能有多个类型或不同的格式/模式}}。

address[object]: 邮寄地址 . Model: https://schema.org/address
- addressCountry[string]: 国家。例如，西班牙 . Model: https://schema.org/addressCountry
- addressLocality[string]: 街道地址所在的地点，以及该地点所在的区域 . Model: https://schema.org/addressLocality
- addressRegion[string]: 地点所在的地区，以及该地区位于哪个国家 . Model: https://schema.org/addressRegion
- district[string]: 地区是一种行政区划，在一些国家由地方政府管理
- postOfficeBoxNumber[string]: 用于邮政信箱地址的邮政信箱号码。例如：03578 . Model: https://schema.org/postOfficeBoxNumber
- postalCode[string]: 邮政编码。例如：24004 . Model: https://schema.org/https://schema.org/postalCode
- streetAddress[string]: 街道地址 . Model: https://schema.org/streetAddress
alertSource[*]: 警报来源 . Model: http://schema.org/URL
alternateName[string]: 该项目的替代名称
areaServed[string]: 提供服务或提供物品的地理区域 . Model: https://schema.org/Text
category[string]: 警报类别。枚举：'交通、自然灾害、天气、环境、健康、安全、农业'。
data[object]: 包含检索数据的有效载荷
dataProvider[string]: 标识统一数据实体提供者的字符序列
dateCreated[date-time]: 实体创建时间戳。通常由存储平台分配
dateIssued[date-time]: 以 ISO8601 UTC 格式表示的项目发布日期和时间 . Model: https://schema.org/DateTime
dateModified[date-time]: 实体最后一次修改的时间戳。通常由存储平台分配
description[string]: 项目描述
id[*]: 实体的唯一标识符
location[*]: 项目的 Geojson 引用。它可以是点、线条字符串、多边形、多点、多线条字符串或多多边形
name[string]: 该项目的名称
owner[array]: 包含一个 JSON 编码字符序列的列表，其中引用了所有者的唯一 Ids
seeAlso[*]: 指向有关该项目的其他资源的 uri 列表
severity[string]: 警报的严重程度
source[string]: 以 URL 形式给出实体数据原始来源的字符串。建议使用源提供者的完全合格域名或源对象的 URL
subCategory[string]: 描述警报的子类别。枚举：交通堵塞、汽车事故、汽车方向错误、汽车停驶、坑洞、道路关闭、道路施工、道路上的危险、受伤的骑车者、道路上的行人、道路上的骑车者、电车接近、洪水、海啸、沿海事件、地震、降雨、高温、低温、热浪、寒潮、冰、雪、风、雾、龙卷风、热带气旋、飓风、冰雪、雷暴、火灾风险、雪崩风险、洪水风险、空气污染、水污染、花粉浓度、哮喘发作、撞伤病人、摔伤病人、心脏病发作、可疑行动、抢劫、袭击、内乱、建筑火灾、森林火灾、有害杂草、蜗牛、昆虫、啮齿动物、细菌、微生物、真菌、螨虫、病毒、线虫、灌溉、施肥
type[string]: NGSI 实体类型。必须是警报
validFrom[date-time]: 该预报有效期的起始时间（ISO8601 格式 . Model: https://schema.org/DateTime
validTo[date-time]: ISO8601 格式的预报有效期结束时间 . Model: https://schema.org/DateTime

所需属性

alertSource
category
dateIssued
id
type

该实体为警报模型，可用于发送与交通堵塞、事故、天气状况、高浓度污染物等相关的警报。该模型的目的是支持根据这些警报为用户生成通知或触发其他操作。警报由特定情况生成。警报的主要特点是不可预测，也不是重复出现的数据。这意味着，警报可能是一起事故或污染物测量值过高，也可能是病人摔倒或汽车逆向行驶。背景数据的一些示例包括：警报类型（交通、天气、安全和污染等）、严重程度、位置等。

属性的数据模型描述

按字母顺序排列（点击查看详情）

full yaml details

Alert:      
  description: An alert generated by a user or device in a given location      
  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      
    alertSource:      
      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: Source of the alert      
      x-ngsi:      
        model: http://schema.org/URL      
        type: Relationship      
    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      
    category:      
      description: 'Category of the Alert. Enum:''traffic, naturalDisaster, weather, environment, health, security, agriculture'''      
      enum:      
        - traffic      
        - naturalDisaster      
        - weather      
        - environment      
        - health      
        - security      
        - agriculture      
      type: string      
      x-ngsi:      
        type: Property      
    data:      
      description: Payload containing the data retrieved      
      type: object      
      x-ngsi:      
        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      
    dateIssued:      
      description: The date and time the item was issued in ISO8601 UTC format      
      format: date-time      
      type: string      
      x-ngsi:      
        model: https://schema.org/DateTime      
        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      
    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      
    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      
    name:      
      description: The name of this item      
      type: string      
      x-ngsi:      
        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      
    severity:      
      description: Severity of the Alarm      
      enum:      
        - informational      
        - low      
        - medium      
        - high      
        - critical      
      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      
    subCategory:      
      anyOf:      
        - enum:      
            - airPollution      
            - assault      
            - asthmaAttack      
            - avalancheRisk      
            - bacteria      
            - badSeaState      
            - bikerOnRoad      
            - buildingFire      
            - bumpedPatient      
            - carAccident      
            - carStopped      
            - carWrongDirection      
            - coastalEvent      
            - civilDisorder      
            - coldWave      
            - crowdRisk      
            - earthquake      
            - fallenPatient      
            - fertilisation      
            - fireRisk      
            - flood      
            - floodRisk      
            - fog      
            - forestFire      
            - fungus      
            - hazardOnRoad      
            - heartAttack      
            - heatWave      
            - highAtmosphericPressure      
            - highHumidity      
            - highTemperature      
            - hurricane      
            - ice      
            - injuredBiker      
            - insect      
            - irrigation      
            - lowAtmosphericPressure      
            - lowHumidity      
            - lowTemperature      
            - microbe      
            - mite      
            - nematodes      
            - noxiousWeed      
            - pedestrianOnRoad      
            - pollenConcentration      
            - pothole      
            - rainfall      
            - roadClosed      
            - roadWorks      
            - robbery      
            - rodent      
            - snail      
            - snow      
            - snow/ice      
            - suspiciousAction      
            - thunderstorms      
            - tornado      
            - trafficJam      
            - tramApproaching      
            - tropicalCyclone      
            - tsunami      
            - virus      
            - waterPollution      
            - wind      
        - description: 'Weather categories. Enum:'' avalanches,coastalEvent, coldWave, flood, fog, forestFire, heatWave, highTemperature, hurricane, ice, lowTemperature, rainfall, rain_flood, snow, snow_ice, thunderstorms, tornado, tropicalCyclone, tsunami, wind'''      
          enum:      
            - avalanches      
            - coastalEvent      
            - coldWave      
            - flood      
            - fog      
            - forestFire      
            - heatWave      
            - highTemperature      
            - hurricane      
            - ice      
            - lowTemperature      
            - rainfall      
            - rain_flood      
            - snow      
            - snow_ice      
            - thunderstorms      
            - tornado      
            - tropicalCyclone      
            - tsunami      
            - wind      
          type: string      
          x-ngsi:      
            type: Property      
      description: 'Describe the sub category of alert. Enum:''trafficJam, carAccident, carWrongDirection, carStopped, pothole, roadClosed, roadWorks, hazardOnRoad, injuredBiker, pedestrianOnRoad, bikerOnRoad, tramApproaching, flood, tsunami, coastalEvent, earthquake, rainfall, highTemperature, lowTemperature, heatWave, coldWave, ice, snow, wind, fog, tornado, tropicalCyclone, hurricane, snow/ice, thunderstorms, fireRisk, avalancheRisk, floodRisk, airPollution, waterPollution, pollenConcentration, asthmaAttack, bumpedPatient, fallenPatient, heartAttack, suspiciousAction, robbery, assault, civilDisorder, buildingFire, forestFire, noxiousWeed, snail, insect, rodent, bacteria, microbe, fungus,mite, virus, nematodes, irrigation, fertilisation'      
      type: string      
      x-ngsi:      
        type: Property      
    type:      
      description: NGSI Entity type. It has to be Alert      
      enum:      
        - Alert      
      type: string      
      x-ngsi:      
        type: Property      
    validFrom:      
      description: The start of the validity period for this forecast as a ISO8601 format      
      format: date-time      
      type: string      
      x-ngsi:      
        model: https://schema.org/DateTime      
        type: Property      
    validTo:      
      description: The end of the validity period for this forecast as a ISO8601 format      
      format: date-time      
      type: string      
      x-ngsi:      
        model: https://schema.org/DateTime      
        type: Property      
  required:      
    - id      
    - type      
    - alertSource      
    - category      
    - dateIssued      
  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.Alert/blob/master/Alert/LICENSE.md      
  x-model-schema: https://smart-data-models.github.io/dataModel.Alert/alert/schema.json      
  x-model-tags: ""      
  x-version: 0.0.3

有效载荷示例

警报 NGSI-v2 键值示例

下面是一个以 JSON-LD 格式作为 key-values 的 Alert 示例。当使用 options=keyValues 时，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。

show/hide example

{  
  "id": "Alert:1",  
  "type": "Alert",  
  "category": "traffic",  
  "subCategory": "trafficJam",  
  "severity": "high",  
  "location": {  
    "type": "Point",  
    "coordinates": [  
      -3.712247222222222,  
      40.423852777777775  
    ]  
  },  
  "dateIssued": "2017-01-02T09:25:55.00Z",  
  "validFrom": "2017-01-02T09:25:55.00Z",  
  "validTo": "2017-01-02T10:25:55.00Z",  
  "description": "The road is completely blocked for 3kms",  
  "alertSource": "https://account.lab.fiware.org/users/8"  
}

警报 NGSI-v2 标准化示例

下面是一个规范化 JSON-LD 格式的警报示例。在不使用选项的情况下，它与 NGSI-v2 兼容，并返回单个实体的上下文数据。

show/hide example

{  
  "id": "Alert:1",  
  "type": "Alert",  
  "dateCreated": {  
    "type": "DateTime",  
    "value": "2019-06-06T12:06:06"  
  },  
  "dateModified": {  
    "type": "DateTime",  
    "value": "2019-06-07T12:07:06"  
  },  
  "category": {  
    "type": "Text",  
    "value": "traffic"  
  },  
  "subCategory": {  
    "type": "Text",  
    "value": "trafficJam"  
  },  
  "validTo": {  
    "type": "DateTime",  
    "value": "2017-01-02T10:25:55.00Z"  
  },  
  "description": {  
    "type": "Text",  
    "value": "The road is completely blocked for 3kms"  
  },  
  "location": {  
    "type": "geo:json",  
    "value": {  
      "type": "Point",  
      "coordinates": [  
        -3.712247222222222,  
        40.423852777777775  
      ]  
    }  
  },  
  "dateIssued": {  
    "type": "DateTime",  
    "value": "2017-01-02T09:25:55.00Z"  
  },  
  "alertSource": {  
    "type": "Text",  
    "value": "https://account.lab.fiware.org/users/8"  
  },  
  "validFrom": {  
    "type": "DateTime",  
    "value": "2017-01-02T09:25:55.00Z"  
  },  
  "severity": {  
    "type": "Text",  
    "value": "high"  
  }  
}

警报 NGSI-LD 键值示例

下面是一个以 JSON-LD 格式作为 key-values 的 Alert 示例。当使用 options=keyValues 时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。

show/hide example

{  
  "id": "urn:ngsi-ld:Alert:Alert:1",  
  "type": "Alert",  
  "alertSource": "https://account.lab.fiware.org/users/8",  
  "category": "traffic",  
  "createdAt": "2019-06-06T12:06:06",  
  "dateIssued": "2017-01-02T09:25:55.00Z",  
  "description": "The road is completely blocked for 3kms",  
  "location": {  
    "coordinates": [  
      -3.712247222222222,  
      40.423852777777775  
    ],  
    "type": "Point"  
  },  
  "modifiedAt": "2019-06-07T12:07:06",  
  "severity": "high",  
  "subCategory": "trafficJam",  
  "validFrom": "2017-01-02T09:25:55.00Z",  
  "validTo": "2017-01-02T10:25:55.00Z",  
  "@context": [  
    "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld",  
    "https://raw.githubusercontent.com/smart-data-models/dataModel.Alert/master/context.jsonld"  
  ]  
}

警报 NGSI-LD 正常化示例

下面是一个规范化 JSON-LD 格式的警报示例。当不使用选项时，它与 NGSI-LD 兼容，并返回单个实体的上下文数据。

show/hide example

{  
    "id": "urn:ngsi-ld:Alert:Alert:1",  
    "type": "Alert",  
    "alertSource": {  
        "type": "Property",  
        "value": "https://account.lab.fiware.org/users/8"  
    },  
    "category": {  
        "type": "Property",  
        "value": "traffic"  
    },  
    "createdAt": "2019-06-06T12:06:06",  
    "dateIssued": {  
        "type": "Property",  
        "value": {  
            "@type": "DateTime",  
            "@value": "2017-01-02T09:25:55.00Z"  
        }  
    },  
    "description": {  
        "type": "Property",  
        "value": "The road is completely blocked for 3kms"  
    },  
    "location": {  
        "type": "GeoProperty",  
        "value": {  
            "type": "Point",  
            "coordinates": [  
                -3.712247222222222,  
                40.423852777777775  
            ]  
        }  
    },  
    "modifiedAt": "2019-06-07T12:07:06",  
    "severity": {  
        "type": "Property",  
        "value": "high"  
    },  
    "subCategory": {  
        "type": "Property",  
        "value": "trafficJam"  
    },  
    "validFrom": {  
        "type": "Property",  
        "value": {  
            "@type": "DateTime",  
            "@value": "2017-01-02T09:25:55.00Z"  
        }  
    },  
    "validTo": {  
        "type": "Property",  
        "value": {  
            "@type": "DateTime",  
            "@value": "2017-01-02T10:25:55.00Z"  
        }  
    },  
    "@context": [  
        "https://uri.etsi.org/ngsi-ld/v1/ngsi-ld-core-context.jsonld",  
        "https://raw.githubusercontent.com/smart-data-models/dataModel.Alert/master/context.jsonld"  
    ]  
}

请参阅 FAQ 10，获取如何处理幅度单位的答案。

Smart Data Models +++ Contribution Manual +++ About

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Files

spec_ZH.md

spec_ZH.md

实体：警报

属性列表

属性的数据模型描述

有效载荷示例

警报 NGSI-v2 键值示例

警报 NGSI-v2 标准化示例

警报 NGSI-LD 键值示例

警报 NGSI-LD 正常化示例

Files

spec_ZH.md

Latest commit

History

spec_ZH.md

File metadata and controls

实体：警报

属性列表

属性的数据模型描述

有效载荷示例

警报 NGSI-v2 键值示例

警报 NGSI-v2 标准化示例

警报 NGSI-LD 键值示例

警报 NGSI-LD 正常化示例