REST Resource: projects.locations.products.referenceImages

Resource: ReferenceImage

A ReferenceImage represents a product image and its associated metadata, such as bounding boxes.

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

string

The resource name of the reference image.

Format is:

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

This field is ignored when creating a reference image.

uri

string

The Google Cloud Storage URI of the reference image.

The URI must start with gs://.

Required.

boundingPolys[]

object(BoundingPoly)

Bounding polygons around the areas of interest in the reference image. Optional. If this field is empty, the system will try to detect regions of interest. At most 10 bounding polygons will be used.

The provided shape is converted into a non-rotated rectangle. Once converted, the small edge of the rectangle must be greater than or equal to 300 pixels. The aspect ratio must be 1:4 or less (i.e. 1:3 is ok; 1:5 is not).

BoundingPoly

A bounding polygon for the detected image annotation.

JSON representation
{
  "vertices": [
    {
      object(Vertex)
    }
  ],
  "normalizedVertices": [
    {
      object(NormalizedVertex)
    }
  ]
}
Fields
vertices[]

object(Vertex)

The bounding polygon vertices.

normalizedVertices[]

object(NormalizedVertex)

The bounding polygon normalized vertices.

Vertex

A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.

JSON representation
{
  "x": number,
  "y": number
}
Fields
x

number

X coordinate.

y

number

Y coordinate.

Null-Koordinatenwerte


Das allgemeine Format für Begrenzungspolygone in der JSON-Antwort, wenn diese erkannt werden, ist ein Array aus vier Vertex-Objekten:
  • [{"x": 63,"y": 18},{"x": 123,"y": 18},{"x": 123,"y": 38},{"x": 63,"y": 38}]
Wenn die API den Wert 0,0 einer Koordinate ("x" oder "y") erkennt, wird diese Koordinate in der JSON-Antwort ausgelassen. Eine Antwort könnte beispielsweise das folgende Format haben: [{},{"x": 28}, {"x": 28,"y": 43},{"y": 43}]. Diese Antwort zeigt alle drei Darstellungsmöglichkeiten:
  • {} – ein leeres Objekt, wenn sowohl "x":0 als auch "y":0
  • {"x": 28} und {"y": 43} – ein Objekt mit einem einzelnen Schlüssel/Wert-Paar, wenn eine Koordinate 0,0 ist, die andere Koordinate jedoch einen Wert ungleich null hat
  • {"x": 28,"y": 43} – ein Objekt mit beiden Schlüssel/Wert-Paaren, wenn beide Koordinaten einen Wert ungleich null haben

NormalizedVertex

A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.

JSON representation
{
  "x": number,
  "y": number
}
Fields
x

number

X coordinate.

y

number

Y coordinate.

Null-Koordinatenwerte


Das allgemeine Format für Begrenzungspolygone in der JSON-Antwort, wenn diese erkannt werden, ist ein Array aus vier Vertex-Objekten:
  • [{"x": 0.063,"y": 0.018},{"x": 0.123,"y": 0.018},{"x": 0.123,"y": 0.038},{"x": 0.063,"y": 0.038}]
Wenn die API den Wert 0,0 einer Koordinate ("x" oder "y") erkennt, wird diese Koordinate in der JSON-Antwort ausgelassen. Eine Antwort könnte beispielsweise das folgende Format haben: [{},{"x": 0.028}, {"x": 0.028,"y": 0.043},{"y": 0.043}]. Diese Antwort zeigt alle drei Darstellungsmöglichkeiten:
  • {} – ein leeres Objekt, wenn sowohl "x":0.0 als auch "y":0.0
  • {"x": 0.028} und {"y": 0.043} – ein Objekt mit einem einzelnen Schlüssel/Wert-Paar, wenn eine Koordinate 0,0 ist, die andere Koordinate jedoch einen Wert ungleich null hat
  • {"x": 0.028,"y": 0.043} – ein Objekt mit beiden Schlüssel/Wert-Paaren, wenn beide Koordinaten einen Wert ungleich null haben

Methods

create

Creates and returns a new ReferenceImage resource.

delete

Permanently deletes a reference image.

get

Gets information associated with a ReferenceImage.

list

Lists reference images.
Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:

Feedback geben zu...

Cloud Vision API Product Search