iOS के लिए Places SDK टूल की नीतियां

इस दस्तावेज़ में iOS के लिए बनाई गई 'जगहों का SDK टूल' डेवलप की गई सभी ऐप्लिकेशन के लिए ज़रूरी शर्तें शामिल हैं. इसमें, जगह की जानकारी अपने-आप पूरी होने की सेवा भी शामिल है, जो उस एपीआई का हिस्सा है. Google Maps डेवलपर के लिए ज़्यादा सामान्य जानकारी Google Maps Platform की सेवा की शर्तों में देखी जा सकती है.

इस्तेमाल की शर्तें और निजता नीति देना

अगर आप iOS ऐप्लिकेशन के लिए 'जगह का SDK टूल' डेवलप करते हैं, तो आपको अपने ऐप्लिकेशन के लिए उपयोग की शर्तें और एक निजता नीति उपलब्ध करानी होगी, जो Google के साथ होने वाले आपके कानूनी समझौते में बताए गए दिशा-निर्देशों का पालन करती है:

  • उपयोग की शर्तें और निजता नीति सभी के लिए उपलब्ध होनी चाहिए.
  • आपको अपने ऐप्लिकेशन की इस्तेमाल की शर्तों में साफ़ तौर पर बताना होगा कि आपके ऐप्लिकेशन का इस्तेमाल करने पर, उपयोगकर्ताओं पर Google की सेवा की शर्तें लागू होती हैं.
  • आपको अपनी निजता नीति में उपयोगकर्ताओं को बताना होगा कि आप Google Maps API का इस्तेमाल कर रहे हैं. साथ ही, Google निजता नीति भी शामिल करें.

उपयोग की शर्तें और निजता नीति उपलब्ध कराने के लिए सुझाई गई जगह आपके ऐप्लिकेशन के प्लैटफ़ॉर्म पर निर्भर करती है.

मोबाइल ऐप्लिकेशन

अगर मोबाइल ऐप्लिकेशन डेवलप करते हैं, तो हमारा सुझाव है कि आप अपने ऐप्लिकेशन के इस्तेमाल की शर्तों और निजता नीति के लिंक का इस्तेमाल करें. साथ ही, इसके लिए ज़रूरी ऐप्लिकेशन स्टोर और ऐप्लिकेशन की सेटिंग मेन्यू में जाएं.

वेब ऐप्लिकेशन

अगर आप कोई वेब ऐप्लिकेशन बना रहे हैं, तो हमारा सुझाव है कि आप अपनी वेबसाइट के फ़ुटर में, इस्तेमाल की शर्तों और निजता नीति का लिंक दें.

कॉन्टेंट को पहले से फ़ेच करना, कैश मेमोरी में सेव करना या सेव करना

iOS के लिए Places SDK टूल का इस्तेमाल करने वाले ऐप्लिकेशन, Google के साथ आपके कानूनी समझौते की शर्तों से जुड़े होते हैं. आपके कानूनी समझौते की शर्तों के तहत, आपको शर्तों में बताई गई सीमित शर्तों को छोड़कर किसी भी कॉन्टेंट को पहले से फ़ेच, इंडेक्स, सेव या कैश नहीं करना चाहिए.

iOS के नतीजों के लिए, जगहों के SDK टूल दिखाना

आप Google Maps पर या मैप के बिना, iOS के नतीजों के लिए Places SDK टूल दिखा सकते हैं. अगर आपको मैप पर, iOS के नतीजों के लिए Places SDK टूल दिखाना है, तो आपको ये नतीजे Google Maps पर दिखाने होंगे. iOS पर किसी डेटा को ऐसे मैप पर इस्तेमाल करने की अनुमति नहीं है जो Google मैप न हो.

अगर आपका ऐप्लिकेशन Google मैप पर डेटा दिखाता है, तो Google लोगो शामिल किया जाएगा और बदला नहीं जा सकता. ऐसे ऐप्लिकेशन जो Google मैप वाली स्क्रीन पर Google डेटा दिखाते हैं, उन्हें Google को और ज़्यादा एट्रिब्यूशन देने की ज़रूरत नहीं होती.

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

Google लोगो को मैप के सबसे नीचे बाएं कोने में रखा जाना चाहिए, जिसमें एट्रिब्यूशन की जानकारी सबसे नीचे दाएं कोने में होनी चाहिए. ये दोनों जगहें, मैप पर पूरे तरीके से दिखाई जानी चाहिए और मैप के अंदर या ऐप्लिकेशन के अंदर किसी और जगह पर नहीं होनी चाहिए. मैप के नीचे दिए गए उदाहरण में, मैप के नीचे बाईं ओर Google का लोगो और नीचे दाईं ओर एट्रिब्यूशन दिखता है.

इस ज़िप फ़ाइल में Google लोगो, डेस्कटॉप, Android, और iOS ऐप्लिकेशन के लिए सही साइज़ में शामिल है. आप इन लोगो का किसी भी तरह से आकार नहीं बदल सकते और न ही उनमें बदलाव कर सकते हैं.

डाउनलोड करें: google_logo.zip

एट्रिब्यूशन में बदलाव न करें. एट्रिब्यूशन की जानकारी को हटाएं, धुंधला करें या काटें. आप इनलाइन Google लोगो का इस्तेमाल नहीं कर सकते (उदाहरण के लिए, "ये मैप [Google_logo]" से लिए गए हैं).

एट्रिब्यूशन को बंद रखें. अगर सीधे तौर पर एम्बेड किए गए टेक्स्ट के अलावा, Google की तस्वीरों के स्क्रीनशॉट का इस्तेमाल किया जा रहा है, तो इमेज में दिखने वाले स्टैंडर्ड एट्रिब्यूशन को शामिल करें. अगर ज़रूरी हो, तो एट्रिब्यूशन टेक्स्ट के स्टाइल और प्लेसमेंट को पसंद के मुताबिक बनाया जा सकता है. इसके लिए ज़रूरी है कि टेक्स्ट, कॉन्टेंट के काफ़ी करीब हो. साथ ही, वह आम दर्शक या रीडर के लिए पढ़ने लायक हो. हो सकता है कि एट्रिब्यूशन को कॉन्टेंट से दूर न ले जाया जाए. जैसे, अपनी किताब के आखिर में, आपकी फ़ाइलों या शो के क्रेडिट या आपकी वेबसाइट के फ़ुटर पर.

डेटा देने वाली तीसरे पक्ष की कंपनी को शामिल करें. मैपिंग वाले हमारे प्रॉडक्ट में मौजूद कुछ डेटा और इमेज, Google के अलावा दूसरी कंपनियों से मिलती हैं. अगर इस तरह की तस्वीरों का इस्तेमाल किया जाता है, तो आपके एट्रिब्यूशन के टेक्स्ट में नाम और कोट;और Google की सेवा देने वाली कंपनी(जैसे कि "मैप डेटा: Google, Maxar Technologies.&quot) लिखा होना चाहिए; जब तीसरे पक्ष की डेटा उपलब्ध कराने वाली कंपनियां, तस्वीरों का संग्रह करती हैं, जिसमें सिर्फ़ "Google" या Google का लोगो शामिल होता है, तो यह सही एट्रिब्यूशन नहीं होता.

अगर आप किसी ऐसे डिवाइस पर Google Maps Platform का इस्तेमाल कर रहे हैं जिस पर एट्रिब्यूशन डिसप्ले काम का नहीं है, तो इस्तेमाल के उदाहरण के हिसाब से लाइसेंस की चर्चा करने के लिए, कृपया Google की सेल्स टीम से संपर्क करें.

एट्रिब्यूशन की अन्य ज़रूरी शर्तें

सेवा देने वाली तीसरे पक्ष की कंपनियों के एट्रिब्यूशन में ऐसा कॉन्टेंट और लिंक होते हैं जिन्हें आपको उपयोगकर्ता को उस फ़ॉर्मैट में दिखाना होगा जिसमें वे दिए गए हैं. Google हमारा सुझाव है कि आपका ऐप्लिकेशन जगह की इस जानकारी के नीचे यह जानकारी दिखाए.

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

किसी एक जगह या जगहों के संग्रह के लिए, तीसरे पक्ष के एट्रिब्यूशन को वापस पाने के लिए इन निर्देशों का पालन करें.

एक ही जगह के लिए एट्रिब्यूशन वापस पाना

जब आप आईडी की मदद से जगह की जानकारी हासिल करते हैं, तो आपको GMSPlace पर attributions प्रॉपर्टी से उस जगह की जानकारी वापस मिल सकती है.

attributions को NSAttributedString ऑब्जेक्ट के तौर पर दिया जाता है.

स्थानों के संग्रह के लिए एट्रिब्यूशन वापस पाना

अगर आपके ऐप्लिकेशन में डिवाइस की मौजूदा जगह के बारे में अनुरोध किया जाता है, तो ऐप्लिकेशन को उस जगह की जानकारी के लिए, तीसरे पक्ष के एट्रिब्यूशन दिखाने होंगे. आप GMSPlaceLikelihoodList पर attributions प्रॉपर्टी से, अनुरोध के ज़रिए मिली सभी जगहों के एट्रिब्यूशन दोबारा पा सकते हैं.

attributions को NSAttributedString ऑब्जेक्ट के तौर पर उपलब्ध कराया जाता है, जिसे एक ही जगह पर attributions की तरह ऐक्सेस और दिखाया जा सकता है. इसके बारे में, ऊपर बताया गया है.

किसी फ़ोटो के लिए एट्रिब्यूशन दिखाना

अगर आपका ऐप्लिकेशन फ़ोटो दिखाता है, तो आपको उस हर फ़ोटो के लिए एट्रिब्यूशन दिखाने होंगे. किसी फ़ोटो के एट्रिब्यूशन की जानकारी पाने के लिए, GMSPlacePhotoMetadata.attributions पर कॉल करें. अगर दिखाने के लिए कोई एट्रिब्यूशन नहीं है, तो यह प्रॉपर्टी एक NSAttributedString या nil है.

Swift

GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in
  if let error = error {
    // TODO: handle the error.
    print("Error: \(error.description)")
  } else {
    // Get attribution for the first photo in the list.
    if let photo = photos?.results.first {
      let attributions = photo.attributions
    }
  }
}

Objective-C

[[GMSPlacesClient sharedClient]
    lookUpPhotosForPlaceID:placeID
                  callback:^(GMSPlacePhotoMetadataList *_Nullable photos,
                             NSError *_Nullable error) {
                    if (error) {
                      // TODO: handle the error.
                      NSLog(@"Error: %@", [error description]);
                    } else {
                      // Get attribution for the first photo in the list.
                      if (photos.results.count > 0) {
                        GMSPlacePhotoMetadata *photo = photos.results.firstObject;
                        NSAttributedString *attributions = photo.attributions;
                      }
                    }
                  }];

तीसरे पक्ष के एट्रिब्यूशन दिखाना

सेवा देने वाली तीसरे पक्ष की कंपनियों को एट्रिब्यूशन, NSAttributedString ऑब्जेक्ट के तौर पर दिए जाते हैं. इनमें आपका कॉन्टेंट और लिंक शामिल होते हैं, जिन्हें आपको उपयोगकर्ता को सुरक्षित रखना और दिखाना ज़रूरी है.

एट्रिब्यूशन दिखाने के लिए, UITextView सुझाया गया है. ऐसा इसलिए है, क्योंकि एट्रिब्यूशन में मौजूद लिंक काम करने चाहिए. यह पक्का करने के लिए कि लिंक काम करें, UITextView पर एक डेलिगेशन सेट करें. साथ ही, अपने UITextViewDelegate के shouldInteractWithURL तरीके को YES पर सेट करें.

Swift

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}

Objective-C

...
  self.attributionTextView.delegate = self;
...

#pragma mark - UITextViewDelegate

- (BOOL)textView:(UITextView *)textView
    shouldInteractWithURL:(NSURL *)url
                  inRange:(NSRange)characterRange {
  // Make links clickable.
  return YES;
}

तीसरे पक्ष के एट्रिब्यूशन का उदाहरण

आम तौर पर, तीसरे पक्ष के एट्रिब्यूशन में लिंक वाला टेक्स्ट शामिल होता है. जैसे:

Example Company की लिस्टिंग

ऊपर दिए गए उदाहरण में, उदाहरण के लिए, कंपनी की टेक्स्ट रेंज में NSLink एट्रिब्यूट शामिल है.

ध्यान दें कि किसी जगह की खास पहचान करने के लिए इस्तेमाल किए जाने वाले जगह का आईडी, कैश मेमोरी में सेव किए जाने पर लगाई गई पाबंदी से बाहर रहता है. इसलिए, जगह के आईडी की वैल्यू को अनिश्चित समय तक स्टोर किया जा सकता है. iOS आईडी के लिए, SDK टूल के place_id फ़ील्ड में जगह का आईडी दिखाया जाता है.

Google एट्रिब्यूशन के लिए स्टाइल के दिशा-निर्देश

अगर आप डाउनलोड किए जा सकने वाले Google लोगो का इस्तेमाल नहीं कर पा रहे हैं, तो सीएसएस और एचटीएमएल में Google एट्रिब्यूशन के लिए स्टाइल संबंधी दिशा-निर्देश नीचे दिए गए हैं.

जगह खाली करना

लॉकअप के आस-पास की खाली जगह की संख्या, Google में "G" की ऊंचाई के बराबर या उससे ज़्यादा होनी चाहिए.

एट्रिब्यूशन कॉपी और Google के लोगो के बीच के स्पेस की लंबाई, "G" की आधी होनी चाहिए.

कानूनी जवाबदेही

बायलाइन, साफ़ और समझने में आसान होना चाहिए. साथ ही, वह किसी बैकग्राउंड के लिए सही रंग वाले वैरिएशन में दिखना चाहिए. पक्का करें कि आपने लोगो का जो वैरिएशन चुना है उसमें ज़रूरत के मुताबिक कंट्रास्ट हो.

रंग

सफ़ेद या हल्के रंग के बैकग्राउंड पर Google मटीरियल ग्रे 700 टेक्स्ट का इस्तेमाल करें. यह बैकग्राउंड 0% से 40% तक की रेंज का इस्तेमाल करता है.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

गहरे रंग के बैकग्राउंड पर और फ़ोटोग्राफ़ी या गैर-व्यस्त पैटर्न में, बायलाइन और एट्रिब्यूशन के लिए सफ़ेद टेक्स्ट का इस्तेमाल करें.

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

फ़ॉन्ट

Roboto फ़ॉन्ट इस्तेमाल करें.

उदाहरण सीएसएस

टेक्स्ट पर लागू होने पर, यह सीएसएस, Google &कोटेशन, सफ़ेद या हल्के बैकग्राउंड पर सही फ़ॉन्ट, रंग, और स्पेस के साथ रेंडर और कोट करता है.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;