REST Resource: projects.locations.products.referenceImages

Risorsa: ReferenceImage

Un ReferenceImage rappresenta un'immagine del prodotto e i relativi metadati associati, come i riquadri di delimitazione.

Rappresentazione JSON 
{
  "name": string,
  "uri": string,
  "boundingPolys": [
    {
      object(BoundingPoly)
    }
  ]
}
Campi
name

string

Il nome della risorsa dell'immagine di riferimento.

Il formato è:

projects/PROJECT_ID/locations/LOC_ID/products/PRODUCT_ID/referenceImages/IMAGE_ID.

Questo campo viene ignorato quando viene creata un'immagine di riferimento.
uri

string

L'URI Google Cloud Storage dell'immagine di riferimento.

L'URI deve iniziare con gs://.

Obbligatorio.
boundingPolys[]

object(BoundingPoly)

Poligoni di confine intorno alle aree di interesse nell'immagine di riferimento. Facoltativo. Se questo campo è vuoto, il sistema tenterà di rilevare le regioni di interesse. Verranno utilizzati al massimo 10 poligoni delimitanti.

La forma fornita viene convertita in un rettangolo non ruotato. Una volta convertito, il lato piccolo del rettangolo deve essere maggiore o uguale a 300 pixel. Le proporzioni devono essere pari o inferiori a 1:4 (ad es. 1:3 è accettabile, 1:5 non lo è).

BoundingPoly

Un poligono di delimitazione per l'annotazione dell'immagine rilevata.

Rappresentazione JSON 
{
  "vertices": [
    {
      object(Vertex)
    }
  ],
  "normalizedVertices": [
    {
      object(NormalizedVertex)
    }
  ]
}
Campi
vertices[]

object(Vertex)

I vertici del poligono di delimitazione.

normalizedVertices[]

object(NormalizedVertex)

I vertici normalizzati del poligono di delimitazione.

Vertex

Un vertice rappresenta un punto 2D nell'immagine. NOTA: le coordinate dei vertici sono nella stessa scala dell'immagine originale.

Rappresentazione JSON 
{
  "x": number,
  "y": number
}
Campi
x

number

Coordinata X.

y

number

Coordinata Y.

Zero coordinate values


The general format for bounding polys in the JSON response when detected is an array of 4 vertex objects:
  • [{"x": 63,"y": 18},{"x": 123,"y": 18},{"x": 123,"y": 38},{"x": 63,"y": 38}]
When the API detects a coordinate ("x" or "y") value of 0, that coordinate is omitted in the JSON response. For example, a response could take the following form: [{},{"x": 28}, {"x": 28,"y": 43},{"y": 43}]. This response shows all three representation possibilities:
  • {} - an empty object when both "x":0 and "y":0.
  • {"x": 28} and {"y": 43} - an object with a single key-value pair when one coordinate is 0 but the other is a non-zero value.
  • {"x": 28,"y": 43} - an object with both key-value pairs when both coordinates have a non-zero value.

NormalizedVertex

Un vertice rappresenta un punto 2D nell'immagine. NOTA: le coordinate dei vertici normalizzate sono relative all'immagine originale e vanno da 0 a 1.

Rappresentazione JSON 
{
  "x": number,
  "y": number
}
Campi
x

number

Coordinata X.

y

number

Coordinata Y.

Zero coordinate values


The general format for bounding polys in the JSON response when detected is an array of 4 vertex objects:
  • [{"x": 0.063,"y": 0.018},{"x": 0.123,"y": 0.018},{"x": 0.123,"y": 0.038},{"x": 0.063,"y": 0.038}]
When the API detects a coordinate ("x" or "y") value of 0.0, that coordinate is omitted in the JSON response. For example, a response could take the following form: [{},{"x": 0.028}, {"x": 0.028,"y": 0.043},{"y": 0.043}]. This response shows all three representation possibilities:
  • {} - an empty object when both "x":0.0 and "y":0.0.
  • {"x": 0.028} and {"y": 0.043} - an object with a single key-value pair when one coordinate is 0.0 but the other is a non-zero value.
  • {"x": 0.028,"y": 0.043} - an object with both key-value pairs when both coordinates have a non-zero value.

Metodi

create

 Crea e restituisce una nuova risorsa ReferenceImage.

delete

 Consente di eliminare definitivamente un'immagine di riferimento.

get

 Recupera le informazioni associate a un'immagine di riferimento.

list

 Elenca le immagini di riferimento.