1. לפני שמתחילים
בשלב מוקדם יותר במסלול הנתיב של חיפוש תמונות על המוצר, למדנו איך לקרוא לקצה העורפי שמבצע חיפוש מוצרים על סמך חיפוש מוצרים של Vision API עבור מוצרים דומים מבחינה חזותית מקטלוג מוצרים.
בשיעור Lab זה תלמדו איך ליצור קצה עורפי דומה, אבל עם קטלוג המוצרים שלכם.
מה תלמדו
- איך ליצור קצה עורפי לחיפוש מוצרים באמצעות Vision Product Search
- איך להגדיר מפתח API כדי לגשת ל-Vision API מאפליקציות לנייד
מה צריך?
- חשבון Google Cloud שהופעל בו חיוב (הוא יכול להיות חשבון של תקופת ניסיון בחינם)
2. מידע על Vision Product Search
Vision API של חיפוש מוצרים הוא תכונה ב-Google Cloud שמאפשרת לקמעונאים ליצור מוצרים, ולכל אחד מהם יש תמונות עזר שמתארות את המוצר באופן חזותי מתוך קבוצה של נקודות מבט. לאחר מכן, הקמעונאים יכולים להוסיף את המוצרים האלה לקבוצות מוצרים. בשלב זה, חיפוש המוצרים של Vision API תומך בקטגוריות המוצרים הבאות: מוצרי בית, ביגוד, צעצועים, מוצרים ארוזים וכלל.
כשמשתמשים מבצעים שאילתה על קבוצת מוצרים עם תמונות משלהם, ממשק ה-API של חיפוש המוצרים שלVision מחיל למידה חישובית כדי להשוות את המוצר בתמונת השאילתה של המשתמש לבין התמונות בקבוצת המוצרים של הקמעונאי. לאחר מכן הוא מחזיר רשימה מדורגת של תוצאות דומות מבחינה סמנטית.
3. שימוש בקצה העורפי באמצעות Google Cloud
מוקדם יותר במסלול של 'חיפוש תמונות של מוצר', השתמשת בקצה העורפי של חיפוש המוצרים ב-Vision עם חיפוש מוצרים ב-Vision API. המדריך הזה יעזור לכם לבנות את אותו קצה העורפי בחשבון Google Cloud שלכם:
לאחר השלמת המדריך, יש להמשיך בשלבים הבאים כדי להגדיר מפתח API כדי לקרוא לקצה העורפי מהאפליקציות לנייד.
4. הגדרת מפתח API
בתצוגה המקדימה של חיפוש מוצרים ב-Vision API, יצרתם קצה עורפי בחיפוש מוצרים שיכול לצלם תמונת שאילתה ולהחזיר מוצרים דומים מבחינה חזותית. כדי לקרוא ל-API של חיפוש המוצרים דרך אפליקציה לנייד, עליכם להגדיר מפתח API ולאחר מכן להגביל את הגישה למפתח ה-API לאפליקציות שלכם לנייד, כדי להימנע משימוש ללא הרשאה.
יצירת מפתח API
- נכנסים אל Cloud Console > APIs & Services > Credentials. אפשר גם ללחוץ על כתובת ה-URL הזו ולבחור את הפרויקט שבו השתמשתם בהתחלת תהליך החיפוש של מוצר.
- בוחרים באפשרות Create Credentials (יצירת פרטי כניסה) >. מפתח API (מפתח API). תיבת הדו-שיח הזו מוצגת אם מפתח ה-API שלכם נוצר בהצלחה:
כדאי לשים לב למפתח ה-API הזה. תשתמשו בו מאוחר יותר במעבדת קוד זו.
הגבלת הגישה למפתח ה-API
כשמוצגת ההודעה למעלה, בוחרים באפשרות הגבלת מקש.
פועלים לפי ההוראות במסך כדי להחיל את ההגבלות הבאות:
- הגבלות אפליקציות > אפליקציות Android
- מגבלות API > הגבלת מפתח > Cloud Vision API
5. הורדה והפעלה של אפליקציה לנייד
אתם יכולים להוריד את האפליקציה ל-Android שיצרתם מוקדם יותר והשתמשה בקצה העורפי של חיפוש המוצרים לדוגמה, ולשנות אותה כך שהיא תשתמש בקצה העורפי החדש שיצרתם.
להורדת הקוד
כדי להוריד את כל הקוד של Lablab זה, צריך ללחוץ על הקישור הבא:
פותחים את הקובץ הדחוס. פעולה זו תשחרר תיקיית שורש (odml-pathway-codelabs) עם כל המשאבים הנחוצים. ב-codelab זה תצטרכו את המקורות רק בספריית המשנה product-search/codelab2/android/final.
האפליקציה משתמשת ב-ML Kit Object Objecting and Tracking API, ובקצה עורף של חיפוש הדגמה של מוצרים, עם Vision API Product Search, שמאפשר למשתמשים לצלם תמונות ולחפש מוצרים דומים מבחינה חזותית בקטלוג המוצרים של ההדגמה.
ייבוא האפליקציה ל-Android Studio
בשלב הראשון, מייבאים את האפליקציה Starter אל Android Studio.
עוברים ל-Android Studio, בוחרים באפשרות ייבוא פרויקט (גראדל, Eclipse ADT וכו') ובוחרים את התיקייה product-search/codelab2/android/final בקוד המקור שהורדתם קודם.
הפעלת האפליקציה למתחילים
עכשיו, אחרי שייבאתם את הפרויקט ל-Android Studio, אתם מוכנים להריץ את האפליקציה בפעם הראשונה.
מחברים את מכשיר ה-Android באמצעות USB למארח או מתחילים את האמולטור של Android Studio,ולוחצים על הפעלה ( 
) בסרגל הכלים של Android Studio.
(אם הלחצן הזה מושבת, חשוב לייבא רק את הנתונים הסופיים/app/build.gradle, ולא את כל המאגר).
עכשיו האפליקציה אמורה לפעול במכשיר Android שלכם. הוא כבר פועל, אבל הוא משתמש בקצה העורפי של חיפוש המוצרים ש-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 שיצרתם מוקדם יותר ב-codelab הזה.
- VISION_API_PROJECT_ID , VISION_API_LOCATION_ID , VISION_API_PRODUCT_SET_ID הוא הערך שבו השתמשתם ב-Vision API של חיפוש מוצרים בשלב מוקדם יותר במעבד הקוד הזה.
להפעלה
עכשיו לוחצים על הפעלה () בסרגל הכלים של Android Studio. אחרי שהאפליקציה נטענת, מקישים על תמונה מוגדרת מראש, בוחרים אובייקט שזוהה, מקישים על הלחצן חיפוש כדי להציג את תוצאות החיפוש. האפליקציה משתמשת עכשיו בקצה העורפי של חיפוש המוצרים שיצרת עכשיו.
7. מעולה!
למדת איך ליצור קצה עורפי לחיפוש מוצרים באמצעות Vision Product Search.
זה כל מה שצריך לעשות כדי להתחיל לעבוד.
באילו נושאים מדובר?
- איך ליצור קצה עורפי לחיפוש מוצרים באמצעות קטלוג המוצרים ו-Vision API של חיפוש מוצרים
- איך להגדיר מפתח API כדי להתקשר בקצה העורפי של חיפוש מוצרים מאפליקציה לנייד
- איך להתקשר לקצה העורפי מאפליקציה לנייד
השלבים הבאים
- כדאי לצפות בסרטון הזה על השימוש ב-Vision Product Search כדי ליצור ארון חכם
- רוצים לדעת איך אנחנו עושים את כל הפעולות הנדרשות לחיפוש מוצר? לשם כך צריך לעיין במסלול הלימוד של הלמידה החישובית במכשיר, שבו מוסבר איך עושים את זה
- מיישמים את מה שלמדתם באפליקציה