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

Risorsa: annotazione

Un'annotazione è una risorsa nell'asset. Rappresenta una mappatura di coppie chiave-valore dei contenuti nell'asset.

Rappresentazione JSON 
{
  "name": string,
  "userSpecifiedAnnotation": {
    object (UserSpecifiedAnnotation)
  }
}
Campi
name

string

Nome della risorsa dell'annotazione. Formato: projects/{project_number}/locations/{location}/corpora/{corpus}/assets/{asset}/annotations/{annotation}
userSpecifiedAnnotation

object (UserSpecifiedAnnotation)

Annotazione fornita dall'utente.

UserSpecifiedAnnotation

Annotazioni fornite dagli utenti.

Rappresentazione JSON 
{
  "key": string,
  "value": {
    object (AnnotationValue)
  },
  "partition": {
    object (Partition)
  }
}
Campi
key

string

Obbligatorio. Chiave dell'annotazione. La chiave deve essere impostata con il tipo da CreateDataSchema.
value

object (AnnotationValue)

Valore dell'annotazione. Il valore deve essere convertibile nel tipo in base allo schema di dati.
partition

object (Partition)

Suddividi le informazioni nel tempo e nello spazio per l'annotazione a livello di risorsa secondaria.

AnnotationValue

Valore dell'annotazione, inclusi tutti i tipi disponibili nello schema di dati.

Rappresentazione 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.
}
Campi

Campo unione value.

value può essere solo uno dei seguenti:
intValue

string (int64 format)

Valore dell'annotazione di tipo int.
floatValue

number

Valore dell'annotazione di tipo float.
strValue

string

Valore dell'annotazione di tipo stringa.
datetimeValue

string

Valore dell'annotazione del tipo di data e ora.
geoCoordinate

object (GeoCoordinate)

Valore dell'annotazione del tipo di coordinate geografiche.
protoAnyValue

object

Valore di qualsiasi valore proto.

Un oggetto contenente campi di tipo arbitrario. Un campo aggiuntivo "@type" contiene un URI che identifica il tipo. Esempio: { "id": 1234, "@type": "types.example.com/standard/id" }.
boolValue

boolean

Valore dell'annotazione di tipo booleano.
customizedStructDataValue

object (Struct format)

Valore dell'annotazione della struttura personalizzata. Questo campo non ha effetti. Utilizza invece customizedStructValue per l'annotazione di struct personalizzate.
listValue

object (AnnotationList)

Valore dell'annotazione del tipo di elenco.
customizedStructValue

object (AnnotationCustomizedStruct)

Valore dell'annotazione del tipo di struttura personalizzata.

GeoCoordinate

Rappresentazione delle coordinate della posizione

Rappresentazione JSON 
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

Coordinate di latitudine. Gradi [-90 .. 90]
longitude

number

Coordinate di longitudine. Gradi [-180 .. 180]

AnnotationList

Rappresentazione dell'elenco nell'annotazione.

Rappresentazione JSON 
{
  "values": [
    {
      object (AnnotationValue)
    }
  ]
}
Campi
values[]

object (AnnotationValue)

I valori dell'annotazione del tipo di dati LIST.

AnnotationCustomizedStruct

Rappresentazione di struct personalizzata nell'annotazione.

Rappresentazione JSON 
{
  "elements": {
    string: {
      object (AnnotationValue)
    },
    ...
  }
}
Campi
elements

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

Una mappa dalle chiavi degli elementi al valore dell'annotazione dell'elemento.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Partition

Partizione per specificare la partizione nel tempo e nello spazio per l'annotazione a livello di risorsa secondaria.

Rappresentazione JSON 
{
  "temporalPartition": {
    object (TemporalPartition)
  },
  "spatialPartition": {
    object (SpatialPartition)
  },
  "relativeTemporalPartition": {
    object (RelativeTemporalPartition)
  }
}
Campi
temporalPartition

object (TemporalPartition)

Partizione della risorsa nel tempo.
spatialPartition

object (SpatialPartition)

Partizione della risorsa nello spazio.
relativeTemporalPartition

object (RelativeTemporalPartition)

Partizione della risorsa nel tempo.

TemporalPartition

Partizione della risorsa nell'ora UTC Epoch. Supportato dal tipo di corpus STREAM_VIDEO.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string
}
Campi
startTime

string (Timestamp format)

Ora di inizio della partizione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Ora di fine della partizione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

SpatialPartition

Partizione della risorsa nello spazio.

Rappresentazione JSON 
{
  "xMin": string,
  "yMin": string,
  "xMax": string,
  "yMax": string
}
Campi
xMin

string (int64 format)

Il valore minimo della coordinata x.
yMin

string (int64 format)

Il valore della coordinata y minima.
xMax

string (int64 format)

Il valore massimo della coordinata x.
yMax

string (int64 format)

Il valore della coordinata y massima.

RelativeTemporalPartition

Partizione della risorsa in base al tempo relativo. Supportato dal tipo di corpus VIDEO_ON_DEMAND.

Rappresentazione JSON 
{
  "startOffset": string,
  "endOffset": string
}
Campi
startOffset

string (Duration format)

Offset dell'ora di inizio della partizione.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
endOffset

string (Duration format)

Offset dell'ora di fine della partizione.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

Metodi

create

 Crea un'annotazione all'interno dell'asset.

delete

 Consente di eliminare l'annotazione all'interno della risorsa.

get

 Legge l'annotazione all'interno dell'asset.

list

 Elenca un elenco di annotazioni all'interno della risorsa.

patch

 Aggiorna l'annotazione all'interno della risorsa.