metadata.getMetadata

يعرض البيانات الوصفية للملف نظرًا لمعرّف الموارد المنتظم (URI) الخاص به. رأس الصورة يسرد حقلي Exif وXMP. تم إيقاف هذا الأمر نهائيًا في المستوى 2 من واجهة برمجة التطبيقات.

المعلمات

  • fileUri: معرّف الموارد المنتظم (URI) للملف المستهدف. تقرر الشركات المصنِّعة ما إذا استخدام معرفات موارد منتظمة (URI) مطلقة أو نسبية. وقد يتعامل العملاء مع هذا المعرّف على أنّه معرّف مبهم.

النتائج

  • البيانات الوصفية: بيانات Exif (بما في ذلك معلومات GPS) وPhotograph XMP في تنسيق JSON. لا تتضمن الصورة أو الصورة المصغّرة.

الأخطاء

  • مَعلمة غير متوفّرة: لم يتم تحديد السمة fileUri.
  • spamparamName: لم يتم التعرُّف على اسم معلَمة الإدخال.
  • invalidParameterValue: يتم التعرف على معلَمة الإدخال، ولكن القيمة غير صالحة؛ على سبيل المثال، fileUri غير موجودة أو بياناتها النوع غير صحيح.

مفتاح Command I/O

إدخال الطلب
{
    "parameters": {
        "fileUri": "file URI"
    }
}
مخرجات الأوامر
{
    "results": {
        "exif": {
            ...
            "ImageWidth": 2000,
            "ImageLength": 1000,
            ...
        },
        "xmp": {
            "ProjectionType": "equirectangular",
        "UsePanoramaViewer": true,
            ...
        }
    }
}
مخرجات الأوامر (خطأ)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}