מצלמה.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 הנדרש לא צוין.
  • INVALIDParameterName: שם פרמטר קלט לא מזוהה.
  • invalidParameterValue: השם של פרמטר הקלט מזוהה, אבל הערך שלו לא חוקית, לדוגמה, הערך fileUri לא קיים, סוג הנתונים שלו שגוי, או מסוג maxSize, סוג הנתונים שגוי.

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