1. Başlamadan önce
Ürün resmi araması öğrenme yolunun başlarında, Vision API Product Search ile oluşturulmuş bir ürün arama arka ucunu nasıl çağıracağınızı öğrendiniz.
Bu codelab'de, ürün kataloğunuzda benzer bir arka uç oluşturmayı öğreneceksiniz.
Neler öğreneceksiniz?
- Vision API Product Search ile ürün arama arka ucu oluşturma
- Mobil uygulamalardan Vision API'ye erişmek için API anahtarı ayarlama
Gerekenler
- Faturalandırmanın etkin olduğu bir Google Cloud hesabı (Ücretsiz deneme hesabı olabilir)
2. Vision API Ürün Araması Hakkında
Google Cloud'daki Vision API Product Search özelliği, perakendecilerin ürün oluşturmasına olanak tanıyan bir özelliktir. Bu özelliklerin her biri, ürünü bir dizi bakış açısıyla görsel olarak açıklayan referans resimler içerir. Ardından perakendeciler bu ürünleri ürün gruplarına ekleyebilir. Vision API Product Search şu anda şu ürün kategorilerini desteklemektedir: ev eşyaları, giyim, oyuncaklar, ambalajlı ürünler ve genel.
Kullanıcılar ürün resimlerini kendi resimleriyle sorguladığında Vision API Ürün Arama, kullanıcının sorgu resmindeki ürünü perakendecinin ürün kümesindeki resimlerle karşılaştırmak için makine öğrenimini uygular ve ardından, görsel ve semantik olarak benzer sonuçların sıralı listesini döndürür.
3. Google Cloud ile arka uç oluşturma
Ürün görsel araması öğrenme yolunun öncesinde, Vision API Ürün Arama ile oluşturulan bir demo ürün arama arka ucunu kullanıyordunuz. Bu eğitimi izleyerek Google Cloud hesabınızda aynı arka ucu oluşturun:
Eğitimi tamamladıktan sonra, mobil uygulamalarınızdan arka ucu çağıracak API anahtarı oluşturmak için aşağıdaki adımlarla devam edin.
4. API anahtarı kurulumu
Vision API Product Search hızlı başlangıç kılavuzunda, sorgu resmini alıp görsel olarak benzer ürünleri döndürebilen bir ürün arama arka ucu oluşturdunuz. Bir mobil uygulamadan ürün arama API'sini çağırmak için bir API anahtarı oluşturmanız ve daha sonra yetkisiz kullanımı önlemek için API anahtarının kendi mobil uygulamalarınıza erişimini kısıtlamanız gerekir.
API anahtarı oluşturma
- Cloud Console > API'ler & Hizmetleri > Kimlik Bilgileri bölümüne gidin. Ayrıca, bu URL'yi tıklayıp Product Search hızlı başlangıç kılavuzunda kullandığınız projeyi seçebilirsiniz.
- Kimlik Bilgileri Oluştur > API anahtarı'nı seçin. API anahtarınız başarıyla oluşturulduysa bu iletişim kutusunu görürsünüz:
Bu API anahtarını not edin. Bu kodu daha sonra bu codelab'de kullanacaksınız.
API anahtarına erişimi kısıtlama
Yukarıdaki istemi gördüğünüzde Anahtarı kısıtla'yı seçin.
Bu kısıtlamaları uygulamak için ekrandaki talimatları uygulayın:
- Uygulama kısıtlamaları > Android uygulamaları
- API kısıtlamaları > Anahtarı kısıtla ve > Cloud Vision API
5. Mobil uygulamayı indirme ve çalıştırma
Demo ürün arama arka ucunu kullanan daha önce oluşturduğunuz Android uygulamasını indirebilir ve yeni oluşturduğunuz arka ucu kullanacak şekilde değiştirebilirsiniz.
Kodu İndirme
Bu codelab'in tüm kodunu indirmek için aşağıdaki bağlantıyı tıklayın:
İndirilen ZIP dosyasını paketten çıkarın. Bu, ihtiyaç duyacağınız tüm kaynaklarla bir kök klasörün (odml-pathway-codelabs) paketini açar. Bu codelab için yalnızca product-search/codelab2/android/final alt dizinindeki kaynaklara ihtiyacınız olacaktır.
Uygulama, kullanıcıların fotoğraf çekip demo ürün kataloğunda görsel olarak benzer ürünleri aramasına olanak tanımak için ML Kit Nesne Algılama ve İzleme API'si ile Vision API Ürün Arama ile oluşturulmuş bir demo ürün arama arka ucu kullanır.
Uygulamayı Android Studio'ya aktarın
Starter uygulamasını Android Studio'ya içe aktararak başlayın.
Android Studio'ya gidin, Projeyi İçe Aktar (Gradle, Eclipse ADT vb.) seçeneğini belirleyin ve daha önce indirdiğiniz kaynak kodundan product-search/codelab2/android/final klasörünü seçin.
Starter uygulamasını çalıştırma
Projeyi Android Studio'ya aktardığınıza göre, uygulamayı ilk kez çalıştırmaya hazırsınız.
Android cihazınızı USB üzerinden barındırıcınıza bağlayın veya Android Studio emülatörünü başlatın ve Android Studio araç çubuğundan Çalıştır'ı ( 
) tıklayın.
(Bu düğme devre dışı bırakılırsa kod deposunun tamamını değil, yalnızca final/app/build.gradle dosyasını içe aktardığınızdan emin olun.)
Artık uygulamanın Android cihazınızda başlatılması gerekir. Halihazırda çalışır ancak Google'ın sizin için dağıttığı demo ürün arama arka ucunu kullanır.
Daha sonra, uygulamayı bu codelab'de daha önce oluşturduğunuz arka ucu kullanacak şekilde güncelleyeceksiniz.
6. API uç noktalarını güncelleme
API yapılandırmalarını değiştirme
ProductSearchAPIClient sınıfına gidin. Önceden tanımlanmış ürün arama arka ucunun yapılandırmalarını görürsünüz. Demo arka ucunun yapılandırmalarına açıklama ekleyin:
// 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"
Ardından bunları, kendi yapılandırmanızla değiştirin:
// 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 API'nin API uç noktasıdır.
- VISION_API_KEY, bu codelab'de daha önce oluşturduğunuz API anahtarıdır.
- VISION_API_PROJECT_ID, VISION_API_LOCATION_ID, VISION_API_PRODUCT_set_ID, bu codelab'in başlarında Vision API Ürün Arama'da hızlı başlangıç kılavuzunda kullandığınız değerdir.
Çalıştır
Şimdi Android Studio araç çubuğunda Çalıştır'ı () tıklayın. Uygulama yüklendiğinde, hazır resimlerden birine dokunun, algılanan bir nesneyi seçin, arama sonuçlarını görmek için Ara düğmesine dokunun. Uygulama, az önce oluşturduğunuz ürün arama arka ucunu kullanıyor.
7. Tebrikler!
Vision API Product Search'ü kullanarak ürün arama arka ucu oluşturmayı öğrendiniz.
Kullanmaya başlamak için ihtiyacınız olan tek şey bu.
Değindiğimiz konular
- Ürün kataloğunuzu ve Vision API Product Search'ü kullanarak ürün arama arka ucu oluşturma
- Bir mobil uygulamadan ürün arama arka ucunu çağırmak için API anahtarını ayarlama
- Mobil uygulamadan arka uç nasıl çağrılır?
Sonraki Adımlar
- Akıllı dolap oluşturmak için Vision API Product Search'ü kullanma hakkında bu videoyu izleyin.
- Ürün arama oluşturmak için gereken tüm adımları öğrenmek üzere Google Product Search'te cihaz üzerinde makine öğrenimi öğrenme yoluna göz atın
- Öğrendiklerinizi kendi uygulamanızda uygulayın