1. قبل البدء
في مرحلة مبكرة من المسار التعليمي للبحث عن صورة المنتج، تعلّمت كيفية طلب حق الوصول إلى خلفية عملية البحث عن المنتجات التي تم إنشاؤها باستخدام Vision API Product Search لمنتجات مشابهة بصريًا من كتالوج المنتجات.
في هذا الدرس التطبيقي حول الترميز، ستتعرّف على كيفية إنشاء خلفية مشابهة لكتالوج منتجاتك.
ما ستتعرّف عليه
- كيفية إنشاء خلفية للبحث عن المنتجات باستخدام Vision API Product Search
- كيفية إعداد مفتاح واجهة برمجة التطبيقات للوصول إلى Vision API من التطبيقات المتوافقة مع الأجهزة الجوّالة
المتطلبات اللازمة
- حساب Google Cloud مع تفعيل الفوترة (يمكن أن يكون حساب فترة تجريبية مجانية)
2. لمحة عن منتج Vision API Product Search
Vision API Product Search هي ميزة في Google Cloud تتيح لبائعي التجزئة إنشاء منتجات، ويتضمّن كلّ منها صورًا مرجعية تصف المنتج بصريًا من خلال مجموعة من وجهات النظر. ويمكن لبائعي التجزئة إضافة هذه المنتجات إلى مجموعات المنتجات. في الوقت الحالي، تسمح واجهة برمجة تطبيقات المنتجات في Vision API بفئات المنتجات التالية: السلع المنزلية والملابس والألعاب والسلع المجمّعة والمنتجات العامة.
عندما يبحث المستخدمون عن مجموعة المنتجات بصورهم الخاصة، يطبِّق Vision API Product Search تكنولوجيا تعلُّم الآلة لمقارنة المنتج في صورة طلب بحث المستخدم مع الصور المعروضة في مجموعة منتجات بائع التجزئة، ثم يعرض قائمة مرتبة لنتائج مشابهة من الناحية المرئية ودلاليًا.
3- إنشاء الخلفية باستخدام Google Cloud
في وقت سابق في المسار التعليمي للبحث عن صور المنتجات، استخدمت خلفية تجريبية للبحث عن منتج تم إنشاؤها باستخدام Vision API Product Search. أنشئ البرنامج التعليمي نفسه في حسابك على Google Cloud باتباع هذا البرنامج التعليمي:
بعد إكمال البرنامج التعليمي، يمكنك المتابعة إلى الخطوات التالية لإعداد مفتاح واجهة برمجة تطبيقات للاتصال بالخلفية من تطبيقاتك المتوافقة مع الأجهزة الجوّالة.
4. مفتاح واجهة برمجة التطبيقات للإعداد
في البدء السريع للبحث عن منتجات واجهة برمجة التطبيقات Vision API، يكون لديك واجهة خلفية للبحث عن المنتجات يمكنها التقاط صورة لطلب بحث وعرض منتجات مشابهة بصريًا. للاتصال بواجهة برمجة تطبيقات البحث عن منتج من تطبيق متوافق مع الأجهزة الجوّالة، عليك إعداد مفتاح واجهة برمجة تطبيقات ثم حظر الوصول إلى مفتاح واجهة برمجة التطبيقات على تطبيقاتك المتوافقة مع الأجهزة الجوّالة، وذلك لتجنّب الاستخدام غير المصرّح به.
إنشاء مفتاح واجهة برمجة تطبيقات
- انتقِل إلى Cloud Console > APIs & Services > Credentials. يمكنك أيضًا النقر على عنوان URL هذا واختيار المشروع الذي استخدمته في دليل البدء السريع لخدمة Product Search.
- اختَر إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات. سيظهر لك مربع الحوار هذا إذا تم إنشاء مفتاح واجهة برمجة التطبيقات بنجاح:
دوِّن مفتاح واجهة برمجة التطبيقات هذا. وستستخدمها لاحقًا في هذا الدرس التطبيقي حول الترميز.
تقييد الوصول إلى مفتاح واجهة برمجة التطبيقات
عندما تظهر لك رسالة المطالبة أعلاه، انقر على تقييد المفتاح.
اتّبِع التعليمات التي تظهر على الشاشة لتطبيق هذه القيود:
- قيود التطبيقات >؛ تطبيقات Android
- قيود واجهة برمجة التطبيقات >؛ تقييد المفتاح >؛ Cloud Vision API
5. تنزيل التطبيق المتوافق مع الأجهزة الجوّالة وتشغيله
يمكنك تنزيل التطبيق المتوافق مع Android الذي أنشأته في وقت سابق والذي استخدم الخلفية الخلفية للبحث عن المنتج، وتغييره لاستخدام الخلفية الجديدة التي أنشأتها للتو.
تنزيل الرمز
انقر على الرابط التالي لتنزيل كل رموز هذا الدرس التطبيقي حول الترميز:
فك ضغط ملف zip الذي تم تنزيله. وسيؤدي ذلك إلى تفريغ مجلد جذر (odml-pathway-codelabs) يحتوي على جميع الموارد التي ستحتاج إليها. بالنسبة إلى هذا الدرس التطبيقي حول الترميز، ستحتاج فقط إلى المصادر في الدليل الفرعي product-search/codelab2/android/final.
يستخدم التطبيق واجهة برمجة تطبيقات اكتشاف كائنات ML Kit وتتبُّعها وخلفية بحث تجريبي عن المنتج تم إنشاؤها باستخدام Vision API Product Search للسماح للمستخدمين بالتقاط الصور والبحث عن المنتجات المشابهة مرئيًا في كتالوج المنتج التجريبي.
استيراد التطبيق إلى "استوديو Android"
ابدأ باستيراد تطبيق Starter إلى "استوديو Android".
انتقل إلى "استوديو Android"، واختَر استيراد مشروع (Gradle أو Eclipse ADT وغير ذلك) واختَر المجلد product-search/codelab2/android/final من رمز المصدر الذي نزّلته في السابق.
تشغيل تطبيق إجراء التفعيل
الآن بعد أن قمت باستيراد المشروع إلى Android Studio، أنت مستعد لتشغيل التطبيق للمرة الأولى.
يمكنك توصيل جهاز Android عبر USB بالمضيف أو بدء محاكي Android Studio والنقر على تشغيل ( 
) في شريط أدوات Android Studio.
(في حال إيقاف هذا الزر، احرِص على استيراد الملف النهائي/app/build.gradle فقط، وليس المستودع بالكامل).
من المفترض أن يتم إطلاق التطبيق على جهازك الذي يعمل بنظام التشغيل Android. وهي تعمل بالفعل، ولكنها تستخدِم خلفية البحث عن منتجات إصدار تجريبي التي نشرتها Google لك.
بعد ذلك، عليك تحديث التطبيق لاستخدام الخلفية التي أنشأتها سابقًا في هذا الدرس التطبيقي حول الترميز.
6- تعديل نقاط نهاية واجهة برمجة التطبيقات
تغيير إعدادات واجهة برمجة التطبيقات
انتقل إلى الفئة ProductSearchAPIClient وستظهر لك عمليات ضبط خلفية البحث عن المنتجات المحددة من قبل. تعليق عمليات ضبط الواجهة الخلفية للجهاز التجريبي:
// Define the product search backend
// Option 1: Use the demo project that we have already deployed for you
// const val VISION_API_URL =
"https://us-central1-odml-codelabs.cloudfunctions.net/productSearch"
// const val VISION_API_KEY = ""
// const val VISION_API_PROJECT_ID = "odml-codelabs"
// const val VISION_API_LOCATION_ID = "us-east1"
// const val VISION_API_PRODUCT_SET_ID = "product_set0"
بعد ذلك، يمكنك استبدالها بالإعداد:
// Option 2: Go through the Vision API Product Search quickstart and deploy to your project.
// Fill in the const below with your project info.
const val VISION_API_URL = "https://vision.googleapis.com/v1"
const val VISION_API_KEY = "YOUR_API_KEY"
const val VISION_API_PROJECT_ID = "YOUR_PROJECT_ID"
const val VISION_API_LOCATION_ID = "YOUR_LOCATION_ID"
const val VISION_API_PRODUCT_SET_ID = "YOUR_PRODUCT_SET_ID"
- VISION_API_URL هي نقطة نهاية واجهة برمجة التطبيقات لواجهة برمجة التطبيقات في Cloud Vision.
- VISION_API_KEY هو مفتاح واجهة برمجة التطبيقات الذي أنشأته سابقًا في هذا الدرس التطبيقي حول الترميز.
- VISION_API_PROJECT_ID، VISION_API_LOCATION_ID، VISION_API_PRODUCT_SET_ID هي القيمة التي استخدمتها في الخطوات الأولى للبحث السريع في واجهة برمجة التطبيقات Vision API.
تشغيلها
الآن انقر على تشغيل ( ) في شريط أدوات "استوديو Android". بعد تحميل التطبيق، انقر على أي صور تم إعدادها مسبقًا واختَر كائنًا تم التعرّف عليه ثم انقر على الزر بحث للاطّلاع على نتائج البحث. يستخدم التطبيق الآن خلفية البحث عن المنتجات التي أنشأتها للتو!
7- تهانينا.
تعرّفت على كيفية إنشاء خلفية للبحث عن المنتجات باستخدام Vision API Product Search.
هذا كل ما تحتاج إليه لإعداده وتشغيله.
المواضيع التي تناولناها
- كيفية إنشاء خلفية للبحث عن المنتجات باستخدام كتالوج المنتج والبحث في منتجات Vision API
- كيفية إعداد مفتاح واجهة برمجة التطبيقات للاتصال بخلفية البحث عن المنتجات من تطبيق متوافق مع الأجهزة الجوّالة
- كيفية الاتصال بالخلفية من تطبيق متوافق مع الأجهزة الجوّالة
الخطوات التالية
- شاهد هذا الفيديو حول استخدام Vision API Product Search لإنشاء خزانة ذكية
- يمكنك الاطّلاع على مسار تعلّم تعلّم الآلة على المنتج في "بحث المنتجات" لمعرفة جميع الخطوات المطلوبة لإنشاء بحث عن منتجات.
- تطبيق ما تعلمته في تطبيقك