מצלמה.getImage

מחזירה תמונה בגודל מלא או בגודל מלא בהתאם ל-URI שלה. הפרמטרים של הקלט כוללים רזולוציה. זוהי הפקודה היחידה שאמורה להחזיר, Content-Type: image/jpeg. כל שאר הפקודות מחזירות את הערך Content-Type: application/json;charset=utf-8. הפקודה הזו הוצאה משימוש ברמת API 2.

פרמטרים

  • fileUri: URI של קובץ היעד. היצרנים מחליטים אם להשתמש במזהי URI מוחלטים או יחסיים. לקוחות עשויים להתייחס לכך כמזהה אטום.
  • maxSize: (אופציונלי) הגודל המקסימלי של התמונה המבוקשת; max(scaledimage_width, scaledimage_height). אם השדה maxSize יושמט או גדול מהתמונה בגודל מלא, תוחזר התמונה בגודל מלא.

תוצאות

  • content: נתונים בינאריים של תמונות, כולל מטא-נתונים תואמים (לדוגמה, מותאמים לקנה מידה) בכותרת התמונה.

שגיאות

  • missingParameter: הערך fileUri הנדרש לא צוין.
  • legalParameterName: שם של פרמטר קלט לא מזוהה.
  • legalParameterValue: השם של פרמטר הקלט מזוהה, אבל הערך שלו לא חוקי. לדוגמה, הערך fileUri לא קיים, סוג הנתונים שגוי או שסוג הנתונים של maxSize שגוי.

Command I/O
קלט פקודה 
{
    "parameters": {
        "fileUri": "file URI",
        "maxSize": 400
    }
}
פלט הפקודה 
Image binary data
פלט הפקודה (שגיאה) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}