تحليل التصيير المعماري باستخدام Gemini API: فحص الصورة خطوة بخطوة

ما الذي ستتعلمه في هذا الدليل؟

يشرح هذا الدليل الخطوات الأساسية لإرسال تصيير معماري إلى Gemini API مع الصورة، وطلب فحص محدد من النموذج. والهدف ليس الحصول على موافقة آلية على الصورة، بل وصف العناصر الظاهرة فيها أو تصنيف خصائص مرئية أو طرح أسئلة عن التصيير. وتشير وثائق Google إلى إمكانية استخدام نماذج Gemini في مهام متعددة الوسائط، مثل شرح الصور وتصنيفها والإجابة عن الأسئلة المتعلقة بها.

في أعمال العمارة والتصوير المرئي، يمكن أن يساعد هذا الأسلوب في تحويل العناصر الظاهرة في المشهد إلى نص، أو التحقق من السمات البارزة في صورة عرض، أو مناقشة التصيير. لكن استجابة النموذج لا تحل محل القرار التصميمي أو التحقق التقني. تعامل مع المخرجات بوصفها تقييماً مساعداً مستنداً إلى الصورة، وقارنها بمعلومات المشروع.

المتطلبات

يتطلب سير العمل الوصول إلى Gemini API وصورة وتعليمات فحص واضحة لها. تتضمن الوثيقة المصدر أمثلة باستخدام Python وJavaScript وJava وGo وREST. ويظهر معرّف النموذج gemini-3.8-flash في الأمثلة؛ ولا نفترض هنا إصداراً محدداً من SDK أو معلومات عن الأسعار، إذ لم ترد في المصدر.

يمكنك توفير الصورة بثلاث طرق:

• رابط URL متاح للجميع: تدرج الوثائق خيار URL ضمن الطرق المناسبة للصور المتاحة للجميع.

• بيانات Base64 مضمنة: تُرفق بيانات الصورة بالطلب مع إدخال النص. يجب ألا يتجاوز الحجم الإجمالي للطلب 20 MB، بما في ذلك المطالبات النصية وتعليمات النظام وبيانات الصورة.

• Files API: تُرفع الملفات الكبيرة، أو الصور التي ستُستخدم في أكثر من طلب، ثم يُرفق URI الناتج بالطلب مع نوع MIME.

يستخدم المثال الوارد في المصدر تحت عنوان URL أيضاً URI لملف تم رفعه عبر Files API. لذلك تحقّق من توافق طريقة الإرسال التي تختارها مع الأمثلة الحالية في وثائق API. وللملفات التي تقترب من حد الحجم عند استخدام الطريقة المضمنة، خذ بخيار Files API الذي توصي به الوثائق.

فحص التصيير المعماري خطوة بخطوة

1. حدّد هدف الفحص. قرّر أولاً السؤال الذي ستطرحه عن التصيير. بدلاً من طلب عام مثل «حلّل الصورة»، اختر موضوعاً محدداً، مثل عناصر المكان الظاهرة أو الانطباع عن الإضاءة أو التكوين. لا تتوقع من النموذج استنتاج معلومات عن المشروع غير موجودة في الصورة.

2. أرسل الصورة بالطريقة المناسبة. إذا كانت الصورة متاحة على عنوان عام، فضع خيار URL في الحسبان. ويمكن استخدام بيانات Base64 مضمنة للملفات الصغيرة، مع ضرورة ألا يتجاوز الحجم الإجمالي للطلب 20 MB. أما إذا كان الملف كبيراً أو كنت ستعيد استخدام الصورة، فارفعه عبر Files API وأرفق URI ونوع MIME بالطلب. احرص في جميع الطرق على أن تخدم التعليمات النصية والصورة الهدف نفسه من الفحص.

3. اكتب تعليمات واضحة ومحددة. يوصي دليل Google لتصميم المطالبات بأن تكون التعليمات واضحة ومحددة، وأن تصف تنسيق الإجابة المتوقع عند الحاجة. أُعد المثال الأصلي أدناه لطلب قائمة بالعناصر الظاهرة فقط في تصيير داخلي:

Bu iç mekân render’ını incele. Yalnızca görüntüde açıkça seçilebilen mekân öğelerini listele: duvar, döşeme, mobilya, aydınlatma ve açıklıklar. Görselde olmayan bilgileri tahmin etme. Emin olmadığın noktaları “belirsiz” olarak belirt. Yanıtı kısa maddeler hâlinde ver.

تحصر هذه التعليمات نطاق الفحص، وتوضح صراحةً ضرورة عدم تخمين المعلومات غير الظاهرة. وقارن الإجابة أيضاً بالصورة ووثائق المشروع.

1. اطلب تصنيف سمة ظاهرة. يساعد تحديد الخيارات مسبقاً على توضيح نطاق طلب التصنيف. يطلب المثال التالي تصنيف الانطباع عن الإضاءة، لا قياس شدة الإضاءة الفعلية:

Görseldeki aydınlatma izlenimini şu seçeneklerden biriyle sınıflandır: doğal ışık baskın, yapay ışık baskın, dengeli veya belirsiz. Seçimini destekleyen, görüntüde görülebilen iki ipucu yaz. Ölçüm değeri verme.

قد يسهّل هذا التصنيف تدوين الملاحظات تحت العناوين نفسها لصور مختلفة. لكن الإجابة لا تعني التحقق من حسابات الإضاءة أو إعدادات التصيير.

1. اطرح سؤالاً محدداً عن الصورة. في سير عمل الإجابة عن الأسئلة المتعلقة بالصور، من المفيد حصر الرد في العناصر القابلة للملاحظة. يمكنك مثلاً طلب وصف المنطقة الأبرز في التكوين:

Bu mimari görselde izleyicinin dikkatini ilk çekmesi muhtemel alanı tarif et. Görüntüdeki konumunu ve bu yorumu destekleyen görünür kompozisyon öğelerini belirt. Tasarım niyeti hakkında çıkarım yapma.

لا تقيس قراءة النموذج ردود الفعل الفعلية للمشاهدين. لذلك لا تعرض الإجابة على أنها نتيجة بحث مع المستخدمين أو تقييماً تصميمياً قاطعاً.

1. حدّد تنسيق الإجابة وراجع النتيجة. يمكنك أن تطلب في التعليمات فقرة قصيرة أو نقاطاً أو عناوين محددة. ويؤكد الدليل أن الأمثلة قد تساعد أيضاً في توجيه شكل الإجابة، وأن تصميم المطالبات عملية اختبار وتحسين. إذا كانت الإجابة الأولى عامة أكثر من اللازم، فضيّق نطاق المهمة؛ كأن تطلب قائمة بالمواد الظاهرة فقط بدلاً من تعليق عام.

أخطاء شائعة

• إعطاء تعليمات مبهمة: عبارة «قيّم التصيير» تحدد مهمة واسعة. اذكر السمة المطلوب فحصها وشكل الإجابة.

• توقع بيانات تقنية دقيقة من الصورة: الشرح أو التصنيف ليس تقرير قياس ولا تحققاً من نموذج المشروع.

• السؤال عن معلومات غير ظاهرة: لا تتوقع إجابة قاطعة عن علامة مادة أو أبعاد أو نظام إنشائي غير ظاهر في الصورة. اطلب صراحةً الإشارة إلى مواضع عدم اليقين.

• عدم اختيار طريقة إرسال الملف بما يلائم الحاجة: يقتصر الحجم الإجمالي للطلب على 20 MB عند استخدام البيانات المضمنة. خذ بتوصية الوثائق حول Files API للصور الكبيرة أو التي ستُستخدم مراراً.

• مشاركة المخرجات من دون مراجعتها: قارن الأوصاف الناتجة بالصورة، ولا تنقل التفسيرات غير المدعومة مباشرةً إلى عروضك أو ملاحظات المشروع.

أثر ذلك في سير عمل العمارة والتصوير المرئي

قد تساعد هذه الطريقة مكاتب العمارة ومصممي الديكور الداخلي وفرق التصوير المرئي في وصف التصييرات وتنظيم ملاحظات المراجعة الأولية. ويمكن للفرق توحيد مطالباتها إذا أرادت استخدام المعايير نفسها مراراً. ويعتمد الاختيار بين إرسال الصورة عبر URL أو Base64 أو Files API على إمكانية الوصول إلى الصورة وحجم الملف والحاجة إلى إعادة استخدامه.

لا يحل استخدام API محل برنامج التصيير الحالي؛ كما لا تذكر المصادر متطلبات الأجهزة أو معلومات التوافق مع برامج التصيير. ينبغي للفرق تقييم إمكانية الوصول إلى API وأي شروط تكلفة غير موضحة قبل بدء الاستخدام. ولا ينبغي أن تكون إجابات النموذج الأساس الوحيد للقرارات التصميمية والتقنية؛ بل يجب التحقق منها بالرجوع إلى الصورة وبيانات المشروع.

الخطوات التالية

ابدأ التجربة بتصيير واحد وسؤال واحد محدد. ثم جرّب تعليمات مختلفة وواضحة للصورة نفسها، وراقب اختلاف الإجابات. وعند مقارنة عدة صور، قد يسهل استخدام المعايير وتنسيق الإجابة نفسيهما تنظيم النتائج؛ ومع ذلك، احصر المقارنة في المعلومات المرئية في الصور.

تشير الوثائق إلى إمكان تحسين الدقة بالتدريب الإضافي في حالات استخدام محددة، مثل العثور على عناصر في الصورة أو عزل مناطق منها. ولا يعني ذلك تحقيق المستوى نفسه من النجاح مع كل صورة معمارية. إذا تجاوزت الحاجة مهام الشرح أو الإجابة البسيطة عن الأسئلة، فتحقّق بشكل منفصل من الطريقة المستخدمة ومن المخرجات المتحصّل عليها.

المصدر والترخيص

أُعد هذا الدليل بالاستناد إلى وثائق Google حول فهم الصور في Gemini API وتصميم المطالبات، مع تكييفها من التركية. كلا المصدرين مرخّص بموجب CC BY 4.0. وقد كُتبت مطالبات التصيير المعماري الواردة هنا خصيصاً، ولم تُنسخ من أمثلة المصادر.