1. Zanim zaczniesz
Wcześniej omówiliśmy, jak wywoływać funkcję wyszukiwania produktów utworzoną na podstawie interfejsu Vision API Product Search dla podobnych wizualnie produktów z katalogu.
Z tego modułu ćwiczeń dowiesz się, jak stworzyć podobny backend za pomocą katalogu produktów.
Czego się nauczysz:
- Jak utworzyć backend wyszukiwania produktów za pomocą Vision API Search
- Jak skonfigurować klucz interfejsu API, aby mieć dostęp do interfejsu Vision API z aplikacji mobilnych
Czego potrzebujesz
- konto Google Cloud z włączonymi rozliczeniami (może to być bezpłatne konto próbne);
2. Wyszukiwanie produktów Vision API
Wyszukiwarka produktów Vision API to funkcja w Google Cloud umożliwiająca sprzedawcom tworzenie produktów, z których każdy zawiera obrazy referencyjne, które najlepiej opisują produkt z punktu widzenia użytkownika. Sprzedawcy mogą następnie dodać te produkty do zestawów produktów. Obecnie wyszukiwarka produktów Vision API obsługuje następujące kategorie produktów: artykuły gospodarstwa domowego, odzież, zabawki, produkty pakowane oraz ogólnie.
Gdy użytkownicy wyszukują informacje o produkcie za pomocą własnych zdjęć, wyszukiwarka produktów z interfejsem Vision API stosuje systemy uczące się do porównywania produktu ze zdjęciami użytkownika w zestawie produktów, a następnie zwraca listę wyników podobną do wizualnej i semantycznej.
3. Tworzenie backendu z Google Cloud
Wcześniej na ścieżce szkoleniowej dotyczącej wyszukiwania grafiki produktu użyliśmy backendu demonstracji wyszukiwania produktów z interfejsem Vision API Product Search. Skorzystaj z tego samouczka, aby stworzyć taki sam backend na swoim koncie Google Cloud:
Po ukończeniu samouczka przejdź do kolejnych kroków, aby skonfigurować klucz interfejsu API, aby wywoływać backend z aplikacji mobilnych.
4. Skonfiguruj klucz interfejsu API
W krótkim wprowadzeniu do interfejsu wyszukiwania produktów w interfejsie Vision API udało Ci się utworzyć backend wyszukiwania produktów, który może pobierać obraz zapytania i zwracać podobne produkty. Aby wywołać interfejs API wyszukiwania produktów z aplikacji mobilnej, musisz skonfigurować klucz interfejsu API, a następnie ograniczyć dostęp do interfejsu do swoich aplikacji mobilnych.
Tworzenie klucza interfejsu API
- Otwórz Cloud Console > Interfejsy API & Usługi > Dane logowania. Możesz też kliknąć URL i wybrać projekt użyty w krótkim wprowadzeniu w wyszukiwarce produktów.
- Wybierz Create Credentials (Utwórz dane logowania) > API key (Klucz interfejsu API). Jeśli klucz interfejsu API został utworzony:
Zapisz ten klucz interfejsu API. Użyjesz jej później w ćwiczeniach z programowania.
Ograniczanie dostępu do klucza interfejsu API
Gdy pojawi się komunikat, wybierz Ogranicz klucz.
Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, by zastosować te ograniczenia:
- Ograniczenia aplikacji > aplikacje na Androida
- Ograniczenia interfejsu API > Ogranicz klucz > Cloud Vision API
5. Pobieranie i uruchamianie aplikacji mobilnej
Możesz pobrać utworzoną aplikację na Androida wcześniej, która korzystała z backendu demonstracyjnego produktu, i zmienić ją, aby korzystać z nowo utworzonego backendu.
Pobieranie kodu
Aby pobrać cały kod do tych ćwiczeń z programowania, kliknij ten link:
Rozpakuj pobrany plik ZIP. Spowoduje to rozpakowanie folderu głównego (odml-pathway-codelabs) ze wszystkimi potrzebnymi zasobami. W przypadku tych ćwiczeń potrzebujesz tylko źródeł w podkatalogu product-search/codelab2/android/final.
Aplikacja wykorzystuje interfejs API wykrywania i śledzenia obiektów ML Kit oraz backend prezentacji produktu wzbogacony o funkcje Vision API Search, które pozwalają użytkownikom robić zdjęcia i wyszukiwać podobne produkty w katalogu produktów demonstracyjnych.
Importowanie aplikacji do Android Studio
Najpierw zaimportuj aplikację starter do Android Studio.
Otwórz Androida Studio, wybierz Importuj projekt (Gradle, Eclipse ADT itp.) i wybierz folder product-search/codelab2/android/final z pobranego wcześniej kodu źródłowego.
Uruchamianie aplikacji startowej
Po zaimportowaniu projektu do Android Studio możesz uruchomić aplikację po raz pierwszy.
Połącz urządzenie z Androidem przez USB z hostem lub uruchom emulator Androida Studio i kliknij Uruchom (
) na pasku narzędzi Android Studio.
(Jeśli ten przycisk jest wyłączony, upewnij się, że importujesz tylko pliki końcowe/app/build.gradle, a nie całe repozytorium).
Teraz aplikacja powinna pojawić się na urządzeniu z Androidem. Obecnie działa, ale korzysta z backendu demonstracyjnego, który został wdrożony przez Google.
Następnie zaktualizuj aplikację tak, aby używała Twojego backendu z ćwiczeniami z programowania.
6. Aktualizowanie punktów końcowych interfejsu API
Zmienianie konfiguracji interfejsu API
Przejdź do klasy ProductSearchAPIClient, by zobaczyć konfiguracje backendu Wyszukiwarki produktów. Dodaj komentarz do konfiguracji backendu demonstracyjnego:
// 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"
Następnie zastąp je konfiguracją:
// 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 to punkt końcowy interfejsu API Cloud Vision.
- VISION_API_KEY to klucz interfejsu API utworzony wcześniej w tym ćwiczeniu.
- VISION_API_PROJECT_ID , VISION_API_LOCATION_ID , VISION_API_PRODUCT_SET_ID to wartość używana w krótkim wprowadzeniu do ćwiczenia z interfejsu Vision API w wyszukiwarce produktów.
Uruchom
Kliknij Uruchom () na pasku narzędzi Androida Studio. Po załadowaniu aplikacji kliknij dowolny gotowy obraz, wybierz wykryty obiekt i kliknij przycisk Szukaj, by zobaczyć wyniki wyszukiwania. Ta aplikacja używa właśnie utworzonego backendu usługi wyszukiwania produktów.
7. Gratulacje!
Wiesz już, jak stworzyć backend do wyszukiwarki produktów za pomocą usługi Product Vision API.
To wszystko, czego potrzebujesz, aby zacząć korzystać z usługi!
Omawiane zagadnienia
- Jak utworzyć backend wyszukiwania produktów za pomocą katalogu produktów i wyszukiwarki produktów Vision API
- Jak skonfigurować klucz interfejsu API, aby wywołać backend wyszukiwarki produktów z aplikacji mobilnej
- Jak wywołać backend z aplikacji mobilnej
Następne kroki
- Obejrzyj ten film o tworzeniu inteligentnej szafy za pomocą wyszukiwarki produktów Vision API.
- Wypróbuj ścieżkę szkoleniową dotyczącą ML w wyszukiwarce na urządzeniu, aby poznać wszystkie kroki niezbędne do utworzenia wyszukiwania produktów
- Stosuj nabytą wiedzę w swojej aplikacji