REST Resource: projects.locations.corpora.assets.annotations

Recurso: anotación

Una anotación es un recurso en el activo. Representa una asignación de par clave-valor del contenido en el recurso.

Representación JSON
{
  "name": string,
  "userSpecifiedAnnotation": {
    object (UserSpecifiedAnnotation)
  }
}
Campos
name

string

Es el nombre del recurso de la anotación. Formato: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}/annotations/{annotation}

userSpecifiedAnnotation

object (UserSpecifiedAnnotation)

Anotaciones proporcionadas por el usuario.

UserSpecifiedAnnotation

Anotaciones proporcionadas por los usuarios.

Representación JSON
{
  "key": string,
  "value": {
    object (AnnotationValue)
  },
  "partition": {
    object (Partition)
  }
}
Campos
key

string

Obligatorio. Es la clave de la anotación. CreateDataSchema debe establecer la clave con el tipo.

value

object (AnnotationValue)

Es el valor de la anotación. El valor debe poder convertirse al tipo según el esquema de datos.

partition

object (Partition)

Particiona la información en el tiempo y el espacio para la anotación a nivel del subrecurso.

AnnotationValue

Es el valor de la anotación, incluidos todos los tipos disponibles en el esquema de datos.

Representación JSON
{

  // Union field value can be only one of the following:
  "intValue": string,
  "floatValue": number,
  "strValue": string,
  "datetimeValue": string,
  "geoCoordinate": {
    object (GeoCoordinate)
  },
  "protoAnyValue": {
    "@type": string,
    field1: ...,
    ...
  },
  "boolValue": boolean,
  "customizedStructDataValue": {
    object
  },
  "listValue": {
    object (AnnotationList)
  },
  "customizedStructValue": {
    object (AnnotationCustomizedStruct)
  }
  // End of list of possible types for union field value.
}
Campos

Campo de unión value.

value puede ser una de las siguientes opciones:

intValue

string (int64 format)

Valor de la anotación de tipo int.

floatValue

number

Es el valor de la anotación de tipo flotante.

strValue

string

Es el valor de la anotación de tipo de cadena.

datetimeValue

string

Es el valor de la anotación de tipo de fecha y hora.

geoCoordinate

object (GeoCoordinate)

Es el valor de la anotación del tipo de coordenada geográfica.

protoAnyValue

object

Valor de cualquier valor de proto.

Un objeto que contiene campos de un tipo arbitrario. Un campo adicional "@type" contiene una URI que identifica el tipo. Ejemplo: { "id": 1234, "@type": "types.example.com/standard/id" }.

boolValue

boolean

Es el valor de la anotación de tipo booleano.

customizedStructDataValue

object (Struct format)

Es el valor de la anotación de struct personalizada. Este campo no tiene efectos. En su lugar, usa customizedStructValue para la anotación de struct personalizada.

listValue

object (AnnotationList)

Es el valor de la anotación de tipo de lista.

customizedStructValue

object (AnnotationCustomizedStruct)

Es el valor de la anotación de tipo de estructura personalizada.

GeoCoordinate

Representación de coordenadas de ubicación

Representación JSON
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

Coordenada de latitud. Grados [-90 .. 90]

longitude

number

Coordenadas de longitud Grados [-180 .. 180]

AnnotationList

Representación de lista en la anotación.

Representación JSON
{
  "values": [
    {
      object (AnnotationValue)
    }
  ]
}
Campos
values[]

object (AnnotationValue)

Los valores de la anotación de tipo de datos LIST.

AnnotationCustomizedStruct

Representación de struct personalizada en la anotación.

Representación JSON
{
  "elements": {
    string: {
      object (AnnotationValue)
    },
    ...
  }
}
Campos
elements

map (key: string, value: object (AnnotationValue))

Un mapa de las claves de los elementos al valor de la anotación del elemento.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Partición

Partición para especificar la partición en el tiempo y el espacio para la anotación a nivel del subrecurso.

Representación JSON
{
  "temporalPartition": {
    object (TemporalPartition)
  },
  "spatialPartition": {
    object (SpatialPartition)
  },
  "relativeTemporalPartition": {
    object (RelativeTemporalPartition)
  }
}
Campos
temporalPartition

object (TemporalPartition)

Es la partición del activo en el tiempo.

spatialPartition

object (SpatialPartition)

Partición del activo en el espacio.

relativeTemporalPartition

object (RelativeTemporalPartition)

Es la partición del activo en el tiempo.

TemporalPartition

Es la partición del activo en la época UTC. Es compatible con el tipo de corpus STREAM_VIDEO.

Representación JSON
{
  "startTime": string,
  "endTime": string
}
Campos
startTime

string (Timestamp format)

Es la hora de inicio de la partición.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Hora de finalización de la partición.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

SpatialPartition

Partición del activo en el espacio.

Representación JSON
{
  "xMin": string,
  "yMin": string,
  "xMax": string,
  "yMax": string
}
Campos
xMin

string (int64 format)

Es el valor mínimo de la coordenada x.

yMin

string (int64 format)

Es el valor mínimo de la coordenada y.

xMax

string (int64 format)

Es el valor máximo de la coordenada x.

yMax

string (int64 format)

Es el valor máximo de la coordenada y.

RelativeTemporalPartition

Partición del activo en tiempo relativo. Es compatible con el tipo de corpus VIDEO_ON_DEMAND.

Representación JSON
{
  "startOffset": string,
  "endOffset": string
}
Campos
startOffset

string (Duration format)

Es el desplazamiento de la hora de inicio de la partición.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

endOffset

string (Duration format)

Desplazamiento de la hora de finalización de la partición.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

Métodos

create

Crea una anotación dentro del activo.

delete

Borra la anotación dentro del activo.

get

Lee la anotación dentro del activo.

list

Muestra una lista de anotaciones dentro del activo.

patch

Actualiza la anotación dentro del activo.