Metadati dell'entità

Articolo
12/19/2023

L'oggetto Entity Metadata acquisisce informazioni aggiuntive facoltative sulle entità rilevate, fornendo risoluzioni specifiche per entità numeriche e temporali. Questo attributo viene popolato solo quando sono disponibili dati supplementari, migliorando la completezza delle entità rilevate. Il componente Metadati include risoluzioni progettate per entità numeriche e temporali. È importante gestire i casi in cui l'attributo Metadati può essere vuoto o assente, perché la sua presenza non è garantita per ogni entità.

Attualmente, i componenti dei metadati gestiscono le risoluzioni in un formato standard per un'entità. Le entità possono essere espresse in varie forme e risoluzioni forniscono formati prevedibili standard per tipi quantifibili comuni. Ad esempio, "80" e "80" devono essere risolti nell'intero 80.

È possibile usare le risoluzioni NER per implementare azioni o recuperare ulteriori informazioni. Ad esempio, il servizio può estrarre entità datetime per estrarre date e orari forniti a un sistema di pianificazione delle riunioni.

Nota

I metadati delle entità sono supportati solo a partire dall'api-version=2023-04-15-preview. Per le versioni precedenti dell'API, è possibile controllare l'articolo Risoluzioni entità.

Questo articolo documenta gli oggetti di risoluzione restituiti per ogni categoria di entità o sottocategoria nell'oggetto metadati.

Entità numeriche

Età

Esempi: "10 anni", "23 mesi fa", "sessanta Y.O".

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

Valori possibili per "unit":

Year
Month
Settimana
Giorno

Valuta

Esempi: "30 sterline egiziane", "77 USD"

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

Valori possibili per "unit" e "ISO4217":

Riferimento ISO 4217.

Entità datetime/temporali

Datetime include diversi sottotipi che restituiscono oggetti di risposta diversi.

Data

Giorni specifici.

Esempi: "1 gennaio 1995", "12 aprile", "7 ottobre 2022", "domani"

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

Ogni volta che viene fornita una data ambigua, vengono offerte diverse opzioni per la risoluzione. Ad esempio, "12 aprile" può fare riferimento a qualsiasi anno. La risoluzione fornisce quest'anno e la prossima come opzioni. Il timex valore XXXX indica che non è stato specificato alcun anno nella query.

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

L'ambiguità può verificarsi anche per un determinato giorno della settimana. Ad esempio, dicendo "Lunedì" potrebbe fare riferimento all'ultimo lunedì o al lunedì. Ancora una volta il timex valore indica che non è stato specificato alcun anno o mese e usa un giorno dell'identificatore della settimana (W) per indicare il primo giorno della settimana.

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

Ora

Tempi specifici.

Esempi: "9:39:33", "sette AM", "20:03"

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

Datetime

Combinazioni di data e ora specifiche.

Esempi: "6 PM domani", "8 PM il 3 gennaio", "1 novembre 19:30"

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

Analogamente alle date, è possibile avere entità datetime ambigue. Ad esempio, "Il 3 maggio" potrebbe fare riferimento a qualsiasi anno. La risoluzione fornisce quest'anno e la prossima come opzioni. Il timex valore XXXX indica che non è stato specificato alcun anno.

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

Intervalli datetime

Un intervallo datetime è un periodo con una data di inizio e fine, ora o datetime.

Esempi: "dal 3 gennaio al 25 aprile 2022", "tra lunedì e giovedì", "giugno", "fine settimana"

Il parametro "duration" indica il tempo passato in secondi (S), minuti (M), ore (H) o giorni (D). Questo parametro viene restituito solo quando una data ora di inizio e di fine esplicita si trova nella query. "Prossima settimana" restituirebbe solo i parametri "begin" e "end" per la settimana.

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

Set

Un set è un periodo datetime ricorrente. I set non vengono risolti in valori esatti, poiché non indicano una datatime esatta.

Esempi: "ogni lunedì alle 6:00", "ogni giovedì", "ogni fine settimana"

Per "ogni lunedì alle 6:00", il timex valore indica nessun anno specificato con l'inizio XXXX, quindi ogni lunedì fino a WXX-1 per determinare il primo giorno di ogni settimana e infine T18 per indicare 6 PM.

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

Dimensioni

Esempi: "24 km/hr", "44 metri quadrati", "sessanta kilobyte"

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

Valori possibili per i valori di campo "unit":

Per le misurazioni:
- SquareKilometer
- SquareHectometer
- SquareDecameter
- SquareMeter
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- SquareInch
- SquareFoot
- SquareMile
- SquareYard
- Acre
Per informazioni:
- bit
- Kilobit
- Megabit
- Gbit
- Terabit
- Petabit
- Byte
- Kilobyte
- Megabyte
- Gigabyte
- Terabyte
- Petabyte
Per Lunghezza, larghezza, altezza:
- Chilometro
- Hectometer
- Decameter
- Contatore
- Decimeter
- Centimetro
- Millimetri
- Micrometer
- Nanometro
- Picometro
- Miglio
- Cortile
- Pollici
- Piede
- Anno leggero
- Pt
Per velocità:
- MetriPerSecond
- ChilometriPerHour
- ChilometriPerMinute
- ChilometriPerSecond
- MilesPerHour
- Nodo
- Piè di pagina
- FootPerMinute
- YardPerMinute
- YardPerSecond
- MetriPerMillisecond
- CentimetriPerMillisecondo
- ChilometriPerMillisecond
Per Volume:
- CubicMeter
- CubicCentimeter
- CubicMillimiter
- Hectoliter
- Decaliter
- Litro
- Decilitro
- Centiliter
- Millilitro
- CubicYard
- CubicInch
- CubicFoot
- CubicMile
- FluidOunce
- Cucchiaino
- Cucchiaio
- Pinta
- Quart
- Tazza
- Gill
- Avvicinamento delle dita
- FluidDram
- Barile
- Minim
- Cavo
- Peck
- Moggio
- Botte
Per Peso:
- Chilogrammo
- Grammo
- Milligrammo
- Microgrammi
- Gallone
- MetricTon
- Tonnellata
- Libbra
- Oncia
- Grano
- Pennyweight
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Pietra
- Dram

Ordinale

Esempi: "3rd", "first", "last"

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

Valori possibili per "relativeTo":

Avvio
Fine

Temperatura

Esempi: "88 deg fahrenheit", "venti tre gradi celsius"

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