Delen via


Entiteiten naar standaardindelingen oplossen

Een oplossing is een standaardindeling voor een entiteit. Entiteiten kunnen worden uitgedrukt in verschillende vormen en resoluties bieden standaard voorspelbare indelingen voor algemene kwantificeerbare typen. Zo moeten 'tachtig' en '80' beide worden omgezet in het gehele getal 80.

U kunt NER-oplossingen gebruiken om acties te implementeren of verdere informatie op te halen. Uw service kan bijvoorbeeld datum/tijd-entiteiten extraheren om datums en tijden te extraheren die worden verstrekt aan een planningssysteem voor vergaderingen.

Belangrijk

Vanaf versie 2023-04-15-preview wordt de functie voor entiteitsomzetting vervangen door metagegevens van entiteiten

Notitie

Antwoorden op entiteitsomzetting worden alleen ondersteund vanaf api-version=2022-10-01-preview en modelVersion: "2022-10-01-preview".

Dit artikel documenteert de oplossingsobjecten die worden geretourneerd voor elke entiteitscategorie of subcategorie.

Leeftijd

Voorbeelden: "10 jaar oud", "23 maanden oud", "zestig Y.O.".

"resolutions": [
                    {
                        "resolutionKind": "AgeResolution",
                        "unit": "Year",
                        "value": 10
                    }
                ]

Mogelijke waarden voor 'eenheid':

  • Year
  • Month
  • Week
  • Dag

Valuta

Voorbeelden: "30 Egyptische ponden", "77 USD"

"resolutions": [
                    {
                        "resolutionKind": "CurrencyResolution",
                        "unit": "Egyptian pound",
                        "ISO4217": "EGP",
                        "value": 30
                    }
                ]

Mogelijke waarden voor 'eenheid' en 'ISO4217':

Datum/tijd

Datetime bevat verschillende subtypen die verschillende antwoordobjecten retourneren.

Datum

Specifieke dagen.

Voorbeelden: "1 januari 1995", "12 april", "7 oktober 2022", "morgen"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Date",
                        "timex": "1995-01-01",
                        "value": "1995-01-01"
                    }
                ]

Wanneer er een dubbelzinnige datum wordt opgegeven, krijgt u verschillende opties voor uw oplossing. '12 april' kan bijvoorbeeld elk jaar verwijzen. Oplossing biedt dit jaar en de volgende opties. De timex waarde XXXX geeft aan dat er geen jaar is opgegeven in de query.

"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"
                    }
                ]

Ambiguïteit kan zelfs optreden voor een bepaalde dag van de week. Als u bijvoorbeeld 'maandag' zegt, kan dit verwijzen naar afgelopen maandag of deze maandag. Opnieuw geeft de timex waarde aan dat er geen jaar of maand is opgegeven en wordt een dag van de week-id (W) gebruikt om de eerste dag van de week aan te geven.

"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"
                    }
                ]

Tijd

Specifieke tijden.

Voorbeelden: "9:39:33 AM", "zeven AM", "20:03"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Time",
                        "timex": "T09:39:33",
                        "value": "09:39:33"
                    }
                ]

Datum/tijd

Specifieke datum- en tijdcombinaties.

Voorbeelden: "18:00 uur morgen", "18:00 uur op 3 januari", "19:30 november"

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "DateTime",
                        "timex": "2022-10-07T18",
                        "value": "2022-10-07 18:00:00"
                    }
                ]

Net als bij datums kunt u dubbelzinnige datum/tijd-entiteiten hebben. '3 mei's middags' kan bijvoorbeeld elk jaar verwijzen. Oplossing biedt dit jaar en de volgende opties. De timex waarde XXXX geeft aan dat er geen jaar is opgegeven.

"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"
                    }
                ]

Datum/tijd-bereiken

Een datum/tijd-bereik is een periode met een begin- en einddatum, tijd of datum/tijd.

Voorbeelden: "van 3 januari 6:00 tot 25 april 2022", "tussen maandag tot donderdag", "juni", "het weekend"

De parameter duur geeft de tijd aan die is doorgegeven in seconden (S), minuten (M), uren (H) of dagen (D). Deze parameter wordt alleen geretourneerd wanneer een expliciete begin- en einddatum/einddatum zich in de query bevinden. Volgende week retourneert alleen de parameters 'begin' en 'end' voor de week.

"resolutions": [
                    {
                        "resolutionKind": "TemporalSpanResolution",
                        "duration": "PT2702H",
                        "begin": "2022-01-03 06:00:00",
                        "end": "2022-04-25 20:00:00"
                    }
                ]

Instellen

Een set is een terugkerende datum/tijd-periode. Sets worden niet omgezet in exacte waarden, omdat ze geen exacte datum/tijd aangeven.

Voorbeelden: "elke maandag om 18:00 uur", "elke donderdag", "elk weekend"

Voor 'elke maandag om 18:00 uur' geeft de timex waarde geen opgegeven jaar aan met de begin-XXXX, vervolgens elke maandag tot en met WXX-1 om de eerste dag van elke week te bepalen, en tot slot T18 om 16:00 uur aan te geven.

"resolutions": [
                    {
                        "resolutionKind": "DateTimeResolution",
                        "dateTimeSubKind": "Set",
                        "timex": "XXXX-WXX-1T18",
                        "value": "not resolved"
                    }
                ]

Afmetingen

Voorbeelden: "24 km/uur", "44 vierkante meter", "zestig zes kilobytes"

"resolutions": [
                    {
                        "resolutionKind": "SpeedResolution",
                        "unit": "KilometersPerHour",
                        "value": 24
                    }
                ]

Mogelijke waarden voor 'resolutionKind' en hun 'unit'-waarden:

  • AreaResolution:

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

    • Bit
    • Kilobit
    • Megabit
    • Gigabit
    • Terabit
    • Petabit
    • Byte
    • Kilobyte
    • Megabyte
    • Gigabyte
    • Terabyte
    • Petabyte
  • LengthResolution:

    • Kilometer
    • Hectometer
    • Decameter
    • Meter
    • Decimeter
    • Centimeter
    • Millimeter
    • Micrometer
    • Nanometer
    • Picometer
    • Mijl
    • Binnenplaats
    • Duim
    • Voet
    • Lichtjaar
    • Pt
  • SpeedResolution:

    • MetersPerSecond
    • KilometersPerHour
    • KilometersPerMinute
    • KilometersPerSecond
    • MilesPerHour
    • Knoop
    • FootPerSecond
    • FootPerMinute
    • YardsPerMinute
    • YardsPerSecond
    • MetersPerMillisecond
    • CentimetersPerMillisecond
    • KilometersPerMillisecond
  • VolumeResolution:

    • Kubiekemeter
    • CubicCentimeter
    • CubicMillimiter
    • Hectoliter
    • Decaliter
    • Liter
    • Deciliter
    • Centiliter
    • Milliliter
    • CubicYard
    • CubicInch
    • Kubiekevoet
    • Kubiekemile
    • FluidOunce
    • Theelepeltje
    • Eetlepel
    • Pint
    • Quart
    • Kopje
    • Kieuw
    • Knijpen
    • FluidDram
    • Vat
    • Minim
    • Koord
    • Pikken
    • Schepel
    • Okshoofd
  • WeightResolution:

    • Kilogram
    • Gram
    • Milligram
    • Microgram
    • Gallon
    • MetricTon
    • Ton
    • Pond
    • Ons
    • Interval
    • Pennygewicht
    • LongTonBritish
    • ShortTonUS
    • ShortHundredweightUS
    • Steen
    • Dram

Aantal

Voorbeelden: "27", "honderd en drie", "38,5", "2/3", "33%"

"resolutions": [
                    {
                        "resolutionKind": "NumberResolution",
                        "numberKind": "Integer",
                        "value": 27
                    }
                ]

Mogelijke waarden voor "numberKind":

  • Geheel getal
  • Decimaal
  • Breuk
  • Power
  • Procent

Rangtelwoord

Voorbeelden: '3rd', 'first', 'last'

"resolutions": [
                    {
                        "resolutionKind": "OrdinalResolution",
                        "offset": "3",
                        "relativeTo": "Start",
                        "value": "3"
                    }
                ]

Mogelijke waarden voor 'relativeTo':

  • Starten
  • End

Temperatuur

Voorbeelden: "88 deg fahrenheit", "twintig drie graden celsius"

"resolutions": [
                    {
                        "resolutionKind": "TemperatureResolution",
                        "unit": "Fahrenheit",
                        "value": 88
                    }
                ]

Mogelijke waarden voor 'eenheid':

  • Celsius
  • Fahrenheit
  • Kelvin
  • Rankine