AnnotateImageResponse

תשובה לבקשה להערת תמונה.

ייצוג ב-JSON 
{
  "faceAnnotations": [
    {
      object (FaceAnnotation)
    }
  ],
  "landmarkAnnotations": [
    {
      object (EntityAnnotation)
    }
  ],
  "logoAnnotations": [
    {
      object (EntityAnnotation)
    }
  ],
  "labelAnnotations": [
    {
      object (EntityAnnotation)
    }
  ],
  "localizedObjectAnnotations": [
    {
      object (LocalizedObjectAnnotation)
    }
  ],
  "textAnnotations": [
    {
      object (EntityAnnotation)
    }
  ],
  "fullTextAnnotation": {
    object (TextAnnotation)
  },
  "safeSearchAnnotation": {
    object (SafeSearchAnnotation)
  },
  "imagePropertiesAnnotation": {
    object (ImageProperties)
  },
  "cropHintsAnnotation": {
    object (CropHintsAnnotation)
  },
  "webDetection": {
    object (WebDetection)
  },
  "productSearchResults": {
    object (ProductSearchResults)
  },
  "error": {
    object (Status)
  },
  "context": {
    object (ImageAnnotationContext)
  }
}
שדות
faceAnnotations[]

object (FaceAnnotation)

אם יש פנים בתמונה, זיהוי הפנים הושלם בהצלחה.

landmarkAnnotations[]

object (EntityAnnotation)

אם יש נקודת ציון, זיהוי נקודת הציון הושלם בהצלחה.

logoAnnotations[]

object (EntityAnnotation)

אם יש לוגו, זיהוי הלוגו הושלם בהצלחה.

labelAnnotations[]

object (EntityAnnotation)

אם יש תווית, זיהוי התווית הושלם בהצלחה.

localizedObjectAnnotations[]

object (LocalizedObjectAnnotation)

אם יש, זיהוי האובייקטים המותאם לשפה המקומית הושלם בהצלחה. התוצאות ימוינו בסדר יורד לפי ציון הסמך.

textAnnotations[]

object (EntityAnnotation)

אם יש טקסט, זיהוי הטקסט (OCR) הושלם בהצלחה.

fullTextAnnotation

object (TextAnnotation)

אם יש טקסט, זיהוי הטקסט (OCR) או זיהוי הטקסט במסמך (OCR) הסתיים בהצלחה. ההערה הזו מספקת את ההיררכיה המבנית של הטקסט שזוהה על ידי ה-OCR.

safeSearchAnnotation

object (SafeSearchAnnotation)

אם יש הערה לגבי חיפוש בטוח, היא הושלמה בהצלחה.

imagePropertiesAnnotation

object (ImageProperties)

אם קיימים מאפייני תמונה, הם חולצו בהצלחה.

cropHintsAnnotation

object (CropHintsAnnotation)

אם יש רמזים לחיתוך, הם הושלמו בהצלחה.

webDetection

object (WebDetection)

אם יש תוצאות, המשמעות היא שהזיהוי באינטרנט הושלם בהצלחה.

productSearchResults

object (ProductSearchResults)

אם יש תוצאות, החיפוש הושלם בהצלחה.

error

object (Status)

אם מוגדר, מייצג את הודעת השגיאה של הפעולה. שימו לב שההערות לתמונות שמולאו הן נכונות בוודאות, גם אם הערך של error מוגדר.

context

object (ImageAnnotationContext)

אם יש מידע לפי הקשר, הוא נחוץ כדי להבין מאיפה התמונה הזו מגיעה.

FaceAnnotation

אובייקט של הערת פנים מכיל את התוצאות של זיהוי הפנים.

ייצוג ב-JSON 
{
  "boundingPoly": {
    object (BoundingPoly)
  },
  "fdBoundingPoly": {
    object (BoundingPoly)
  },
  "landmarks": [
    {
      object (Landmark)
    }
  ],
  "rollAngle": number,
  "panAngle": number,
  "tiltAngle": number,
  "detectionConfidence": number,
  "landmarkingConfidence": number,
  "joyLikelihood": enum (Likelihood),
  "sorrowLikelihood": enum (Likelihood),
  "angerLikelihood": enum (Likelihood),
  "surpriseLikelihood": enum (Likelihood),
  "underExposedLikelihood": enum (Likelihood),
  "blurredLikelihood": enum (Likelihood),
  "headwearLikelihood": enum (Likelihood)
}
שדות
boundingPoly

object (BoundingPoly)

פוליגון התוחם סביב הפנים. הקואורדינטות של התיבה התוחמת הן בסקאלה של התמונה המקורית. תיבת התוחמת מחושבת כדי "למסגר" את הפנים בהתאם לציפיות של בני אדם. הוא מבוסס על תוצאות של ציוני דרך. שימו לב שאם רק חלק מהפנים מופיע בתמונה שצריך להוסיף לה הערה, יכול להיות שלא ייווצר ערך לאחת או יותר מהקואורדינטות x או y ב-BoundingPoly (המצולע לא יהיה חסום).

fdBoundingPoly

object (BoundingPoly)

המצולע התוחם fdBoundingPoly קטן יותר מהמצולע boundingPoly, והוא כולל רק את החלק של העור בפנים. בדרך כלל, משתמשים בה כדי להסיר את הפנים מכל ניתוח תמונה שמזהה את 'כמות העור' שרואים בתמונה. הוא לא מבוסס על תוצאות של נקודות ציון, אלא רק על זיהוי הפנים הראשוני, ולכן

fd

(זיהוי פנים).
landmarks[]

object (Landmark)

זוהו נקודות ציון של פנים.

rollAngle

number

זווית הגלגול, שמציינת את מידת הסיבוב של הפנים בכיוון השעון או נגד כיוון השעון ביחס לאנך של התמונה סביב הציר שמאונך לפנים. הטווח הוא [‎-180,180].

panAngle

number

זווית הסבסוב, שמציינת את הזווית שבה הפנים מצביעות שמאלה או ימינה ביחס למישור האנכי שמאונך לתמונה. הטווח הוא [‎-180,180].

tiltAngle

number

זווית עלרוד, שמציינת את הזווית כלפי מעלה או כלפי מטה שאליה פונות הפנים ביחס למישור האופקי של התמונה. הטווח הוא [‎-180,180].

detectionConfidence

number

רמת הביטחון בזיהוי. טווח [0, 1].

landmarkingConfidence

number

רמת הביטחון של זיהוי נקודות ציון בפנים. טווח [0, 1].

joyLikelihood

enum (Likelihood)

סבירות להבעת שמחה.

sorrowLikelihood

enum (Likelihood)

סבירות להבעת צער.

angerLikelihood

enum (Likelihood)

סבירות לכעס.

surpriseLikelihood

enum (Likelihood)

הסיכוי להפתעה.

underExposedLikelihood

enum (Likelihood)

הסבירות לחשיפה נמוכה מדי.

blurredLikelihood

enum (Likelihood)

סבירות מטושטשת.

headwearLikelihood

enum (Likelihood)

הסבירות לשימוש בכיסוי ראש.

ציון דרך

נקודת ציון ספציפית בפנים (לדוגמה, תווי פנים).

ייצוג ב-JSON 
{
  "type": enum (Type),
  "position": {
    object (Position)
  }
}
שדות
type

enum (Type)

סוג נקודת ציון בפנים.

position

object (Position)

מיקום של נקודת ציון בפנים.

סוג

סוג נקודת ציון (תכונה) בפנים. הצדדים הימני והשמאלי מוגדרים מנקודת המבט של הצופה בתמונה, בלי להתחשב בהיטלי מראה שמאפיינים תמונות. לכן, LEFT_EYE היא בדרך כלל העין הימנית של האדם.

טיפוסים בני מנייה (enum)
UNKNOWN_LANDMARK זוהה סמן לא מוכר של פנים. אין למלא את השדה הזה.
LEFT_EYE העין השמאלית.
RIGHT_EYE העין הימנית.
LEFT_OF_LEFT_EYEBROW משמאל לגבה השמאלית.
RIGHT_OF_LEFT_EYEBROW מימין לגבה השמאלית.
LEFT_OF_RIGHT_EYEBROW משמאל לגבה הימנית.
RIGHT_OF_RIGHT_EYEBROW מימין לגבה הימנית.
MIDPOINT_BETWEEN_EYES נקודת האמצע בין העיניים.
NOSE_TIP קצה האף.
UPPER_LIP שפה עליונה.
LOWER_LIP השפה התחתונה.
MOUTH_LEFT פה שמאלה.
MOUTH_RIGHT הפה ימינה.
MOUTH_CENTER מרכז הפה.
NOSE_BOTTOM_RIGHT אף, צד ימין למטה.
NOSE_BOTTOM_LEFT אף, פינה שמאלית תחתונה.
NOSE_BOTTOM_CENTER אף, במרכז למטה.
LEFT_EYE_TOP_BOUNDARY העין השמאלית, הגבול העליון.
LEFT_EYE_RIGHT_CORNER עין שמאל, פינה ימנית.
LEFT_EYE_BOTTOM_BOUNDARY העין השמאלית, הגבול התחתון.
LEFT_EYE_LEFT_CORNER העין השמאלית, הפינה השמאלית.
RIGHT_EYE_TOP_BOUNDARY הגבול העליון של העין הימנית.
RIGHT_EYE_RIGHT_CORNER עין ימין, פינה ימנית.
RIGHT_EYE_BOTTOM_BOUNDARY עין ימין, גבול תחתון.
RIGHT_EYE_LEFT_CORNER עין ימין, פינה שמאלית.
LEFT_EYEBROW_UPPER_MIDPOINT הגבה השמאלית, נקודת האמצע העליונה.
RIGHT_EYEBROW_UPPER_MIDPOINT הגבה הימנית, נקודת האמצע העליונה.
LEFT_EAR_TRAGION החלק הקדמי של האוזן השמאלית.
RIGHT_EAR_TRAGION החלק הקדמי של תנוך האוזן הימנית.
LEFT_EYE_PUPIL האישון בעין שמאל.
RIGHT_EYE_PUPIL האישון בעין ימין.
FOREHEAD_GLABELLA פדחת.
CHIN_GNATHION סנטר (Gnathion).
CHIN_LEFT_GONION הסנטר משמאל לזווית הלסת.
CHIN_RIGHT_GONION סנטר ימני גוניון.

מקום

מיקום תלת-ממדי בתמונה, שמשמש בעיקר לנקודות ציון של זיהוי פנים. מיקום תקין חייב לכלול גם קואורדינטת x וגם קואורדינטת y. קואורדינטות המיקום הן באותו קנה מידה כמו התמונה המקורית.

ייצוג ב-JSON 
{
  "x": number,
  "y": number,
  "z": number
}
שדות
x

number

קואורדינטה X.

y

number

קואורדינטת Y.

z

number

קואורדינטה Z (או עומק).

סבירות

ייצוג של הסבירות באמצעות קטגוריות, שמטרתו לספק ללקוחות תוצאות יציבות מאוד גם אחרי שדרוגים של המודל.

טיפוסים בני מנייה (enum)
UNKNOWN סבירות לא ידועה.
VERY_UNLIKELY הסיכוי לכך נמוך מאוד.
UNLIKELY סביר להניח שלא.
POSSIBLE זה אפשרי.
LIKELY סביר להניח.
VERY_LIKELY סביר מאוד.

EntityAnnotation

קבוצה של תכונות ישות שאותרו.

ייצוג ב-JSON 
{
  "mid": string,
  "locale": string,
  "description": string,
  "score": number,
  "confidence": number,
  "topicality": number,
  "boundingPoly": {
    object (BoundingPoly)
  },
  "locations": [
    {
      object (LocationInfo)
    }
  ],
  "properties": [
    {
      object (Property)
    }
  ]
}
שדות
mid

string

מזהה ישות אטום. יכול להיות שחלק מהמזהים זמינים ב-Google Knowledge Graph Search API.

locale

string

קוד השפה של הלוקאל שבו מבוטא הטקסט של הישות description.

description

string

תיאור טקסטואלי של הישות, בשפה locale שלה.

score

number

הציון הכולל של התוצאה. טווח [0, 1].

confidence
(deprecated)

number

הוּצאה משימוש במקום זאת, אתם צריכים להשתמש ב-score. מידת הדיוק של זיהוי הישות בתמונה. לדוגמה, אם מזוהה בתמונה הישות 'מגדל אייפל', השדה הזה מייצג את רמת הביטחון שיש מגדל בתמונה של השאילתה. טווח [0, 1].
topicality

number

רמת הרלוונטיות של התווית ICA (הערה על תוכן התמונה) לתמונה. לדוגמה, סביר להניח שהרלוונטיות של המילה 'מגדל' גבוהה יותר לתמונה שבה זוהה 'מגדל אייפל' מאשר לתמונה שבה זוהה בניין גבוה רחוק, גם אם רמת הוודאות לגבי קיומו של מגדל בכל אחת מהתמונות זהה. טווח [0, 1].

boundingPoly

object (BoundingPoly)

אזור התמונה שהישות הזו שייכת לו. לא נוצר עבור תכונות של LABEL_DETECTION.

locations[]

object (LocationInfo)

נתוני המיקום של הישות שזוהתה. יכולים להיות כמה אלמנטים מסוג LocationInfo כי מיקום אחד יכול לציין את המיקום של הסצנה בתמונה, ומיקום אחר יכול לציין את המיקום של המקום שבו התמונה צולמה. בדרך כלל יש פרטי מיקום לגבי ציוני דרך.

properties[]

object (Property)

לחלק מהישויות עשויים להיות שדות אופציונליים שסופקו על ידי המשתמש Property (שם/ערך), כמו ציון או מחרוזת שמסווגים את הישות.

LocationInfo

פרטי המיקום של הישות שאותרה.

ייצוג ב-JSON 
{
  "latLng": {
    object (LatLng)
  }
}
שדות
latLng

object (LatLng)

קואורדינטות של קו הרוחב וקו האורך של המיקום.

מאפיין (property)

Property מורכב מצמד של שם/ערך שסופק על ידי המשתמש.

ייצוג ב-JSON 
{
  "name": string,
  "value": string,
  "uint64Value": string
}
שדות
name

string

שם הנכס.

value

string

הערך של המאפיין.

uint64Value

string

הערך של מאפיינים מספריים.

LocalizedObjectAnnotation

קבוצה של אובייקטים שזוהו עם תיבות תוחמות.

ייצוג ב-JSON 
{
  "mid": string,
  "languageCode": string,
  "name": string,
  "score": number,
  "boundingPoly": {
    object (BoundingPoly)
  }
}
שדות
mid

string

מזהה האובייקט שצריך להיות זהה ל-mid של EntityAnnotation.

languageCode

string

קוד השפה בפורמט BCP-47, כמו en-US או sr-Latn. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

name

string

שם האובייקט, בשפה languageCode.

score

number

הניקוד של התוצאה. טווח [0, 1].

boundingPoly

object (BoundingPoly)

האזור בתמונה שאליו שייך האובייקט הזה. חובה למלא את השדה הזה.

TextAnnotation

‫TextAnnotation מכיל ייצוג מובנה של טקסט שחולץ באמצעות OCR. ההיררכיה של מבנה טקסט שחולץ באמצעות OCR היא כזו: TextAnnotation -> Page -> Block -> Paragraph -> Word -> Symbol לכל רכיב מבני, החל מ-Page, יכולות להיות מאפיינים משלו. המאפיינים מתארים את השפות שזוהו, את ההפסקות וכו'. הסבר מפורט מופיע בהמשך, בקטע TextAnnotation.TextPropertyהגדרת ההודעה.

ייצוג ב-JSON 
{
  "pages": [
    {
      object (Page)
    }
  ],
  "text": string
}
שדות
pages[]

object (Page)

רשימת הדפים שזוהו על ידי ה-OCR.

text

string

זוהה טקסט בפורמט UTF-8 בדפים.

דף

דף שזוהה מ-OCR.

ייצוג ב-JSON 
{
  "property": {
    object (TextProperty)
  },
  "width": number,
  "height": number,
  "blocks": [
    {
      object (Block)
    }
  ],
  "confidence": number
}
שדות
property

object (TextProperty)

זוהה מידע נוסף בדף.

width

number

רוחב הדף. ב-PDF, היחידה היא נקודות. בתמונות (כולל TIFF), היחידה היא פיקסלים.

height

number

גובה הדף. ב-PDF, היחידה היא נקודות. בתמונות (כולל TIFF), היחידה היא פיקסלים.

blocks[]

object (Block)

רשימה של בלוקים של טקסט, תמונות וכו' בדף הזה.

confidence

number

רמת הביטחון של תוצאות ה-OCR בדף. טווח [0, 1].

TextProperty

זוהה מידע נוסף ברכיב המבני.

ייצוג ב-JSON 
{
  "detectedLanguages": [
    {
      object (DetectedLanguage)
    }
  ],
  "detectedBreak": {
    object (DetectedBreak)
  }
}
שדות
detectedLanguages[]

object (DetectedLanguage)

רשימה של השפות שזוהו, יחד עם רמת הביטחון.

detectedBreak

object (DetectedBreak)

זוהתה התחלה או סיום של פלח טקסט.

DetectedLanguage

השפה שזוהתה עבור רכיב מבני.

ייצוג ב-JSON 
{
  "languageCode": string,
  "confidence": number
}
שדות
languageCode

string

קוד השפה בפורמט BCP-47, כמו en-US או sr-Latn. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

confidence

number

רמת הביטחון לגבי השפה שזוהתה. טווח [0, 1].

DetectedBreak

זוהתה התחלה או סיום של רכיב מבני.

ייצוג ב-JSON 
{
  "type": enum (BreakType),
  "isPrefix": boolean
}
שדות
type

enum (BreakType)

סוג המעבר שזוהה.

isPrefix

boolean

הערך הוא True אם התג break מופיע לפני הרכיב.

BreakType

טיפוסים בני מנייה (enum) לציון סוג ההפסקה שנמצאה. שורה חדשה, רווח וכו'.

טיפוסים בני מנייה (enum)
UNKNOWN סוג התווית של ההפסקה לא ידוע.
SPACE מרחב רגיל.
SURE_SPACE מרחב בטוח (רחב מאוד).
EOL_SURE_SPACE מעבר שורה.
HYPHEN מקף בסוף השורה שלא מופיע בטקסט; לא מופיע יחד עם SPACE,‏ LEADER_SPACE או LINE_BREAK.
LINE_BREAK מעבר שורה שמסיים פסקה.

חסימה

רכיב לוגי בדף.

ייצוג ב-JSON 
{
  "property": {
    object (TextProperty)
  },
  "boundingBox": {
    object (BoundingPoly)
  },
  "paragraphs": [
    {
      object (Paragraph)
    }
  ],
  "blockType": enum (BlockType),
  "confidence": number
}
שדות
property

object (TextProperty)

מידע נוסף שזוהה לגבי החסימה.

boundingBox

object (BoundingPoly)

התיבה התוחמת של הבלוק. הקודקודים מסודרים לפי הסדר הבא: שמאל למעלה, ימין למעלה, ימין למטה, שמאל למטה. כשמזוהה סיבוב של תיבת התוחמת, הסיבוב מוצג סביב הפינה הימנית העליונה, כפי שמוגדר כשקוראים את הטקסט בכיוון 'הטבעי'. לדוגמה:

  • כשהטקסט אופקי, הוא יכול להיראות כך:
    0----1
    |    |
    3----2
  • כשמסובבים אותו ב-180 מעלות סביב הפינה הימנית העליונה הוא הופך ל:
    2----3
    |    |
    1----0

וסדר הקודקודים יישאר (0, 1, 2, 3).
paragraphs[]

object (Paragraph)

רשימת הפסקאות בבלוק הזה (אם הבלוק הוא מסוג טקסט).

blockType

enum (BlockType)

סוג הבלוק שזוהה (טקסט, תמונה וכו') עבור הבלוק הזה.

confidence

number

רמת המהימנות של תוצאות ה-OCR בבלוק. טווח [0, 1].

פסקה

יחידה מבנית של טקסט שמייצגת מספר מילים בסדר מסוים.

ייצוג ב-JSON 
{
  "property": {
    object (TextProperty)
  },
  "boundingBox": {
    object (BoundingPoly)
  },
  "words": [
    {
      object (Word)
    }
  ],
  "confidence": number
}
שדות
property

object (TextProperty)

זוהה מידע נוסף לגבי הפסקה.

boundingBox

object (BoundingPoly)

התיבה התוחמת של הפסקה. הקודקודים מסודרים לפי הסדר הבא: שמאל למעלה, ימין למעלה, ימין למטה, שמאל למטה. כשמזוהה סיבוב של תיבת התוחמת, הסיבוב מוצג סביב הפינה הימנית העליונה, כפי שמוגדר כשקוראים את הטקסט בכיוון 'הטבעי'. לדוגמה: * כשהטקסט אופקי, הוא יכול להיראות כך: 0----1 | | 3----2 * כשהוא מסובב ב-180 מעלות סביב הפינה הימנית העליונה, הוא נראה כך: 2----3 | | 1----0 וסדר הקודקודים עדיין יהיה (0, 1, 2, 3).

words[]

object (Word)

רשימה של כל המילים בפסקה הזו.

confidence

number

רמת הוודאות של תוצאות ה-OCR בפסקה. טווח [0, 1].

Word

ייצוג של מילה.

ייצוג ב-JSON 
{
  "property": {
    object (TextProperty)
  },
  "boundingBox": {
    object (BoundingPoly)
  },
  "symbols": [
    {
      object (Symbol)
    }
  ],
  "confidence": number
}
שדות
property

object (TextProperty)

זוהה מידע נוסף לגבי המילה.

boundingBox

object (BoundingPoly)

התיבה התוחמת (bounding box) של המילה. הקודקודים מסודרים לפי הסדר הבא: שמאל למעלה, ימין למעלה, ימין למטה, שמאל למטה. כשמזוהה סיבוב של תיבת התוחמת, הסיבוב מוצג סביב הפינה הימנית העליונה, כפי שמוגדר כשקוראים את הטקסט בכיוון 'הטבעי'. לדוגמה: * כשהטקסט אופקי, הוא יכול להיראות כך: 0----1 | | 3----2 * כשהוא מסובב ב-180 מעלות סביב הפינה הימנית העליונה, הוא נראה כך: 2----3 | | 1----0 וסדר הקודקודים עדיין יהיה (0, 1, 2, 3).

symbols[]

object (Symbol)

רשימת הסמלים במילה. סדר הסמלים הוא לפי סדר הקריאה הטבעי.

confidence

number

רמת הביטחון של תוצאות ה-OCR למילה. טווח [0, 1].

סמל

ייצוג של סמל יחיד.

ייצוג ב-JSON 
{
  "property": {
    object (TextProperty)
  },
  "boundingBox": {
    object (BoundingPoly)
  },
  "text": string,
  "confidence": number
}
שדות
property

object (TextProperty)

זוהה מידע נוסף לגבי הסמל.

boundingBox

object (BoundingPoly)

התיבה התוחמת של הסמל. הקודקודים מסודרים לפי הסדר הבא: שמאל למעלה, ימין למעלה, ימין למטה, שמאל למטה. כשמזוהה סיבוב של תיבת התוחמת, הסיבוב מוצג סביב הפינה הימנית העליונה, כפי שמוגדר כשקוראים את הטקסט בכיוון 'הטבעי'. לדוגמה: * כשהטקסט אופקי, הוא יכול להיראות כך: 0----1 | | 3----2 * כשהוא מסובב ב-180 מעלות סביב הפינה הימנית העליונה, הוא נראה כך: 2----3 | | 1----0 וסדר הקודקודים עדיין יהיה (0, 1, 2, 3).

text

string

הייצוג בפועל של הסמל ב-UTF-8.

confidence

number

רמת המהימנות של תוצאות ה-OCR של הסמל. טווח [0, 1].

BlockType

סוג הבלוק (טקסט, תמונה וכו') כפי שזוהה על ידי OCR.

טיפוסים בני מנייה (enum)
UNKNOWN סוג הבלוק לא ידוע.
TEXT בלוק טקסט רגיל.
TABLE בלוק של טבלה.
PICTURE חסימת תמונה.
RULER תיבה עם קו אופקי או אנכי.
BARCODE בלוק ברקוד.

SafeSearchAnnotation

קבוצת תכונות שקשורות לתמונה, שמחושבות באמצעות שיטות של ראייה ממוחשבת בקטגוריות של חיפוש בטוח (לדוגמה, תוכן למבוגרים בלבד, זיוף, רפואי, אלימות).

ייצוג ב-JSON 
{
  "adult": enum (Likelihood),
  "spoof": enum (Likelihood),
  "medical": enum (Likelihood),
  "violence": enum (Likelihood),
  "racy": enum (Likelihood)
}
שדות
adult

enum (Likelihood)

ההסתברות שהתמונה מכילה תוכן למבוגרים בלבד. תוכן למבוגרים בלבד עשוי להכיל רכיבים כמו עירום, תמונות או סרטים מצוירים פורנוגרפיים או פעילויות מיניות.

spoof

enum (Likelihood)

סבירות הזיוף. הסבירות שבוצע שינוי בגרסה הקנונית של התמונה כדי שהיא תיראה מצחיקה או פוגענית.

medical

enum (Likelihood)

הסבירות שמדובר בתמונה רפואית.

violence

enum (Likelihood)

הסבירות שהתמונה הזו מכילה תוכן אלים.

racy

enum (Likelihood)

הסבירות שהתמונה בבקשה מכילה תוכן בעל אופי מיני. תוכן נועז עשוי לכלול (אבל לא רק) ביגוד חושפני או שקוף, עירום מכוסה באופן אסטרטגי, תנוחות מגונות או פרובוקטיביות או תקריבים של אזורים רגישים בגוף.

ImageProperties

מאחסן מאפייני תמונה, כמו הצבעים הדומיננטיים.

ייצוג ב-JSON 
{
  "dominantColors": {
    object (DominantColorsAnnotation)
  }
}
שדות
dominantColors

object (DominantColorsAnnotation)

אם יש צבעים דומיננטיים, הם הושלמו.

DominantColorsAnnotation

קבוצה של צבעים דומיננטיים והציונים התואמים שלהם.

ייצוג ב-JSON 
{
  "colors": [
    {
      object (ColorInfo)
    }
  ]
}
שדות
colors[]

object (ColorInfo)

ערכי צבעי RGB עם הציון והחלק היחסי של הפיקסלים.

ColorInfo

מידע על צבע כולל ערוצי RGB, ציון ושבריר התמונה שהצבע תופס בתמונה.

ייצוג ב-JSON 
{
  "color": {
    object (Color)
  },
  "score": number,
  "pixelFraction": number
}
שדות
color

object (Color)

רכיבי ה-RGB של הצבע.

score

number

ציון ספציפי לתמונה של הצבע הזה. הערך בטווח [0, 1].

pixelFraction

number

החלק היחסי של הפיקסלים שהצבע תופס בתמונה. הערך בטווח [0, 1].

צבע

מייצג צבע במרחב הצבעים RGBA. הייצוג הזה נועד לפשט את ההמרה לייצוגים של צבעים בשפות שונות, או מהם, תוך התמקדות בפשטות ולא בדחיסה. לדוגמה, אפשר לספק את השדות של הייצוג הזה בקלות לקונסטרוקטור של java.awt.Color ב-Java. אפשר גם לספק אותם בקלות לשיטה ‎+colorWithRed:green:blue:alpha של UIColor ב-iOS. בנוסף, אפשר לעצב אותם בקלות למחרוזת rgba()‎ של CSS ב-JavaScript, עם קצת עבודה.

הערה: פרוטוקול זה לא כולל מידע על מרחב הצבעים המוחלט שצריך לשמש לפרשנות של ערך ה-RGB (למשל, sRGB, ‏ Adobe RGB, ‏ DCI-P3, ‏ BT.2020 וכו'). כברירת מחדל, האפליקציות צריכות להניח שמרחב הצבעים הוא sRGB.

דוגמה (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

דוגמה (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

דוגמה (JavaScript):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor_(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor_ = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...
ייצוג ב-JSON 
{
  "red": number,
  "green": number,
  "blue": number,
  "alpha": number
}
שדות
red

number

כמות האדום בצבע כערך במרווח [0, 1].

green

number

כמות הירוק בצבע כערך במרווח [0, 1].

blue

number

כמות הכחול בצבע כערך במרווח [0, 1].

alpha

number

החלק היחסי של הצבע הזה שצריך להחיל על הפיקסל. כלומר, הצבע הסופי של הפיקסל מוגדר על ידי המשוואה:

צבע הפיקסל = אלפא * (הצבע הזה) + (‎1.0 – אלפא) * (צבע הרקע)

כלומר, ערך של 1.0 מתאים לצבע אחיד, ואילו ערך של 0.0 מתאים לצבע שקוף לחלוטין. ההגדרה הזו משתמשת בהודעת wrapper במקום בסקלר פשוט של מספרים ממשיים, כדי לאפשר הבחנה בין ערך ברירת מחדל לבין ערך שלא הוגדר. אם לא מציינים את אובייקט הצבע הזה, הוא יוצג כצבע אחיד (כאילו ערך האלפא צוין במפורש כ-1.0).

CropHintsAnnotation

קבוצה של רמזים לחיתוך שמשמשים ליצירת חיתוכים חדשים כשמציגים תמונות.

ייצוג ב-JSON 
{
  "cropHints": [
    {
      object (CropHint)
    }
  ]
}
שדות
cropHints[]

object (CropHint)

תוצאות של הצעות חיתוך.

CropHint

רמז לחיתוך יחיד שמשמש ליצירת חיתוך חדש כשמציגים תמונה.

ייצוג ב-JSON 
{
  "boundingPoly": {
    object (BoundingPoly)
  },
  "confidence": number,
  "importanceFraction": number
}
שדות
boundingPoly

object (BoundingPoly)

המצולע התוחם של אזור החיתוך. הקואורדינטות של התיבה התוחמת הן בסקאלה של התמונה המקורית.

confidence

number

רמת הביטחון שמדובר באזור בולט. טווח [0, 1].

importanceFraction

number

חלק החשיבות של האזור הבולט הזה ביחס לתמונה המקורית.

WebDetection

מידע רלוונטי לתמונה מהאינטרנט.

ייצוג ב-JSON 
{
  "webEntities": [
    {
      object (WebEntity)
    }
  ],
  "fullMatchingImages": [
    {
      object (WebImage)
    }
  ],
  "partialMatchingImages": [
    {
      object (WebImage)
    }
  ],
  "pagesWithMatchingImages": [
    {
      object (WebPage)
    }
  ],
  "visuallySimilarImages": [
    {
      object (WebImage)
    }
  ],
  "bestGuessLabels": [
    {
      object (WebLabel)
    }
  ]
}
שדות
webEntities[]

object (WebEntity)

ישות שהוסקה מתמונות דומות באינטרנט.

fullMatchingImages[]

object (WebImage)

תמונות זהות לחלוטין מהאינטרנט. יכול לכלול עותקים של תמונת השאילתה שגודלם שונה.

partialMatchingImages[]

object (WebImage)

התאמה חלקית של תמונות מהאינטרנט. התמונות האלה דומות מספיק כדי לחלוק כמה מאפיינים של נקודות מרכזיות. לדוגמה, סביר להניח שתמונה מקורית תהיה התאמה חלקית לתמונות חתוכות שלה.

pagesWithMatchingImages[]

object (WebPage)

דפי אינטרנט שמכילים את התמונות התואמות מהאינטרנט.

visuallySimilarImages[]

object (WebImage)

תוצאות של תמונות דומות מבחינה חזותית.

bestGuessLabels[]

object (WebLabel)

הניחוש הכי טוב של השירות לגבי הנושא של התמונה שמופיעה בבקשה. המידע הזה נגזר מתמונות דומות באינטרנט הפתוח.

WebEntity

הישות נגזרת מתמונות דומות באינטרנט.

ייצוג ב-JSON 
{
  "entityId": string,
  "score": number,
  "description": string
}
שדות
entityId

string

מזהה ישות אטום.

score

number

ציון הרלוונטיות הכולל של הישות. לא מנורמלים ולא ניתנים להשוואה בין שאילתות שונות של תמונות.

description

string

תיאור קנוני של הישות, באנגלית.

WebImage

מטא-נתונים של תמונות באינטרנט.

ייצוג ב-JSON 
{
  "url": string,
  "score": number
}
שדות
url

string

כתובת ה-URL של תמונת התוצאה.

score

number

(הוצא משימוש) ציון הרלוונטיות הכולל של התמונה.

WebPage

מטא-נתונים של דפי אינטרנט.

ייצוג ב-JSON 
{
  "url": string,
  "score": number,
  "pageTitle": string,
  "fullMatchingImages": [
    {
      object (WebImage)
    }
  ],
  "partialMatchingImages": [
    {
      object (WebImage)
    }
  ]
}
שדות
url

string

כתובת ה-URL של דף האינטרנט של התוצאה.

score

number

(הוצא משימוש) ציון הרלוונטיות הכולל של דף האינטרנט.

pageTitle

string

הכותרת של דף האינטרנט, יכולה להכיל תגי עיצוב של HTML.

fullMatchingImages[]

object (WebImage)

תמונות זהות בדף. יכול לכלול עותקים של תמונת השאילתה שגודלם שונה.

partialMatchingImages[]

object (WebImage)

תמונות תואמות חלקיות בדף. התמונות האלה דומות מספיק כדי לחלוק כמה מאפיינים של נקודות מרכזיות. לדוגמה, סביר להניח שתמונה מקורית תהיה התאמה חלקית לתמונות חתוכות שלה.

WebLabel

תווית שמספקת מטא-נתונים נוספים לזיהוי באינטרנט.

ייצוג ב-JSON 
{
  "label": string,
  "languageCode": string
}
שדות
label

string

תווית למטא-נתונים נוספים.

languageCode

string

קוד השפה בפורמט BCP-47 עבור label, למשל 'en-US' או 'sr-Latn'. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

ProductSearchResults

תוצאות של בקשת חיפוש מוצר.

ייצוג ב-JSON 
{
  "indexTime": string,
  "results": [
    {
      object (Result)
    }
  ],
  "productGroupedResults": [
    {
      object (GroupedResult)
    }
  ]
}
שדות
indexTime

string (Timestamp format)

חותמת הזמן של האינדקס שממנו התקבלו התוצאות האלה. מוצרים שנוספו לסט המוצרים ומוצרים שהוסרו מסט המוצרים אחרי השעה הזו לא יופיעו בתוצאות הנוכחיות.

חותמת זמן בפורמט RFC3339 UTC ‏'Zulu', מדויקת עד לרמת הננו-שנייה. דוגמה: "2014-10-02T15:01:23.045123456Z"
results[]

object (Result)

רשימת תוצאות, אחת לכל התאמה של מוצר.

productGroupedResults[]

object (GroupedResult)

רשימת תוצאות שמקובצות לפי מוצרים שזוהו בתמונת השאילתה. כל רשומה מתאימה לפוליגון תוחם אחד בתמונת השאילתה, ומכילה את המוצרים התואמים שספציפיים לאזור הזה. יכול להיות שיהיו כפילויות של התאמות מוצרים באיחוד של כל התוצאות לכל מוצר.

תוצאה

מידע על מוצר.

ייצוג ב-JSON 
{
  "product": {
    object (Product)
  },
  "score": number,
  "image": string
}
שדות
product

object (Product)

המוצר.

score

number

רמת המהימנות של ההתאמה, בין 0 (ללא מהימנות) ל-1 (מהימנות מלאה).

image

string

שם המשאב של התמונה מהמוצר שהכי מתאים לשאילתה.

GroupedResult

מידע על מוצרים שדומים למוצר בודד בתמונה של שאילתה.

ייצוג ב-JSON 
{
  "boundingPoly": {
    object (BoundingPoly)
  },
  "results": [
    {
      object (Result)
    }
  ],
  "objectAnnotations": [
    {
      object (ObjectAnnotation)
    }
  ]
}
שדות
boundingPoly

object (BoundingPoly)

המצולע התוחם סביב המוצר שזוהה בתמונת השאילתה.

results[]

object (Result)

רשימת תוצאות, אחת לכל התאמה של מוצר.

objectAnnotations[]

object (ObjectAnnotation)

רשימה של תחזיות כלליות לגבי האובייקט בתיבת התוחמת.

ObjectAnnotation

תחזית לגבי האובייקט בתיבת התוחמת.

ייצוג ב-JSON 
{
  "mid": string,
  "languageCode": string,
  "name": string,
  "score": number
}
שדות
mid

string

מזהה האובייקט שצריך להיות זהה ל-mid של EntityAnnotation.

languageCode

string

קוד השפה בפורמט BCP-47, כמו en-US או sr-Latn. מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

name

string

שם האובייקט, בשפה languageCode.

score

number

הניקוד של התוצאה. טווח [0, 1].

ImageAnnotationContext

אם התמונה נוצרה מקובץ (למשל PDF), בהודעה הזו מופיע מידע על המקור של התמונה.

ייצוג ב-JSON 
{
  "uri": string,
  "pageNumber": number
}
שדות
uri

string

ה-URI של הקובץ ששימש ליצירת התמונה.

pageNumber

number

אם הקובץ היה PDF או TIFF, בשדה הזה מצוין מספר הדף בקובץ ששימש ליצירת התמונה.