1. قبل از شروع
قبلاً در مسیر یادگیری جستجوی تصویر محصول، یاد گرفتید که چگونه باطن جستجوی محصول ساخته شده با Vision API Product Search را برای محصولات مشابه بصری از کاتالوگ محصول فراخوانی کنید.
در این کد لبه، یاد خواهید گرفت که چگونه یک Backend مشابه اما با کاتالوگ محصولات خود بسازید.
چیزی که یاد خواهید گرفت
- چگونه با Vision API Product Search یک Backend جستجوی محصول بسازیم
- نحوه تنظیم کلید API برای دسترسی به Vision API از برنامه های تلفن همراه
آنچه شما نیاز دارید
- یک حساب Google Cloud با فعال کردن صورت‌حساب (می‌تواند یک حساب آزمایشی رایگان باشد)
2. درباره Vision API Product Search
Vision API Product Search یک ویژگی در Google Cloud است که به خرده فروشان اجازه می دهد محصولاتی ایجاد کنند که هر کدام حاوی تصاویر مرجعی است که به صورت بصری محصول را از مجموعه ای از دیدگاه ها توصیف می کند. سپس خرده فروشان می توانند این محصولات را به مجموعه محصولات اضافه کنند. در حال حاضر Vision API Product Search از دسته بندی محصولات زیر پشتیبانی می کند: کالاهای خانگی، پوشاک، اسباب بازی، کالاهای بسته بندی شده و عمومی.
هنگامی که کاربران مجموعه محصول را با تصاویر خود پرس و جو می کنند، Vision API Product Search از یادگیری ماشینی برای مقایسه محصول در تصویر جستجوی کاربر با تصاویر موجود در مجموعه محصول خرده فروش استفاده می کند و سپس فهرست رتبه بندی شده ای از نتایج مشابه بصری و معنایی را برمی گرداند.
3. با Google Cloud بک اند بسازید
قبلاً در مسیر یادگیری جستجوی تصویر محصول، از یک باطن جستجوی محصول آزمایشی ساخته شده با Vision API Product Search استفاده می‌کردید. با دنبال کردن این آموزش، همان Backend را در حساب Google Cloud خود بسازید:
پس از تکمیل آموزش، مراحل زیر را برای تنظیم یک کلید API برای فراخوانی باطن از برنامه های تلفن همراه خود ادامه دهید.
4. کلید API را تنظیم کنید
در راه اندازی سریع محصول Vision API، شما یک پشتیبان جستجوی محصول ساخته اید که می تواند یک تصویر درخواستی بگیرد و محصولات مشابه بصری را برگرداند. به منظور فراخوانی API جستجوی محصول از یک برنامه تلفن همراه، برای جلوگیری از استفاده غیرمجاز، باید یک کلید API تنظیم کنید و سپس دسترسی به کلید API را به برنامه های تلفن همراه خود محدود کنید.
یک کلید API ایجاد کنید
- به Cloud Console > APIs & Services > Credentials بروید. همچنین می توانید روی این URL کلیک کنید و پروژه ای را که در شروع سریع جستجوی محصول استفاده کرده اید انتخاب کنید.
- Create Credentials > API key را انتخاب کنید. اگر کلید API شما با موفقیت ایجاد شده باشد، این گفتگو را خواهید دید:
به این کلید API توجه داشته باشید. بعداً در این کد لبه از آن استفاده خواهید کرد.
دسترسی به کلید API را محدود کنید
هنگام مشاهده اعلان بالا، Restrict key را انتخاب کنید.
دستورالعمل های روی صفحه را برای اعمال این محدودیت ها دنبال کنید:
- محدودیت های برنامه > برنامه های اندروید
- محدودیت‌های API > کلید محدود > Cloud Vision API
5. اپلیکیشن موبایل را دانلود و اجرا کنید
می‌توانید برنامه اندرویدی را که قبلاً ساخته‌اید و از پشتیبان جستجوی محصول آزمایشی استفاده می‌کرد دانلود کنید و آن را برای استفاده از بک‌اند جدیدی که به تازگی ساخته‌اید تغییر دهید.
کد را دانلود کنید
برای دانلود تمامی کدهای این کد لبه روی لینک زیر کلیک کنید:
فایل فشرده دانلود شده را باز کنید. با این کار یک پوشه ریشه (odml-pathway-codelabs) با تمام منابعی که نیاز دارید باز می شود. برای این کد لبه، شما فقط به منابع موجود در فهرست فرعی product-search/codelab2/android/final نیاز دارید.
این برنامه از ML Kit Object Detection and Tracking API و یک پشتیبان جستجوی محصول آزمایشی ساخته شده با Vision API Product Search استفاده می کند تا به کاربران اجازه دهد عکس بگیرند و محصولات مشابه بصری را در کاتالوگ محصولات نمایشی جستجو کنند.
برنامه را به اندروید استودیو وارد کنید
با وارد کردن برنامه شروع به Android Studio شروع کنید.
به Android Studio بروید، Import Project (Gradle، Eclipse ADT، و غیره) را انتخاب کنید و پوشه product-search/codelab2/android/final را از کد منبعی که قبلا دانلود کردید انتخاب کنید.
برنامه استارتر را اجرا کنید
اکنون که پروژه را به اندروید استودیو وارد کرده اید، برای اولین بار آماده اجرای برنامه هستید.
دستگاه اندروید خود را از طریق USB به هاست خود وصل کنید یا شبیه ساز Android Studio را راه اندازی کنید و روی Run کلیک کنید ( 
) در نوار ابزار Android Studio.
(اگر این دکمه غیرفعال است، مطمئن شوید که فقط final/app/build.gradle را وارد کرده اید، نه کل مخزن.)
اکنون برنامه باید روی دستگاه اندرویدی شما راه اندازی می شد. این در حال حاضر کار می کند، اما از پشتیبان جستجوی محصول آزمایشی استفاده می کند که Google برای شما قرار داده است.
در مرحله بعد، برنامه را به‌روزرسانی می‌کنید تا از پشتیبان‌هایی که قبلاً در این لبه کد ساخته‌اید استفاده کند.
6. نقاط پایانی API را به روز کنید
تنظیمات API را تغییر دهید
به کلاس 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 نقطه پایانی API Cloud Vision API است.
- VISION_API_KEY کلید API است که قبلاً در این کد لبه ایجاد کردید.
- VISION_API_PROJECT_ID ، VISION_API_LOCATION_ID ، VISION_API_PRODUCT_SET_ID مقداری است که در شروع سریع Vision API Product Search قبلاً در این Codelab استفاده کردید.
آن را اجرا کنید
حالا روی Run کلیک کنید ( ) در نوار ابزار Android Studio. پس از بارگیری برنامه، روی هر تصویر از پیش تعیین شده ضربه بزنید، یک شی شناسایی شده را انتخاب کنید، روی دکمه جستجو ضربه بزنید تا نتایج جستجو را ببینید. این برنامه اکنون از پشتیبان جستجوی محصول استفاده می کند که شما به تازگی ایجاد کرده اید!
7. تبریک می گویم!
شما یاد گرفته اید که چگونه با استفاده از جستجوی محصول Vision API یک پشتیبان جستجوی محصول بسازید.
این تمام چیزی است که برای راه اندازی آن نیاز دارید!
آنچه را پوشش داده ایم
- چگونه با استفاده از کاتالوگ محصول و جستجوی محصول Vision API، باطن جستجوی محصول ایجاد کنیم
- نحوه تنظیم کلید API برای فراخوانی باطن جستجوی محصول از یک برنامه تلفن همراه
- نحوه تماس با باطن از یک برنامه تلفن همراه
مراحل بعدی
- این ویدیو را در مورد استفاده از Vision API Product Search برای ساخت کمد هوشمند تماشا کنید
- مسیر یادگیری ML جستجوی محصول را در دستگاه بررسی کنید تا تمام مراحل لازم برای ایجاد جستجوی محصول را بیاموزید
- آنچه را که آموخته اید در اپلیکیشن خود به کار ببرید