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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

डेटा देने वाली तीसरे पक्ष की कंपनियां शामिल करें. हमारे मैपिंग प्रॉडक्ट में मौजूद कुछ डेटा और इमेज, Google के अलावा दूसरी कंपनियों से मिलती हैं. अगर ऐसी इमेज का इस्तेमाल किया जा रहा है, तो आपके एट्रिब्यूशन के टेक्स्ट में "Google" नाम और उससे जुड़े डेटा सेवा देने वाली कंपनी का नाम होना चाहिए, जैसे कि "मैप डेटा: Google, Maxar Technologies." जब डेटा उपलब्ध कराने वाली तीसरे पक्ष की कंपनियों की तस्वीरों का इस्तेमाल तस्वीरों में दिखाया गया हो, तो सिर्फ़ "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;
}

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

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

उदाहरण कंपनी की लिस्टिंग

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

ध्यान रखें कि किसी जगह का आईडी, जिसका इस्तेमाल किसी जगह को खास तौर पर पहचानने के लिए किया जाता है, को कैश मेमोरी में सेव की गई पाबंदी से छूट मिलती है. इसलिए, जगह के आईडी की वैल्यू को हमेशा के लिए सेव किया जा सकता है. जगह का आईडी, iOS रिस्पॉन्स के लिए Places 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" टेक्स्ट के लिए लागू होने पर, यह सीएसएस "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;