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." } } |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Returns file metadata such as Exif and XMP data for a given file URI."],["This command is deprecated and was previously used in API level 2."],["Important parameters include the `fileUri`, which specifies the location of the target file."],["Potential errors encompass missing or invalid parameters, including an invalid or non-existent `fileUri`."],["The command output provides Exif and Photo Sphere XMP data in JSON format if successful."]]],["This command retrieves a file's metadata using its URI. It's deprecated in API level 2. Input requires a `fileUri`. The output provides Exif data (including GPS) and Photo Sphere XMP in JSON format, excluding the image itself. Possible errors include a missing or invalid `fileUri`, or an unrecognized parameter name. Example input shows providing a file URI, with successful output including `exif` and `xmp` fields, and error output shown when a file URI does not exist.\n"]]