अपने ऐप से Google क्लाउड एपीआई को कॉल करने के लिए, आपको एक इंटरमीडिएट रेस्ट एपीआई बनाना होगा जो प्राधिकरण को संभालता है और एपीआई कुंजियों जैसे गुप्त मूल्यों की सुरक्षा करता है। इसके बाद आपको इस इंटरमीडिएट सेवा को प्रमाणित करने और उससे संचार करने के लिए अपने मोबाइल ऐप में कोड लिखना होगा।
इस REST API को बनाने का एक तरीका फायरबेस ऑथेंटिकेशन एंड फंक्शंस का उपयोग करना है, जो आपको Google क्लाउड एपीआई के लिए एक प्रबंधित, सर्वर रहित गेटवे देता है जो प्रमाणीकरण को संभालता है और पूर्व-निर्मित एसडीके के साथ आपके मोबाइल ऐप से कॉल किया जा सकता है।
यह मार्गदर्शिका दर्शाती है कि अपने ऐप से क्लाउड विज़न API को कॉल करने के लिए इस तकनीक का उपयोग कैसे करें। यह विधि सभी प्रमाणित उपयोगकर्ताओं को आपके क्लाउड प्रोजेक्ट के माध्यम से क्लाउड विज़न बिल की गई सेवाओं तक पहुँचने की अनुमति देगी, इसलिए आगे बढ़ने से पहले विचार करें कि क्या यह प्रमाणीकरण तंत्र आपके उपयोग के मामले के लिए पर्याप्त है।
शुरू करने से पहले
अपना प्रोजेक्ट कॉन्फ़िगर करें
यदि आपने पहले से ही अपने ऐप में Firebase नहीं जोड़ा है, तो आरंभ करने की मार्गदर्शिका में दिए गए चरणों का पालन करके ऐसा करें।फायरबेस निर्भरताओं को स्थापित और प्रबंधित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।
- Xcode में, अपने ऐप प्रोजेक्ट को खोलने के साथ, File > Add Packages पर नेविगेट करें।
- संकेत दिए जाने पर, Firebase Apple प्लेटफ़ॉर्म SDK रिपॉजिटरी जोड़ें:
- फायरबेस एमएल लाइब्रेरी चुनें।
- समाप्त होने पर, Xcode स्वचालित रूप से पृष्ठभूमि में आपकी निर्भरताओं को हल करना और डाउनलोड करना शुरू कर देगा।
https://github.com/firebase/firebase-ios-sdk
अगला, कुछ इन-ऐप सेटअप करें:
- अपने ऐप में, फायरबेस आयात करें:
तीव्र
import FirebaseMLModelDownloader
उद्देश्य सी
@import FirebaseMLModelDownloader;
कुछ और कॉन्फ़िगरेशन चरण, और हम जाने के लिए तैयार हैं:
यदि आपने अपने प्रोजेक्ट के लिए क्लाउड-आधारित API को पहले से सक्षम नहीं किया है, तो अभी ऐसा करें:
- Firebase कंसोल का Firebase ML APIs पेज खोलें।
यदि आपने अपने प्रोजेक्ट को ब्लेज़ प्राइसिंग प्लान में पहले से अपग्रेड नहीं किया है, तो ऐसा करने के लिए अपग्रेड पर क्लिक करें। (आपको केवल तभी अपग्रेड करने के लिए कहा जाएगा यदि आपका प्रोजेक्ट ब्लेज़ योजना पर नहीं है।)
केवल ब्लेज़-स्तरीय परियोजनाएँ ही क्लाउड-आधारित API का उपयोग कर सकती हैं।
- यदि क्लाउड-आधारित API पहले से सक्षम नहीं हैं, तो क्लाउड-आधारित API सक्षम करें पर क्लिक करें।
- क्लाउड विजन एपीआई तक पहुंच को अस्वीकार करने के लिए अपनी मौजूदा फायरबेस एपीआई कुंजियां कॉन्फ़िगर करें:
- क्लाउड कंसोल का क्रेडेंशियल पेज खोलें।
- सूची में प्रत्येक API कुंजी के लिए, संपादन दृश्य खोलें, और कुंजी प्रतिबंध अनुभाग में, क्लाउड विज़न API को छोड़कर सभी उपलब्ध API को सूची में जोड़ें।
कॉल करने योग्य फ़ंक्शन को परिनियोजित करें
इसके बाद, क्लाउड फ़ंक्शन को परिनियोजित करें जिसका उपयोग आप अपने ऐप और क्लाउड विज़न एपीआई को ब्रिज करने के लिए करेंगे। functions-samples
रिपॉजिटरी में एक उदाहरण है जिसका आप उपयोग कर सकते हैं।
डिफ़ॉल्ट रूप से, इस फ़ंक्शन के माध्यम से क्लाउड विज़न एपीआई तक पहुँचने से आपके ऐप के केवल प्रमाणित उपयोगकर्ता ही क्लाउड विज़न एपीआई तक पहुँच पाएंगे। आप विभिन्न आवश्यकताओं के लिए फ़ंक्शन को संशोधित कर सकते हैं।
समारोह को तैनात करने के लिए:
- फ़ंक्शंस-नमूने रेपो को क्लोन या डाउनलोड करें और
vision-annotate-image
डायरेक्टरी में बदलें:git clone https://github.com/firebase/functions-samples
cd vision-annotate-image
- निर्भरताएँ स्थापित करें:
cd functions
npm install
cd ..
- अगर आपके पास फायरबेस सीएलआई नहीं है, तो इसे इंस्टॉल करें ।
-
vision-annotate-image
डायरेक्टरी में फायरबेस प्रोजेक्ट को इनिशियलाइज़ करें। संकेत मिलने पर, सूची में अपना प्रोजेक्ट चुनें।firebase init
- कार्य परिनियोजित करें:
firebase deploy --only functions:annotateImage
अपने ऐप में फायरबेस प्रमाणीकरण जोड़ें
ऊपर तैनात कॉल करने योग्य फ़ंक्शन आपके ऐप के गैर-प्रमाणीकृत उपयोगकर्ताओं के किसी भी अनुरोध को अस्वीकार कर देगा। यदि आपने पहले से ऐसा नहीं किया है, तो आपको अपने ऐप में Firebase प्रमाणीकरण जोड़ना होगा।
अपने ऐप में आवश्यक निर्भरताएँ जोड़ें
फायरबेस लाइब्रेरी के लिए क्लाउड फ़ंक्शंस स्थापित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।
1. इनपुट इमेज तैयार करें
क्लाउड विजन को कॉल करने के लिए, छवि को बेस 64-एन्कोडेड स्ट्रिंग के रूप में स्वरूपित किया जाना चाहिए।UIImage
को संसाधित करने के लिए:तीव्र
guard let imageData = uiImage.jpegData(compressionQuality: 1.0f) else { return } let base64encodedImage = imageData.base64EncodedString()
उद्देश्य सी
NSData *imageData = UIImageJPEGRepresentation(uiImage, 1.0f); NSString *base64encodedImage = [imageData base64EncodedStringWithOptions:NSDataBase64Encoding76CharacterLineLength];
2. लैंडमार्क को पहचानने के लिए कॉल करने योग्य फ़ंक्शन को प्रारंभ करें
किसी छवि में लैंडमार्क की पहचान करने के लिए, JSON क्लाउड विज़न अनुरोध पास करने वाले कॉल करने योग्य फ़ंक्शन को इनवॉइस करें।सबसे पहले, क्लाउड फ़ंक्शंस का एक उदाहरण आरंभ करें:
तीव्र
lazy var functions = Functions.functions()
उद्देश्य सी
@property(strong, nonatomic) FIRFunctions *functions;
LANDMARK_DETECTION
पर टाइप सेट के साथ एक अनुरोध बनाएं:तीव्र
let requestData = [ "image": ["content": base64encodedImage], "features": ["maxResults": 5, "type": "LANDMARK_DETECTION"] ]
उद्देश्य सी
NSDictionary *requestData = @{ @"image": @{@"content": base64encodedImage}, @"features": @{@"maxResults": @5, @"type": @"LANDMARK_DETECTION"} };
अंत में, फ़ंक्शन का आह्वान करें:
तीव्र
functions.httpsCallable("annotateImage").call(requestData) { (result, error) in if let error = error as NSError? { if error.domain == FunctionsErrorDomain { let code = FunctionsErrorCode(rawValue: error.code) let message = error.localizedDescription let details = error.userInfo[FunctionsErrorDetailsKey] } // ... } // Function completed succesfully }
उद्देश्य सी
[[_functions HTTPSCallableWithName:@"annotateImage"] callWithObject:requestData completion:^(FIRHTTPSCallableResult * _Nullable result, NSError * _Nullable error) { if (error) { if (error.domain == FIRFunctionsErrorDomain) { FIRFunctionsErrorCode code = error.code; NSString *message = error.localizedDescription; NSObject *details = error.userInfo[FIRFunctionsErrorDetailsKey]; } // ... } // Function completed succesfully // Get information about labeled objects }];
3. मान्यता प्राप्त स्थलों के बारे में जानकारी प्राप्त करें
यदि लैंडमार्क रिकग्निशन ऑपरेशन सफल होता है, तो कार्य के परिणाम में BatchAnnotateImagesResponse की JSON प्रतिक्रिया वापस आ जाएगी। landmarkAnnotations
एरे में प्रत्येक वस्तु एक लैंडमार्क का प्रतिनिधित्व करती है जिसे छवि में पहचाना गया था। प्रत्येक लैंडमार्क के लिए, आप इनपुट छवि में उसके बाउंडिंग निर्देशांक, लैंडमार्क का नाम, उसका अक्षांश और देशांतर, उसकी नॉलेज ग्राफ़ इकाई आईडी (यदि उपलब्ध हो), और मैच का विश्वास स्कोर प्राप्त कर सकते हैं। उदाहरण के लिए:
तीव्र
if let labelArray = (result?.data as? [String: Any])?["landmarkAnnotations"] as? [[String:Any]] {
for labelObj in labelArray {
let landmarkName = labelObj["description"]
let entityId = labelObj["mid"]
let score = labelObj["score"]
let bounds = labelObj["boundingPoly"]
// Multiple locations are possible, e.g., the location of the depicted
// landmark and the location the picture was taken.
guard let locations = labelObj["locations"] as? [[String: [String: Any]]] else { continue }
for location in locations {
let latitude = location["latLng"]?["latitude"]
let longitude = location["latLng"]?["longitude"]
}
}
}
उद्देश्य सी
NSArray *labelArray = result.data[@"landmarkAnnotations"];
for (NSDictionary *labelObj in labelArray) {
NSString *landmarkName = labelObj[@"description"];
NSString *entityId = labelObj[@"mid"];
NSNumber *score = labelObj[@"score"];
NSArray *bounds = labelObj[@"boundingPoly"];
// Multiple locations are possible, e.g., the location of the depicted
// landmark and the location the picture was taken.
NSArray *locations = labelObj[@"locations"];
for (NSDictionary *location in locations) {
NSNumber *latitude = location[@"latLng"][@"latitude"];
NSNumber *longitude = location[@"latLng"][@"longitude"];
}
}