Metadane jednostki

Artykuł
11/21/2024

Obiekt Metadane jednostki przechwytuje opcjonalne dodatkowe informacje o wykrytych jednostkach, udostępniając rozwiązania przeznaczone specjalnie dla jednostek liczbowych i czasowych. Ten atrybut jest wypełniany tylko wtedy, gdy dostępne są dodatkowe dane, zwiększając kompleksowość wykrytych jednostek. Składnik Metadata obejmuje rozwiązania przeznaczone zarówno dla jednostek liczbowych, jak i czasowych. Ważne jest, aby obsłużyć przypadki, w których atrybut Metadane może być pusty lub nieobecny, ponieważ jego obecność nie jest gwarantowana dla każdej jednostki.

Obecnie składniki metadanych obsługują rozwiązania standardowego formatu jednostki. Jednostki można wyrażać w różnych formach i rozdzielczościach, zapewniając standardowe przewidywalne formaty dla typowych typów kwantyfikowalnych. Na przykład wartości "osiemdziesiąt" i "80" powinny być rozpoznawane jako liczba całkowita 80.

Rozwiązania NER umożliwiają implementowanie akcji lub pobieranie dalszych informacji. Na przykład usługa może wyodrębnić jednostki daty/godziny w celu wyodrębnienia dat i godzin udostępnionych w systemie planowania spotkań.

Uwaga

Metadane jednostki są obsługiwane tylko w wersji api-version=2023-04-15-preview. W przypadku starszych wersji interfejsu API możesz zapoznać się z artykułem Rozwiązania jednostek.

W tym artykule zwrócono obiekty rozpoznawania dla każdej kategorii jednostki lub podkategorii w obiekcie metadanych.

Jednostki liczbowe

Wiek

Przykłady: "10 lat", "23 miesiące", "sześćdziesiąt Y.O".

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

Możliwe wartości dla "jednostki":

Year (Rok)
Month
Tydzień
Dzień

Waluta

Przykłady: "30 funtów egipskich", "77 USD"

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

Możliwe wartości dla wartości "unit" i "ISO4217":

Dokumentacja ISO 4217.

Jednostki daty/godziny/czasu

Data/godzina zawiera kilka różnych podtypów, które zwracają różne obiekty odpowiedzi.

Data

Określone dni.

Przykłady: "1 stycznia 1995", "12 kwietnia", "7 października 2022", "jutro"

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

Za każdym razem, gdy zostanie podana niejednoznaczna data, oferowane są różne opcje rozwiązania. Na przykład "12 kwietnia" może odwoływać się do dowolnego roku. Rozwiązanie zapewnia w tym roku i następnego jako opcje. Wartość timex XXXX wskazuje, że w zapytaniu nie określono żadnego roku.

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

Niejednoznaczność może wystąpić nawet w danym dniu tygodnia. Na przykład powiedzenie "poniedziałek" może odnosić się do ostatniego poniedziałku lub w ten poniedziałek. Po raz kolejny timex wartość wskazuje, że nie określono żadnego roku lub miesiąca i używa identyfikatora tygodnia (W), aby wskazać pierwszy dzień tygodnia.

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

Czas

Określone czasy.

Przykłady: "9:39:33 AM", "seven AM", "20:03"

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

Datetime

Konkretne kombinacje daty i godziny.

Przykłady: "18:00 jutro", "20:00 w dniu 1 stycznia", "19:30"

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

Podobnie jak w przypadku dat, można mieć niejednoznaczne jednostki daty/godziny. Na przykład "3 maja południe" może odwoływać się do dowolnego roku. Rozwiązanie zapewnia w tym roku i następnego jako opcje. timex Wartość XXXX wskazuje, że nie określono roku.

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

Zakresy daty/godziny

Zakres daty/godziny to okres z datą początkową, godziną lub datą/godziną.

Przykłady: "od 3 stycznia od 6:00 do 25 kwietnia 2022 r.", "od poniedziałku do czwartku", "czerwiec", "weekend"

Parametr "duration" wskazuje czas upływa w sekundach (S), minutach (M), godzinach (H) lub dniach (D). Ten parametr jest zwracany tylko wtedy, gdy w zapytaniu znajdują się jawne daty rozpoczęcia i zakończenia daty/godziny. Wyrażenie "Następny tydzień" zwróci tylko parametry "begin" i "end" dla tygodnia.

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

Zestaw

Zestaw to cykliczny okres daty/godziny. Zestawy nie są rozpoznawane jako dokładne wartości, ponieważ nie wskazują dokładnej daty/godziny.

Przykłady: "każdy poniedziałek o godzinie 18:00", "każdy czwartek", "każdy weekend"

Dla "każdego poniedziałku o godzinie 18: timex 00" wartość wskazuje nie określony rok z początkowym XXXX, a następnie co poniedziałek do WXX-1 , aby określić pierwszy dzień każdego tygodnia, a na koniec T18 wskazać 18 :00.

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

Wymiary

Przykłady: "24 km/godz.", "44 metrów kwadratowych", "sześćdziesiąt sześć kilobajtów"

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

Możliwe wartości pól "unit":

W przypadku pomiarów:
- SquareKilometer
- SquareHectometer
- SquareDecameter
- SquareMeter
- SquareDecimeter
- SquareCentimeter
- SquareMillimeter
- Kwadratowe
- KwadratFoot
- SquareMile
- Plac kwadratowy
- Acre
Aby uzyskać informacje:
- Bit
- Kilobit
- Megabit
- Gigabit
- Terabit
- Petabit
- Byte
- Kilobajt
- Megabajt
- Gigabajt
- Terabajt
- Petabajt
W obszarze Długość, szerokość, wysokość:
- Kilometr
- Hektometr
- Dekametr
- Miernik
- Decymetr
- Centymetr
- Milimetr
- Mikrometr
- Nanometer
- Pikometr
- Mila
- Podwórze
- Cal
- Stopa
- Rok świetlny
- Pt
Szybkość:
- MeterPerSecond
- KilometryPerHour
- KilometryPerMinute
- KilometryPerSecond
- MilesPerHour
- Węzeł
- FootPerSecond
- StopaPerMinute
- YardsPerMinute
- YardsPerSecond
- MeterPerMillisecond
- CentymetryPerMillisecond
- KilometryPerMillisecond
Dla woluminu:
- Sześcienny
- Sześcienny
- Sześciennymillimiter
- Hektoliter
- Decaliter
- litr
- Decyliter
- Centiliter
- Mililitr
- Sześcienny
- Sześcienna
- Stopa sześcienna
- SześciennaMile
- FluidOunce
- Łyżeczka
- Łyżka
- Pinta
- Kwarta
- Filiżanka
- Skrzele
- Szczypanie
- FluidDram
- Beczka
- Półnuta
- Powróz
- Dziobać
- Korcem
- Hogshead
Dla wagi:
- Kilogram
- Gram
- Miligram
- Mikrogramów
- Galon
- MetricTon
- Tona
- Funt
- Uncja
- Ziarno
- Pennyweight
- LongTonBritish
- ShortTonUS
- ShortHundredweightUS
- Kamień
- Dram

Liczba porządkowa

Przykłady: "3rd", "first", "last"

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

Możliwe wartości parametru "relativeTo":

Rozpoczęcie
Zakończenie

Temperatura

Przykłady: "88 stopni celsjusza", "dwadzieścia trzy stopnie celsjusza"

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