Metadados da entidade

O objeto de metadados de entidade armazena detalhes suplementares opcionais sobre entidades detetadas, fornecendo especificamente resoluções padronizadas para dados numéricos e temporais.

Este atributo só é preenchido quando informações adicionais estão disponíveis e pode estar vazio ou ausente para algumas entidades.

As resoluções de metadados convertem vários formulários de entidade em formatos consistentes — por exemplo, "oitenta" e "80" resolvem para o número inteiro 80. Essas resoluções NER permitem ações downstream, como extrair entidades de data e hora para integração com um sistema de agendamento de reuniões.

Nota

O suporte para metadados de entidade está disponível com API 2023-04-15-preview e versões posteriores. Para versões mais antigas da API, consulte Resoluções de entidade.

Entidades com atributos de metadados

Entities Entities Entities Entities Entities Entities
Idade Área Moeda Data Data/hora Informação
Comprimento Número NumericRange Ordinal Conjunto Velocidade
Temperatura Time Volume Peso

Antiguidade

Metadados Tipo Description
unidade cadeia (de caracteres) Unidade de medida para a idade.
value número Valor numérico para a idade. 
"metadata": {
                "unit": "Year",
                "value": 10
            }

Valores possíveis para a unidade:

  • Dia
  • Month
  • Semana
  • Anual
  • Não especificado

Area

Metadados Tipo Description
unidade cadeia (de caracteres) Unidade de medida por área.
value número Valor numérico para área. 
"metadata": {
                "unit": "Acre",
                "value": 30
            }

Valores possíveis para a unidade:

  • Acre
  • Centímetro quadrado
  • QuadradoDecametro
  • Quadrado Decimetro
  • Pé Quadrado
  • Hectómetro Quadrado
  • Polegada quadrada
  • Quilómetro Quadrado
  • Medidor Quadrado
  • Milha Quadrada
  • Milímetro Quadrado
  • Pátio Quadrado
  • Não especificado

Moeda

Metadados Tipo Description
unidade cadeia (de caracteres) Nome da moeda.
value número Valor numérico para a moeda.
ISO4217 cadeia (de caracteres) O código de moeda ISO 4217 de três letras usa as duas primeiras letras do código ISO 3166 do país e, quando possível, a terceira letra é a primeira letra do nome da moeda. 
"metadata": {
                "unit": "Egyptian pound",
                "value": 30,
                "ISO4217": "EGP"
            }

Valores possíveis para ISO4217:

Date

Metadados Tipo Description
tempox cadeia (de caracteres) A data formatada pela ISO 8601: YYYY-MM-DD (ano, mês, dia).
value cadeia (de caracteres) A data real indicada.

Sempre que uma data ambígua é fornecida, são oferecidas diferentes opções para a sua resolução. Por exemplo, "12 de abril" pode referir-se a qualquer ano. Resolução prevê este ano e o próximo como opções. O timex valor XXXX indica que nenhum ano foi especificado na consulta.

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

A ambiguidade pode ocorrer mesmo para um determinado dia da semana. Por exemplo, dizer "segunda-feira" pode referir-se à última segunda-feira ou a esta segunda-feira. Mais uma vez, o timex valor indica que nenhum ano ou mês foi especificado e usa um identificador de dia da semana (W) para indicar o primeiro dia da semana.

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

Datetime

Metadados Tipo Description
tempox cadeia (de caracteres) Data e hora formatadas pela ISO 8601:
YYYY-MM-DDTHH:MM:SS(ano, mês, dia, hora, minutos, segundos, milissegundos) com um T separador.
valor cadeia (de caracteres) A data e hora reais indicadas.

Semelhante às datas, você pode ter entidades datetime ambíguas. Resolução prevê este ano e o próximo como opções. O timex valor XXXX indica que nenhum ano foi especificado.

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

Informação

Metadados Tipo Description
unidade cadeia (de caracteres) Unidade de medida da informação (dados).
value número Valor numérico para informações. 

"metadata": {
                "unit": "Kilobit",
                "value": 30
            }

Valores possíveis para a unidade:

  • Pouco
  • Byte
  • Gigabit
  • Gigabyte
  • Kilobit
  • Kilobyte
  • Megabit
  • Megabyte
  • Petabit
  • Petabyte
  • Terabit
  • Terabyte
  • Não especificado

Length

Metadados Tipo Description
unidade cadeia (de caracteres) Unidade de medida para o comprimento
value número Valor numérico. 

"metadata": {
                "unit": "Kilobit",
                "value": 30
            }

Valores possíveis para a unidade:

  • Centímetro
  • Decámetro
  • Decímetro
  • Pé
  • Hectómetro
  • Polegada
  • Quilómetro
  • Ano-Luz
  • Metro
  • Micrometer
  • Milha
  • Milímetro
  • Nanômetro
  • Pícometer
  • Point
  • Quintal
  • Não especificado

Número

Metadados Tipo Description
númeroTipo cadeia (de caracteres) Tipo de número.
value número Valor numérico para número. 

"metadata": {
                "numberKind": "Integer",
                "value": 30
            }

Valores possíveis para numberKind:

  • Decimal
  • Fração
  • Número inteiro
  • Percentagem
  • Power
  • Não especificado

NumericRange

Metadados Tipo Description
intervaloKind cadeia (de caracteres) Um intervalo numérico suportado.
mínimo número O valor inicial do intervalo.
máximo número O valor final do intervalo. 

"metadata": {
                "rangeKind": "length",
                "minimum": 30,
                "maximum": 100
            }

Valores possíveis para rangeKind:

  • Antiguidade
  • Area
  • Moeda
  • Informação
  • Length
  • Número
  • Velocidade
  • Temperatura
  • Volume
  • Weight

Ordinal

Metadados Tipo Description
Deslocamento cadeia (de caracteres) O deslocamento em relação à referência (por exemplo, offset = -1 indica o penúltimo)
parenteTo O ponto de referência que o número ordinal denota.
value número Valor numérico para posição ordinal. 

"metadata": {
                "offset": -1,
                "relativeTo":"Current",
                "value": "first"
            }

Valores possíveis para relativeTo:

  • Current
  • Fim
  • Iniciar

Definição

Um período de data-hora recorrente (exemplo: "todas as segundas-feiras às 18:00.")

Metadados Tipo Description
tempox cadeia (de caracteres) Data e hora formatadas pela ISO 8601:
YYYY-MM-DDTHH:MM:SS(ano, mês, dia, hora, minutos, segundos, milissegundos) com um T separador.
value cadeia (de caracteres) Os conjuntos não resolvem para valores exatos, pois não indicam uma data/hora exata. 

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

Valores possíveis para o tipo:

  • begin
  • fim
  • duration
  • modificador (exemplo: before, after)
  • tempox

Velocidade

Metadados Tipo Description
unidade cadeia (de caracteres) Unidade de medida da velocidade.
value número Valor numérico para velocidade. 

"metadata": {
                "unit": "Knots",
                "value": 50
            }

Valores possíveis para a unidade:

  • CentímetrosPerMillisecond
  • PésPerMinuto
  • FeetPerSecond
  • QuilômetrosPerHora
  • QuilômetrosPerMillisecond
  • QuilómetrosPerMinuto
  • QuilómetrosPerSegundo
  • Nós
  • MetrosPerMillisecond
  • MetrosPerSecond
  • MilhasPerHour
  • QuintaisPerMinute
  • QuintaisPerSecond
  • Não especificado

Temperatura

Metadados Tipo Description
unidade cadeia (de caracteres) Unidade de medida da temperatura.
value número Valor numérico. 

"metadata": {
                "unit" "Kelvin",
                "value": 310
            }

Valores possíveis para a unidade:

  • Celsius
  • Fahrenheit
  • Kelvin
  • Rankine
  • Não especificado

Hora

Metadados Tipo Description
tempox cadeia (de caracteres) A hora da data formatada ISO 8601:
[hh]:[mm]:[ss](hora, minutos, segundos).
value número Valor numérico. 

"metadata": {
                "timex":"T14:30:15",
                "value": "14:30:15"
            }

Volume

Metadados Tipo Description
unidade cadeia (de caracteres) Unidade de medida para o volume.
value número Valor numérico para volume. 

"metadata": {
                "unit": "Quart",
                "value": 4
            }

Valores possíveis para a unidade:

  • Barril
  • Alqueire
  • Centiliter
  • Cordão
  • CubicCentímetro
  • CubicFoot
  • CubicInch
  • CubicMeter
  • CubicMile
  • CubicMillimeter
  • CubicYard
  • Taça
  • Decaliter
  • FluidDram
  • Onça Fluida
  • Gill
  • Hectoliter
  • Cabeça de porco
  • Litro
  • Mililitro
  • Mínimo
  • Peck
  • Pinça
  • Cerveja
  • Quart
  • Colher de sopa
  • Colher de chá
  • Não especificado

Weight

Metadados Tipo Description
unidade cadeia (de caracteres) Unidade de medida para o peso.
value número Valor numérico para peso. 

"metadata": {
                "unit": "Ounce",
                "value": 16
            }

Valores possíveis para a unidade:

  • Carrinho de bebé
  • Galão
  • Granulação
  • Grama
  • Quilograma
  • LongTonBritânico
  • MetricTon
  • Miligrama
  • Onça
  • PennyWeight
  • Libra
  • ShortHundredWeightUS
  • ShortTonUS
  • Pedra
  • Tonelada
  • Não especificado

Próximos passos

Saiba como usar o NER

  • Last updated on