इस पेज का अनुवाद Cloud Translation API से किया गया है.

Apple प्लैटफ़ॉर्म पर Firebase पुष्टि और फ़ंक्शन का इस्तेमाल करके, Cloud Vision की मदद से लैंडमार्क की पहचान सुरक्षित तरीके से करें

अपने ऐप्लिकेशन से Google Cloud API को कॉल करने के लिए, आपको एक इंटरमीडिएट बनाना होगा REST API, जो अनुमति देने को मैनेज करती है और एपीआई पासकोड जैसी सीक्रेट वैल्यू को सुरक्षित करती है. इसके बाद, आपको यह करना होगा इस बीच के लेवल पर मिलने वाली सेवा की पुष्टि करने और इससे संपर्क करने के लिए, अपने मोबाइल ऐप्लिकेशन में कोड लिखें.

इस REST API को बनाने का एक तरीका है, Firebase से पुष्टि और फ़ंक्शन का इस्तेमाल करना. इससे आपको मैनेज किया जा रहा बिना सर्वर वाला गेटवे मिलता है ऐसे Google Cloud API जो पुष्टि करने का काम संभालते हैं और जिन्हें आपके मोबाइल ऐप्लिकेशन से कॉल किया जा सकता है पहले से बने SDK टूल.

इस गाइड में, अपने ऐप्लिकेशन से Cloud Vision API को कॉल करने के लिए, इस तकनीक का इस्तेमाल करने का तरीका बताया गया है. इस तरीके से, पुष्टि किए गए सभी उपयोगकर्ता आपके Cloud प्रोजेक्ट के ज़रिए Cloud Vision की बिलिंग सेवाओं को ऐक्सेस कर पाएंगे. इसलिए, आगे बढ़ने से पहले देखें कि पुष्टि करने का यह तरीका आपके इस्तेमाल के उदाहरण के लिए काफ़ी है या नहीं.

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

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

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

Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift पैकेज मैनेजर का इस्तेमाल करें.

Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलने के लिए, फ़ाइल > पैकेज जोड़ना.
जब कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल का रिपॉज़िटरी जोड़ें:

  https://github.com/firebase/firebase-ios-sdk.git

Firebase ML लाइब्रेरी चुनें.
अपने टारगेट की बिल्ड सेटिंग के अन्य लिंकर फ़्लैग सेक्शन में -ObjC फ़्लैग जोड़ें.
यह काम पूरा होने पर, Xcode अपने-आप रिज़ॉल्व और डाउनलोड होना शुरू कर देगा पर निर्भर करता है.

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

अपने ऐप्लिकेशन में, Firebase इंपोर्ट करें:
Swift
```
import FirebaseMLModelDownloader
```
Objective-C
```
@import FirebaseMLModelDownloader;
```

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

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

कॉल करने लायक फ़ंक्शन को डिप्लॉय करें

इसके बाद, अपने ऐप्लिकेशन और क्लाउड को जोड़ने के लिए इस्तेमाल किया जाने वाला Cloud फ़ंक्शन डिप्लॉय करें Vision API. functions-samples डेटा संग्रह स्थान में इसका एक उदाहरण है तो ये तरीके़ इस्तेमाल किए जा सकते हैं.

डिफ़ॉल्ट रूप से, इस फ़ंक्शन से Cloud Vision API को ऐक्सेस करने पर, आपके ऐप्लिकेशन के पुष्टि किए गए उपयोगकर्ता ही Cloud Vision API को ऐक्सेस कर पाएंगे. आप अलग-अलग ज़रूरतों के हिसाब से फ़ंक्शन में बदलाव करें.

फ़ंक्शन को डिप्लॉय करने के लिए:

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

अपने ऐप्लिकेशन में Firebase पुष्टि करने की सुविधा जोड़ें

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

अपने ऐप्लिकेशन में ज़रूरी डिपेंडेंसी जोड़ें

'Firebase के लिए Cloud Functions' लाइब्रेरी इंस्टॉल करने के लिए, Swift पैकेज मैनेजर का इस्तेमाल करें.

1. इनपुट इमेज तैयार करें

Cloud Vision को कॉल करने के लिए, इमेज को base64 कोड में बदले गए फ़ॉर्मैट के तौर पर होना चाहिए स्ट्रिंग. UIImage प्रोसेस करने के लिए:

Swift

guard let imageData = uiImage.jpegData(compressionQuality: 1.0) else { return }
let base64encodedImage = imageData.base64EncodedString()

Objective-C

NSData *imageData = UIImageJPEGRepresentation(uiImage, 1.0f);
NSString *base64encodedImage =
  [imageData base64EncodedStringWithOptions:NSDataBase64Encoding76CharacterLineLength];

2. लैंडमार्क को पहचानने के लिए, कॉल किए जा सकने वाले फ़ंक्शन को शुरू करें

किसी इमेज में लैंडमार्क की पहचान करने के लिए, कॉल करने लायक फ़ंक्शन को शुरू करें JSON Cloud विज़न अनुरोध.

सबसे पहले, Cloud Functions के इंस्टेंस को शुरू करें:
Swift
```
lazy var functions = Functions.functions()
```
Objective-C
```
@property(strong, nonatomic) FIRFunctions *functions;
```

टाइप को LANDMARK_DETECTION पर सेट करके अनुरोध तैयार करें:

Swift

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

Objective-C

NSDictionary *requestData = @{
  @"image": @{@"content": base64encodedImage},
  @"features": @{@"maxResults": @5, @"type": @"LANDMARK_DETECTION"}
};

आखिर में, फ़ंक्शन शुरू करें:

Swift

do {
  let result = try await functions.httpsCallable("annotateImage").call(requestData)
  print(result)
} catch {
  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]
    }
    // ...
  }
}

Objective-C

[[_functions HTTPSCallableWithName:@"annotateImage"]
                          callWithObject:requestData
                              completion:^(FIRHTTPSCallableResult * _Nullable result, NSError * _Nullable error) {
        if (error) {
          if ([error.domain isEqualToString:@"com.firebase.functions"]) {
            FIRFunctionsErrorCode code = error.code;
            NSString *message = error.localizedDescription;
            NSObject *details = error.userInfo[@"details"];
          }
          // ...
        }
        // Function completed succesfully
        // Get information about labeled objects

      }];

3. जाने-पहचाने लैंडमार्क के बारे में जानकारी पाएं

अगर लैंडमार्क की पहचान करने की कार्रवाई पूरी होती है, तो JSON रिस्पॉन्स BatchAnnotateImageResponse को टास्क के नतीजे में दिखाया जाएगा. landmarkAnnotations में मौजूद हर ऑब्जेक्ट अरे एक लैंडमार्क को दिखाता है, जिसकी पहचान इमेज में की गई थी. हर लैंडमार्क के लिए, आपको इनपुट इमेज में, लैंडमार्क के नाम, और उसके बाउंडिंग कोऑर्डिनेट को देखने की सुविधा मिलती है इसका अक्षांश और देशांतर, इसका नॉलेज ग्राफ़ का इकाई आईडी (अगर उपलब्ध हो), और मैच का कॉन्फ़िडेंस स्कोर. उदाहरण के लिए:

Swift

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

Objective-C

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