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

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

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

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

المتطلبات وتجهيز الصورة

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

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

يمكن إرسال الصورة إلى API بثلاث طرق: رابط صورة يمكن الوصول إليه، أو بيانات صورة مضمنة (مشفرة بترميز base64)، أو Files API. عند استخدام البيانات المضمنة، يجب ألا يتجاوز الحجم الإجمالي للطلب 20 MB، بما يشمل المطالبات النصية والمحتويات الأخرى. ويوصى باستخدام Files API للملفات الكبيرة أو عندما تحتاج إلى استخدام الملف نفسه في أكثر من طلب.

خطوة بخطوة: خمس مطالبات لتحليل الصور

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

Bu mimari görselini incele. Yalnızca görüntüde seçilebilen öğeleri belirt: mekân türü, ana yüzeyler, mobilyalar, aydınlatma ve bitkiler. Bilgi görüntüden anlaşılamıyorsa bunu açıkça söyle. Yanıtı kısa, başlıklı maddeler hâlinde ver.

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

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

Bu iç mekân görselinde gün ışığının hangi bölgelere ulaştığını tarif et. Sadece görüntüde görülebilen ışık ve gölge dağılımına dayan. Pencere yönü veya günün saati görüntüden kesin olarak anlaşılamıyorsa tahmin yürütme; belirsizliği belirt.

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

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

Görselde seçilebilen yüzeyleri şu gruplara ayır: duvar, zemin, tavan ve sabit mobilya. Her grupta görülen yüzeyin rengini ve dokusunu yalnızca görseldeki izlenime göre tarif et. Malzeme türünü kesin olarak belirleyemiyorsan olası malzeme adı verme; “görselden belirlenemiyor” yaz.

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

4. اطلب وصف علاقات التوزيع في الصورة. لا تعرض المصادر مقارنة عدة صور في الطلب نفسه. لذلك يركّز المثال أدناه على علاقات التوزيع الظاهرة في صورة واحدة.

Bu iç mekân görselinde mobilyaların ve dolaşım alanlarının kadraj içinde nasıl konumlandığını tarif et. Yalnızca görüntüde seçilebilen ilişkilere dayan; ölçü, geçiş genişliği veya planda görünmeyen başka bilgiler üretme. Emin olmadığın noktaları ayrıca belirt.

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

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

Bu mimari render için Türkçe, en fazla iki cümlelik tarafsız bir görsel açıklaması yaz. Mekânın kullanımını, kadrajda öne çıkan tasarım öğelerini ve görünen ışık koşullarını aktar. Görselde doğrulanamayan proje bilgisi, konum veya tasarımcı adı ekleme.

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

أخطاء شائعة وخطوات التحقق

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

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

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

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

دورها في سير عمل العمارة والتصوير المعماري

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

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

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

ابدأ بالتجربة على صورة واحدة غير حساسة. جرّب مطالبات الوصف والتصنيف والأسئلة والأجوبة كلٌّ على حدة للصورة نفسها، وقيّم شكل الإجابة الأنسب لاحتياجات الفريق. في التحليلات المتكررة، يمكنك التفكير في استخدام Files API؛ أما الطلبات الصغيرة التي تُنفذ مرة واحدة، فاختر لها طريقة الإرسال المناسبة.

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

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

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