共用方式為

實體中繼資料

  • 發行項

實體中繼資料物件會擷取有關偵測到實體的選擇性額外資訊，提供特別針對數值和時態性實體的解析。 只有在有可用的補充資料時，才會填入此屬性，以增強偵測到實體的完整性。 中繼資料元件包含針對數值和時態性實體所設計的解析。 請務必處理中繼資料屬性可能是空的或不存在的情況，因為每個實體都無法保證其存在。

目前，中繼資料元件會處理實體標準格式的解析。 實體可以各種格式表示，而解析則為常見的可量化類型提供標準可預測格式。 例如，「八十」和「80」都解析為整數 80。

您可以使用具名實體辨識 (NER) 解析來實作動作，或擷取更多資訊。 例如，服務可以擷取日期時間實體，以擷取要提供給會議排程系統的日期和時間。

注意

從 api-version=2023-04-15-preview 開始，才支援實體中繼資料。 針對較舊的 API 版本，您可以參閱實體解析一文。

本文記載中繼資料物件下每個實體類別或子類別傳回的解析物件。

數值實體

年齡

範例：「10 歲」、「23 個月大」、「60 Y.O.」

"metadata": {
                "unit": "Year",
                "value": 10
            }

「單位」的可能值：

  • Year
  • 月
  • 週
  • Day

貨幣

範例：「30 埃及鎊」、「77 美元」

"metadata": {
                "unit": "Egyptian pound",
                "ISO4217": "EGP",
                "value": 30
            }

「單位」和「ISO4217」的可能值：

日期時間/時態性實體

日期時間包含會傳回不同回應物件的數個不同的子類型。

Date

特定日期。

範例：「1995 年 1 月 1 日」、「4 月 12 日」、「2022 年 10 月 7 日」、「明天」

"metadata": {
                "dateValues": [
                    {
                        "timex": "1995-01-01",
                        "value": "1995-01-01"
                    }
                ]
            }

在提供不明確的日期時，解析會提供不同的選項。 例如，「4 月 12 日」可以是在任何年份。 解析會提供今年和明年作為選項。 timex 值 XXXX 表示查詢未指定年份。

"metadata": {
                "dateValues": [
                    {
                        "timex": "XXXX-04-12",
                        "value": "2022-04-12"
                    },
                    {
                        "timex": "XXXX-04-12",
                        "value": "2023-04-12"
                    }
                ]
            }

即使指定星期幾也可能會發生模棱兩可的情況。 例如，「星期一」可能是上星期一或這星期一。 再一次地，timex 值表示年份或月份並未指定，並使用星期幾的識別碼 (W) 來表示一週的第一天。

"metadata" :{
                "dateValues": [
                    {
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-03"
                    },
                    {
                        "timex": "XXXX-WXX-1",
                        "value": "2022-10-10"
                    }
                ]
            }

Time

特定時間。

範例：「上午 9：39：33」、「上午 7 點」、「20：03」

"metadata": {
                "timex": "T09:39:33",
                "value": "09:39:33"
            }

Datetime

特定日期與時間組合。

範例：「明天下午 6 點」、「1 月 3 日下午 8 點」、「11 月 1日 19：30」

"metadata": {
                "timex": "2022-10-07T18",
                "value": "2022-10-07 18:00:00"
            }

與日期類似，您也可能會有不明確的日期時間實體。 例如，「5 月 3 日中午」可以是任何年份。 解析會提供今年和明年作為選項。 timex 值 XXXX 表示未指定年份。

"metadata": {
                 "dateValues": [ 
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2022-05-03 12:00:00"
                       },
                       {
                           "timex": "XXXX-05-03T12",
                           "value": "2023-05-03 12:00:00"
                       }
                  ]
              }

日期時間範圍

日期時間範圍是一段期間，包含開始和結束日期、時間或日期時間的期間。

範例：「2022 年 1 月 3 日上午 6 點到 4 月 25 日下午 8 點」、「星期一到星期四」、「六月」、「週末」

「期間」參數以秒 (S)、分 (M)、小時 (H) 或天 (D) 來表示過去的時間。 只有查詢中明確指定開始和結束的日期時間，才會傳回此參數。 「下週」只會傳回一週的「開始」和「結束」參數。

"metadata": {
                "duration": "PT2702H",
                "begin": "2022-01-03 06:00:00",
                "end": "2022-04-25 20:00:00"
            }

設定

集合是週期性的日期時間週期。 集合不會解析為確切值，因其不會指出確切的日期時間。

範例：「每星期一下午 6 點」、「每星期四」、「每週末」

針對「每星期一下午 6 點」，timex 值以 XXXX 開頭表示未指定年份，然後透過 WXX-1 判斷每週的第一天是每星期一，最後以 T18 表示下午 6 點。

"metadata": {
                "timex": "XXXX-WXX-1T18",
                "value": "not resolved"
            }

維度

範例：「24 公里/小時」、「44 平方公尺」、「66 KB」

"metadata": {
                "unit": "KilometersPerHour",
                "value": 24
            }

「單位」欄位值的可能值：

  • 若是量值：

    • SquareKilometer
    • SquareHectometer
    • SquareDecameter
    • SquareMeter
    • SquareDecimeter
    • SquareCentimeter
    • SquareMillimeter
    • SquareInch
    • SquareFoot
    • SquareMile
    • SquareYard
    • Acre

  • 如需資訊:

    • 位元
    • 千位元
    • 百萬位元
    • Gigabit
    • 兆位元
    • 千萬億位元
    • Byte
    • KB
    • MB
    • GB
    • TB
    • PB

  • 若是長度、寬度、高度：

    • 公里
    • 一百公尺
    • 十公尺
    • 計量
    • 公寸
    • 公分
    • 公釐
    • Micrometer
    • 奈米
    • 皮米
    • 英里
    • 碼
    • 英寸
    • 英尺
    • 光年
    • Pt

  • 若是速度：

    • MetersPerSecond
    • KilometersPerHour
    • KilometersPerMinute
    • KilometersPerSecond
    • MilesPerHour
    • 每小時 1 海里
    • FootPerSecond
    • FootPerMinute
    • YardsPerMinute
    • YardsPerSecond
    • MetersPerMillisecond
    • CentimetersPerMillisecond
    • KilometersPerMillisecond

  • 若是磁碟區：

    • CubicMeter
    • CubicCentimeter
    • CubicMillimiter
    • 百公升
    • 十公升
    • 公升
    • 十分之一公升
    • 厘升
    • 毫升
    • CubicYard
    • CubicInch
    • CubicFoot
    • CubicMile
    • FluidOunce
    • 茶匙
    • 湯匙
    • 品脫
    • 夸脫
    • 杯
    • Gill
    • 捏合
    • FluidDram
    • 桶
    • 量滴
    • 考得
    • 配克
    • 蒲式耳
    • 拱桶

  • 若是重量:

    • Kilogram
    • Gram
    • Milligram
    • Microgram
    • 加侖
    • MetricTon
    • 噸
    • 磅
    • 盎司
    • 粒紋
    • Penyweight
    • LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • 英石
    • 打蘭

序數

範例：「第三」、「第一」、「最後」

"metadata": {
                "offset": "3",
                "relativeTo": "Start",
                "value": "3"
            }

"relativeTo" 的可能值：

  • 啟動
  • 尾端

溫度

範例：「華氏 88 度」、「攝氏 23 度」

"metadata": {
                "unit": "Fahrenheit",
                "value": 88
            }

「單位」的可能值：

  • 攝氏
  • 華氏
  • 凱氏
  • 蘭氏