Entitások feloldása szabványos formátumokra
A feloldás egy entitás szabványos formátuma. Az entitások különböző formában fejezhetők ki, és a felbontások szabványos kiszámítható formátumokat biztosítanak a közös számszerűsíthető típusok számára. Például a "nyolcvan" és a "80" függvénynek egyaránt fel kell oldania az egész számot 80.
A NER-feloldásokkal műveleteket valósíthat meg, vagy további információkat kaphat. A szolgáltatás például kinyerheti a datetime entitásokat az értekezletütemezési rendszer számára biztosított dátumok és időpontok kinyeréséhez.
Fontos
Az entitásfeloldási funkciót a 2023-04-15-ös verziótól kezdve az entitás metaadatai váltják fel
Feljegyzés
Az entitásfeloldási válaszok csak az api-version=2022-10-01-preview és a "modelVersion" verziótól kezdve támogatottak: "2022-10-01-preview".
Ez a cikk az egyes entitáskategóriákhoz vagy alkategóriákhoz visszaadott feloldási objektumokat ismerteti.
Kor
Példák: "10 éves", "23 hónapos", "hatvan Y.O."
"resolutions": [
{
"resolutionKind": "AgeResolution",
"unit": "Year",
"value": 10
}
]
Az "egység" lehetséges értékei:
- Year
- Month
- Hét
- Nap
Pénznem
Példák: "30 egyiptomi font", "77 USD"
"resolutions": [
{
"resolutionKind": "CurrencyResolution",
"unit": "Egyptian pound",
"ISO4217": "EGP",
"value": 30
}
]
Az "egység" és a "ISO4217" lehetséges értékei:
Datetime
A Datetime számos különböző altípust tartalmaz, amelyek különböző válaszobjektumokat ad vissza.
Dátum
Adott napok.
Példák: "1995. január 1.", "április 12.", "2022. október 7.", "holnap"
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "1995-01-01",
"value": "1995-01-01"
}
]
Ha kétértelmű dátumot ad meg, különböző lehetőségeket kínálunk a megoldáshoz. Az "április 12." például bármely évre vonatkozhat. Az állásfoglalás ebben az évben és a következő évben is lehetőséget biztosít. Az timex érték XXXX azt jelzi, hogy nincs megadva év a lekérdezésben.
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "XXXX-04-12",
"value": "2022-04-12"
},
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "XXXX-04-12",
"value": "2023-04-12"
}
]
A kétértelműség a hét egy adott napján is előfordulhat. Például a "hétfő" kifejezés a múlt hétfőre vagy erre a hétfőre utalhat. Az érték ismét timex azt jelzi, hogy nincs megadva év vagy hónap, és a hét egyik napjának azonosítóját (W) használva jelzi a hét első napját.
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "XXXX-WXX-1",
"value": "2022-10-03"
},
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Date",
"timex": "XXXX-WXX-1",
"value": "2022-10-10"
}
]
Idő
Adott időpontokban.
Példák: "9:39:33", "hét óra", "20:03"
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Time",
"timex": "T09:39:33",
"value": "09:39:33"
}
]
Datetime
Adott dátum- és időkombinációk.
Példák: "holnap 18:00", "20:00 január 3-án", "nov 1 19:30"
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "DateTime",
"timex": "2022-10-07T18",
"value": "2022-10-07 18:00:00"
}
]
A dátumokhoz hasonlóan kétértelmű datetime entitások is lehetnek. A "Május 3. dél" kifejezés például bármely évre vonatkozhat. Az állásfoglalás ebben az évben és a következő évben is lehetőséget biztosít. Az timex XXXX érték azt jelzi, hogy nincs megadva év.
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "DateTime",
"timex": "XXXX-05-03T12",
"value": "2022-05-03 12:00:00"
},
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "DateTime",
"timex": "XXXX-05-03T12",
"value": "2023-05-03 12:00:00"
}
]
Datetime-tartományok
A dátum/idő tartomány olyan időszak, amelynek kezdő és befejező dátuma, ideje vagy dátumideje van.
Példák: "2022. január 3. 06:00 és 2022. április 25. 25. között", "hétfőtől csütörtökig", "június", "hétvége"
Az "duration" paraméter másodpercben (S), percben (M), órákban (H) vagy napokban (D) megadott időt jelzi. Ezt a paramétert csak akkor adja vissza a rendszer, ha a lekérdezésben explicit kezdési és befejezési dátum szerepel. A "Jövő hét" csak a hét "kezdő" és "vége" paraméterével tér vissza.
"resolutions": [
{
"resolutionKind": "TemporalSpanResolution",
"duration": "PT2702H",
"begin": "2022-01-03 06:00:00",
"end": "2022-04-25 20:00:00"
}
]
Set
A készlet ismétlődő dátum/idő időszak. A készletek nem oldják fel a pontos értékeket, mivel nem jeleznek pontos dátumot.
Példák: "minden hétfőn 18:00-kor", "minden csütörtökön", "minden hétvégén"
A "minden hétfőn 18:00-kor" timex érték a kezdő XXXX-hez nem megadott évet, majd minden hétfőn a WXX-1-től a hét első napjának meghatározásához, végül pedig a T18 értéket jelzi 18:00-ig.
"resolutions": [
{
"resolutionKind": "DateTimeResolution",
"dateTimeSubKind": "Set",
"timex": "XXXX-WXX-1T18",
"value": "not resolved"
}
]
Dimenziók
Példák: "24 km/óra", "44 négyzetméter", "hatvanhat kilobájt"
"resolutions": [
{
"resolutionKind": "SpeedResolution",
"unit": "KilometersPerHour",
"value": 24
}
]
A "resolutionKind" és az "egység" értékek lehetséges értékei:
AreaResolution:
- Négyzetkilométer
- Négyzethektométer
- SquareDecameter
- Négyzetméter
- SquareDecimeter
- Négyzetcentiméter
- SquareMillimeter
- Négyzetes kulcs
- SquareFoot
- Négyzet
- SquareYard
- Acre
InformationResolution:
- Kicsit
- Kilobit
- Megabit
- Gigabit
- Terabit
- Petabit
- Bájt
- Kilobájt
- Megabyte
- Gigabyte
- Terabyte
- Petabyte
LengthResolution:
- kilométer
- Hectometer
- Dekameter
- Fogyasztásmérő
- Decimeter
- Centiméter
- Milliméter
- Mikrométer
- Nanometer
- Pikométer
- mérföld
- Udvar
- Hüvelyk
- Láb
- Világos év
- Pt
SpeedResolution:
- MetersPerSecond
- KmPerHour
- KmPerMinute
- KmPerSecond
- MilesPerHour
- Csomót
- FootPerSecond
- FootPerMinute
- YardPerMinute
- YardPerSecond
- MetersPerMillisecond
- CentiméterPerMillisecond
- KmPerMillisecond
VolumeResolution:
- Köbméter
- CubicCentimeter
- CubicMillimiter
- Hectoliter
- Dekaliter
- Liter
- Deciliter
- Centiliter
- Milliliter
- Köbméter
- Köbméter
- CubicFoot
- Köbméter
- FluidOunce
- Teáskanál
- Evőkanál
- Pint
- Liter
- Csésze
- Gill
- Csipet
- FluidDram
- Hordó
- Minimum
- Kábel
- Peck
- Bokor
- Disznófej
WeightResolution:
- Kilogramm
- Gramm
- Milligramm
- Mikrogramm
- Gallon
- MetricTon
- Tonna
- Font
- Uncia
- Időfelbontás
- Pennyweight
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Kő
- Dram
Szám
Példák: "27", "százhárom", "38,5", "2/3", "33%"
"resolutions": [
{
"resolutionKind": "NumberResolution",
"numberKind": "Integer",
"value": 27
}
]
A "numberKind" lehetséges értékei:
- Egész szám
- Tizedesjegy
- Fraction
- Power
- Százalék
Sorszám
Példák: "3rd", "first", "last"
"resolutions": [
{
"resolutionKind": "OrdinalResolution",
"offset": "3",
"relativeTo": "Start",
"value": "3"
}
]
A "relativeTo" lehetséges értékei:
- Eleje
- Vége
Hőmérséklet
Példák: "88 deg fahrenheit", "huszonhárom celsius fok"
"resolutions": [
{
"resolutionKind": "TemperatureResolution",
"unit": "Fahrenheit",
"value": 88
}
]
Az "egység" lehetséges értékei:
- Celsius
- Fahrenheit
- Kelvin
- Rankine