ऐप्पल प्लेटफॉर्म पर फायरबेस ऑथ और फंक्शन्स का उपयोग करके क्लाउड विजन के साथ सुरक्षित रूप से लैंडमार्क को पहचानें

अपने ऐप से Google क्लाउड एपीआई को कॉल करने के लिए, आपको एक मध्यवर्ती आरईएसटी एपीआई बनाना होगा जो प्राधिकरण को संभालता है और एपीआई कुंजी जैसे गुप्त मूल्यों की रक्षा करता है। फिर आपको इस मध्यवर्ती सेवा को प्रमाणित करने और उसके साथ संचार करने के लिए अपने मोबाइल ऐप में कोड लिखना होगा।

इस आरईएसटी एपीआई को बनाने का एक तरीका फायरबेस प्रमाणीकरण और कार्यों का उपयोग करना है, जो आपको Google क्लाउड एपीआई के लिए एक प्रबंधित, सर्वर रहित गेटवे देता है जो प्रमाणीकरण को संभालता है और पूर्व-निर्मित एसडीके के साथ आपके मोबाइल ऐप से कॉल किया जा सकता है।

यह मार्गदर्शिका दर्शाती है कि अपने ऐप से क्लाउड विज़न एपीआई को कॉल करने के लिए इस तकनीक का उपयोग कैसे करें। यह विधि सभी प्रमाणित उपयोगकर्ताओं को आपके क्लाउड प्रोजेक्ट के माध्यम से क्लाउड विजन बिल की गई सेवाओं तक पहुंचने की अनुमति देगी, इसलिए आगे बढ़ने से पहले विचार करें कि क्या यह प्रमाणीकरण तंत्र आपके उपयोग के मामले के लिए पर्याप्त है।

शुरू करने से पहले

अपना प्रोजेक्ट कॉन्फ़िगर करें

यदि आपने पहले से अपने ऐप में Firebase नहीं जोड़ा है, तो आरंभ करने की मार्गदर्शिका में दिए गए चरणों का पालन करके ऐसा करें।

फायरबेस निर्भरता को स्थापित और प्रबंधित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।

  1. Xcode में, आपका ऐप प्रोजेक्ट खुला होने के साथ, File > Add Packages पर नेविगेट करें।
  2. संकेत मिलने पर, Firebase Apple प्लेटफॉर्म्स SDK रिपॉजिटरी जोड़ें:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. फायरबेस एमएल लाइब्रेरी चुनें।
  5. समाप्त होने पर, Xcode स्वचालित रूप से पृष्ठभूमि में आपकी निर्भरता को हल करना और डाउनलोड करना शुरू कर देगा।

इसके बाद, कुछ इन-ऐप सेटअप करें:

  1. अपने ऐप्लिकेशन में, Firebase आयात करें:

    तीव्र

    import FirebaseMLModelDownloader

    उद्देश्य सी

    @import FirebaseMLModelDownloader;

कुछ और कॉन्फ़िगरेशन चरण, और हम जाने के लिए तैयार हैं:

  1. यदि आपने अपने प्रोजेक्ट के लिए पहले से क्लाउड-आधारित API सक्षम नहीं किया है, तो अभी करें:

    1. फायरबेस कंसोल का फायरबेस एमएल एपीआई पेज खोलें।
    2. यदि आपने पहले से ही अपने प्रोजेक्ट को ब्लेज़ मूल्य निर्धारण योजना में अपग्रेड नहीं किया है, तो ऐसा करने के लिए अपग्रेड पर क्लिक करें। (आपको केवल तभी अपग्रेड करने के लिए कहा जाएगा जब आपका प्रोजेक्ट ब्लेज़ प्लान पर न हो।)

      केवल ब्लेज़-स्तरीय प्रोजेक्ट ही क्लाउड-आधारित API का उपयोग कर सकते हैं।

    3. यदि क्लाउड-आधारित API पहले से सक्षम नहीं हैं, तो क्लाउड-आधारित API सक्षम करें क्लिक करें .
  2. Cloud Vision API का एक्सेस अस्वीकार करने के लिए अपनी मौजूदा Firebase API कुंजियां कॉन्फ़िगर करें:
    1. क्लाउड कंसोल का क्रेडेंशियल पेज खोलें।
    2. सूची में प्रत्येक एपीआई कुंजी के लिए, संपादन दृश्य खोलें, और कुंजी प्रतिबंध अनुभाग में, क्लाउड विज़न एपीआई को छोड़कर सभी उपलब्ध एपीआई को सूची में जोड़ें।

कॉल करने योग्य फ़ंक्शन को परिनियोजित करें

इसके बाद, क्लाउड फ़ंक्शन को परिनियोजित करें जिसका उपयोग आप अपने ऐप और क्लाउड विज़न एपीआई को पाटने के लिए करेंगे। functions-samples भंडार में एक उदाहरण होता है जिसका आप उपयोग कर सकते हैं।

डिफ़ॉल्ट रूप से, इस फ़ंक्शन के माध्यम से क्लाउड विज़न एपीआई तक पहुँचने से केवल आपके ऐप के प्रमाणित उपयोगकर्ता ही क्लाउड विज़न एपीआई तक पहुँच सकते हैं। आप विभिन्न आवश्यकताओं के लिए फ़ंक्शन को संशोधित कर सकते हैं।

समारोह को तैनात करने के लिए:

  1. फंक्शन-सैंपल रेपो को क्लोन या डाउनलोड करें और vision-annotate-image डायरेक्टरी में बदलें:
    git clone https://github.com/firebase/functions-samples
    cd vision-annotate-image
    
  2. निर्भरता स्थापित करें:
    cd functions
    npm install
    cd ..
    
  3. अगर आपके पास फायरबेस सीएलआई नहीं है, तो इसे इंस्टॉल करें।
  4. vision-annotate-image डायरेक्टरी में फायरबेस प्रोजेक्ट को इनिशियलाइज़ करें। संकेत मिलने पर, सूची में अपना प्रोजेक्ट चुनें।
    firebase init
  5. फ़ंक्शन परिनियोजित करें:
    firebase deploy --only functions:annotateImage

अपने ऐप्लिकेशन में Firebase प्रमाणीकरण जोड़ें

ऊपर परिनियोजित कॉल करने योग्य फ़ंक्शन आपके ऐप के गैर-प्रमाणित उपयोगकर्ताओं के किसी भी अनुरोध को अस्वीकार कर देगा। अगर आपने पहले से ऐसा नहीं किया है, तो आपको अपने ऐप में Firebase Auth जोड़ना होगा।

अपने ऐप में आवश्यक निर्भरताएँ जोड़ें

फायरबेस लाइब्रेरी के लिए क्लाउड फंक्शंस को स्थापित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।

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 क्लाउड विज़न अनुरोध पास करने वाले कॉल करने योग्य फ़ंक्शन को लागू करें।

  1. सबसे पहले, क्लाउड फ़ंक्शंस का एक उदाहरण प्रारंभ करें:

    तीव्र

    lazy var functions = Functions.functions()
    

    उद्देश्य सी

    @property(strong, nonatomic) FIRFunctions *functions;
    
  2. LANDMARK_DETECTION पर सेट प्रकार के साथ एक अनुरोध बनाएं:

    तीव्र

    let requestData = [
      "image": ["content": base64encodedImage],
      "features": ["maxResults": 5, "type": "LANDMARK_DETECTION"]
    ]
    

    उद्देश्य सी

    NSDictionary *requestData = @{
      @"image": @{@"content": base64encodedImage},
      @"features": @{@"maxResults": @5, @"type": @"LANDMARK_DETECTION"}
    };
    
  3. अंत में, फ़ंक्शन का आह्वान करें:

    तीव्र

    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"];
  }
}