AnnotateImageRequest

בקשה לביצוע משימות של Google Cloud Vision API על תמונה שהמשתמש סיפק, עם תכונות שהמשתמש ביקש ועם מידע הקשרי.

ייצוג ב-JSON 
{
  "image": {
    object(Image)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "customLabelDetectionModels": [
    string
  ]
}
שדות
image

object(Image)

התמונה לעיבוד.

features[]

object(Feature)

תכונות מבוקשות.

imageContext

object(ImageContext)

הקשר נוסף שאולי יצורף לתמונה.

customLabelDetectionModels[]

string

כששולחים בקשה עם ערך CUSTOM_LABEL_DETECTION בשדה features.type, בשדה CustomLabelDetectionModels צריך לציין את המודלים המותאמים אישית שבהם רוצים להשתמש. הפורמט של שם המודל זהה לכתובת ה-URL של המשאב של המודל בהתאמה אישית: /projects/PROJECT_ID/models/MODEL_ID, או /models/MODEL_ID אם המודל שייך לפרויקט הנוכחי.

תמונה

תמונה של לקוח לביצוע משימות של Google Cloud Vision API.

ייצוג ב-JSON 
{
  "content": string,
  "source": {
    object(ImageSource)
  }
}
שדות
content

string (bytes format)

תוכן של תמונה, שמיוצג כזרם של בייטים. הערה: כמו בכל השדות של bytes, ב-Protobuf נעשה שימוש בייצוג בינארי טהור, ואילו בייצוגי JSON נעשה שימוש ב-Base64.

מחרוזת בקידוד Base64.
source

object(ImageSource)

מיקום התמונה ב-Google Cloud Storage או כתובת URL של תמונה שנגישה לציבור. אם גם content וגם source מצוינים עבור תמונה, content מקבל עדיפות ומשמש לביצוע בקשת הערות התמונה.

ImageSource

מקור חיצוני של תמונה (Google Cloud Storage או כתובת URL של תמונה באינטרנט).

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

string

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

‫URI של Cloud Storage מהצורה gs://bucket_name/object_name. אין תמיכה בניהול גרסאות של אובייקטים. מידע נוסף זמין במאמר בנושא כתובות URI של בקשות ב-Google Cloud Storage.
imageUri

string

ה-URI של תמונת המקור. יכול להיות:

  1. ‫URI של Cloud Storage בפורמט gs://bucket_name/object_name. אין תמיכה בניהול גרסאות של אובייקטים. מידע נוסף זמין במאמר בנושא Google Cloud Storage Request URIs.

  2. כתובת URL מסוג HTTP או HTTPS של תמונה שזמינה לציבור. כשמאחזרים תמונות מכתובות URL של HTTP/HTTPS, ‏ Google לא יכולה להבטיח שהבקשה תושלם. יכול להיות שהבקשה תיכשל אם המארח שצוין דוחה את הבקשה (למשל, בגלל הגבלת קצב הבקשות או מניעת התקפות מניעת שירות), או אם Google מגבילה את קצב הבקשות לאתר כדי למנוע ניצול לרעה. לא כדאי להסתמך על תמונות שמתארחות במקור חיצוני באפליקציות לייצור.

אם מציינים גם את gcsImageUri וגם את imageUri, הערך של imageUri מקבל עדיפות.