REST Resource: projects.locations.products.referenceImages

Ressource : ReferenceImage

Une image de référence (ReferenceImage) représente une image de produit et les métadonnées qui lui sont associées, telles que les cadres de délimitation.

Représentation JSON 
{
  "name": string,
  "uri": string,
  "boundingPolys": [
    {
      object(BoundingPoly)
    }
  ]
}
Champs
name

string

Nom de ressource de l'image de référence.

Format :

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

Ce champ est ignoré lors de la création d'une image de référence.
uri

string

URI Google Cloud Storage de l'image de référence.

L'URI doit commencer par gs://.

Obligatoire.
boundingPolys[]

object(BoundingPoly)

Polygones de délimitation autour des zones d'intérêt de l'image de référence. Facultatif. Si ce champ est vide, le système tente de détecter les zones d'intérêt. Jusqu'à 10 polygones de délimitation sont utilisés.

La forme fournie est convertie en rectangle non pivotant. Une fois la conversion effectuée, le petit bord du rectangle doit être supérieur ou égal à 300 pixels. Le format doit être égal ou inférieur à 1:4 (le format 1:3 est accepté, mais pas le format 1:5).

BoundingPoly

Polygone de délimitation pour l'annotation d'image détectée.

Représentation JSON 
{
  "vertices": [
    {
      object(Vertex)
    }
  ],
  "normalizedVertices": [
    {
      object(NormalizedVertex)
    }
  ]
}
Champs
vertices[]

object(Vertex)

Sommets du polygone de délimitation.

normalizedVertices[]

object(NormalizedVertex)

Sommets normalisés du polygone de sélection.

Vertex

Un sommet représente un point 2D dans l'image. REMARQUE : les coordonnées du sommet sont à la même échelle que l'image d'origine.

Représentation JSON 
{
  "x": number,
  "y": number
}
Champs
x

number

Coordonnées X.
y

number

Coordonnées 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 sommet représente un point 2D dans l'image. REMARQUE : les coordonnées des sommets normalisés sont comparées aux valeurs de l'image d'origine, et sont comprises entre 0 et 1.

Représentation JSON 
{
  "x": number,
  "y": number
}
Champs
x

number

Coordonnées X.
y

number

Coordonnées 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.

Méthodes

create

 Crée et affiche une ressource ReferenceImage.

delete

 Supprime définitivement une image de référence.

get

 Récupère les informations associées à une ressource ReferenceImage.

list

 Répertorie les images de référence.