Places SDK for iOS के लिए नीतियां और एट्रिब्यूशन

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

नीतियां

इस सेक्शन में, Places SDK for iOS से जुड़ी नीतियों के बारे में बताया गया है. नीतियों में, सेवा को सही तरीके से इस्तेमाल करने और Google Maps Platform की उम्मीदों के मुताबिक काम करने के लिए, ज़रूरी शर्तें और लागू करने के लिए दिशा-निर्देश दिए जाते हैं.

कैशिंग से जुड़ी पाबंदियों से जुड़े अपवाद

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

यूरोपियन इकनॉमिक एरिया में शामिल देश और इलाके

इस प्रॉडक्ट के लिए, यूरोपियन इकनॉमिक एरिया (ईईए) में बिलिंग पते वाले ग्राहकों के लिए सेवा की शर्तें अलग होती हैं. साथ ही, इसकी सुविधाएं भी अलग हो सकती हैं. Google Maps Platform की मदद से ऐप्लिकेशन बनाने से पहले, ईईए के लिए सेवा की इन शर्तों और जानकारी की समीक्षा करें:

• ईईए के लिए, Google Maps Platform की सेवा की शर्तें
• ईईए के लिए, Google Maps Platform की सेवा की खास शर्तें
• ईईए के लिए, अक्सर पूछे जाने वाले सवाल (एफ़एक्यू)
• Google Maps Platform की सड़क सुरक्षा से जुड़ी ज़रूरी शर्तें

अगर आपका बिलिंग पता ईईए में नहीं है, तो सेवा की ये शर्तें लागू होती हैं:

• Google Maps Platform की सेवा की शर्तें
• Google Maps Platform की सेवा की खास शर्तें

Google Maps के एट्रिब्यूशन से जुड़ी ज़रूरी शर्तें

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

एट्रिब्यूशन का उदाहरण

यहां, Places यूआई किट के लिए एट्रिब्यूशन का एक उदाहरण दिया गया है.

Google Maps का एट्रिब्यूशन दिखाना

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

Google Maps का एट्रिब्यूशन शामिल करना

Google Maps Platform, यूज़र इंटरफ़ेस (यूआई) में Google Maps का एट्रिब्यूशन पहले से उपलब्ध कराता है. जैसे, Places यूआई किट में:

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

Google Maps का लोगो और टेक्स्ट एट्रिब्यूशन

जहां तक हो सके, एट्रिब्यूशन के तौर पर Google Maps के लोगो का इस्तेमाल करें. अगर जगह कम है, तो Google Maps टेक्स्ट का इस्तेमाल किया जा सकता है. असली उपयोगकर्ताओं को हमेशा यह साफ़ तौर पर पता होना चाहिए कि कौनसा कॉन्टेंट Google Maps ने उपलब्ध कराया है.

लोगो एट्रिब्यूशन

Google Maps के लोगो डाउनलोड करना

Google Maps के आधिकारिक लोगो वाली फ़ाइलों का इस्तेमाल करें. नीचे दिए गए लोगो डाउनलोड करें और इस सेक्शन में दिए गए दिशा-निर्देशों का पालन करें.

Google Maps के लोगो का इस्तेमाल करते समय, इन दिशा-निर्देशों का पालन करें.

• लोगो में किसी भी तरह का बदलाव न करें.
• लोगो का आसपेक्ट रेशियो बनाए रखें, ताकि वह खराब न दिखे.
• किसी मिले-जुले पैटर्न वाले बैकग्राउंड पर, आउटलाइन वाले लोगो का इस्तेमाल करें. जैसे, मैप या इमेज.
• किसी सादे बैकग्राउंड पर, बिना आउटलाइन वाले लोगो का इस्तेमाल करें. जैसे, एक ही रंग या हल्का ग्रेडिएंट.

लोगो के साइज़ से जुड़ी ज़रूरी शर्तें

• लोगो की कम से कम लंबाई: 16dp
• लोगो की ज़्यादा से ज़्यादा लंबाई: 19dp
• लोगो के चारों ओर कम से कम खाली जगह: बाईं, दाईं, और ऊपर की ओर 10dp, नीचे की ओर 5dp

dp के बारे में जानने के लिए, Material Design की वेबसाइट पर पिक्सल डेंसिटी देखें.

लोगो की सुलभता

• लोगो और बैकग्राउंड के बीच, सुलभ कंट्रास्ट बनाए रखें.
• Google Maps टेक्स्ट के साथ, सुलभता लेबल शामिल करें.

टेक्स्ट एट्रिब्यूशन

अगर आपके इंटरफ़ेस का साइज़, Google Maps के लोगो का इस्तेमाल करने के लिए सही नहीं है, तो Google Maps को टेक्स्ट में लिखा जा सकता है. इन दिशा-निर्देशों का पालन करें:

• Google Maps टेक्स्ट में किसी भी तरह का बदलाव न करें:
  
  • Google Maps के केस में बदलाव न करें
  • Google Maps को एक से ज़्यादा लाइनों में न लिखें
  • Google Maps को किसी दूसरी भाषा में स्थानीय भाषा में अनुवाद न करें.
  • ब्राउज़र को Google Maps का अनुवाद करने से रोकने के लिए, एचटीएमएल एट्रिब्यूट translate="no" का इस्तेमाल करें.

• Google Maps के टेक्स्ट को, यहां दी गई टेबल के मुताबिक स्टाइल करें:

  Google Maps के टेक्स्ट को स्टाइल करने से जुड़ी ज़रूरी शर्तें
  प्रॉपर्टी	स्टाइल
  फ़ॉन्ट फ़ैमिली	Roboto. फ़ॉन्ट लोड करना ज़रूरी नहीं है.
  फ़ॉलबैक फ़ॉन्ट फ़ैमिली	आपके प्रॉडक्ट में पहले से इस्तेमाल किया जा रहा कोई भी sans serif बॉडी फ़ॉन्ट या डिफ़ॉल्ट सिस्टम फ़ॉन्ट को चालू करने के लिए "Sans-Serif"
  फ़ॉन्ट स्टाइल	सामान्य
  फ़ॉन्ट की मोटाई	400
  फ़ॉन्ट का रंग	सफ़ेद, काला (#1F1F1F) या ग्रे (#5E5E5E). बैकग्राउंड के मुकाबले, सुलभ (4.5:1) कंट्रास्ट बनाए रखें.
  फ़ॉन्ट का साइज़	फ़ॉन्ट का कम से कम साइज़: 12sp फ़ॉन्ट का ज़्यादा से ज़्यादा साइज़: 16sp sp के बारे में जानने के लिए, Material Design की वेबसाइट पर फ़ॉन्ट साइज़ यूनिट देखें.
  अक्षरों के बीच की दूरी	सामान्य

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

यहां दी गई सीएसएस, Google Maps को सफ़ेद या हल्के बैकग्राउंड पर, सही टाइपोग्राफ़िक स्टाइल और रंग के साथ रेंडर करती है.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

विज़ुअल से जुड़ी ज़रूरी शर्तें

• एट्रिब्यूशन को कॉन्टेंट के सबसे ऊपर या सबसे नीचे और एक ही विज़ुअल कंटेनर में रखें. कॉन्टेंट की एक लाइन के लिए, एट्रिब्यूशन को दाईं या बाईं ओर रखा जा सकता है.

• Google Maps Platform के कॉन्टेंट को अन्य कॉन्टेंट से हमेशा अलग दिखाएं. इसके लिए, यूआई के संकेत इस्तेमाल करें. जैसे, बॉर्डर, बैकग्राउंड का रंग, शैडो या ज़रूरत के मुताबिक खाली जगह.

• Google Maps Platform के कॉन्टेंट के अलावा किसी अन्य कॉन्टेंट के साथ एट्रिब्यूट करके, Google Maps को गलत तरीके से न दिखाएं.
• पक्का करें कि एट्रिब्यूशन हमेशा दिखे और उसे पढ़ा जा सके. इसे कभी भी न हटाएं, छिपाएं, धुंधला करें या इसमें बदलाव करें.

यहां दी गई इमेज में, विज़ुअल से जुड़ी इन ज़रूरी शर्तों के उदाहरण दिखाए गए हैं.

तीसरे पक्ष के डेटा प्रदाता

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

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

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

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

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

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

आईडी के हिसाब से जगह की जानकारी पाने पर, उस जगह के लिए एट्रिब्यूशन पाया जा सकता है. इसके लिए, attributions प्रॉपर्टी का इस्तेमाल करें.GMSPlace

attributions को NSAttributedString ऑब्जेक्ट के तौर पर उपलब्ध कराया जाता है.

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

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

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

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

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

हेडर: इन नतीजों के बारे में

मुख्य हिस्सा: अपने आस-पास के कारोबार या जगहें खोजने पर, Google Maps आपको स्थानीय नतीजे दिखाएगा. मुख्य तौर पर काम की जानकारी, दूरी, और लोकप्रियता जैसी कई बातों के आधार पर, खोज के सबसे सटीक नतीजे दिखाए जाते हैं.

पहला बटन: ज़्यादा जानें
"ज़्यादा जानें" टेक्स्ट, सहायता केंद्र के किसी लेख से लिंक होना चाहिए.

दूसरा बटन: ठीक है

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

अगर आपका ऐप्लिकेशन फ़ोटो दिखाता है, तो आपको हर उस फ़ोटो के लिए attributions और authorAttributions दिखाने होंगे जिनके लिए ये उपलब्ध हैं.

• किसी भी एट्रिब्यूशन को ऐक्सेस करने के लिए, GMSPlacePhotoMetadata.attributions का इस्तेमाल करें. यह प्रॉपर्टी, NSAttributedString होती है. अगर दिखाने के लिए कोई एट्रिब्यूशन नहीं है, तो इसकी वैल्यू nil होती है.
• लेखक के किसी भी एट्रिब्यूशन को ऐक्सेस करने के लिए, GMSPlacePhotoMetadata.authorAttributions का इस्तेमाल करें. इस प्रॉपर्टी में, GMSPlaceAuthorAttribution ऑब्जेक्ट का एक कलेक्शन होता है.

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

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

समीक्षा दिखाना

एक GMSPlace ऑब्जेक्ट में ज़्यादा से ज़्यादा पांच समीक्षाएं हो सकती हैं. हर समीक्षा को एक GMSPlaceReview ऑब्जेक्ट से दिखाया जाता है. आपके पास अपने ऐप्लिकेशन में इन समीक्षाओं को दिखाने का विकल्प होता है.

Google के उपयोगकर्ताओं की ओर से दी गई समीक्षाएं दिखाते समय, आपको लेखक का नाम आस-पास ही रखना होगा. GMSPlaceReview ऑब्जेक्ट के लेखक के एट्रिब्यूशन वाले फ़ील्ड में उपलब्ध होने पर, हमारा सुझाव है कि आप लेखक की फ़ोटो और उसकी प्रोफ़ाइल का लिंक भी शामिल करें. यहां दी गई इमेज में, किसी पार्क की समीक्षा का एक उदाहरण दिखाया गया है:

Google का यह भी सुझाव है कि आप असली उपयोगकर्ता को यह दिखाएं कि समीक्षाओं को किस क्रम में दिखाया जा रहा है.

समीक्षाएं ऐक्सेस करने के लिए:

// Define a Place ID.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews]

// Create the GMSFetchPlaceRequest object.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    let firstReview: GMSPlaceReview = place.reviews![0]

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
})

// Define a Place ID.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return, including reviews.
NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews];

GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
  if (error) {
    // TODO: handle the error.
    NSLog(@"Error: %@", [error description]);
  } else {
    // Get first review.
    GMSPlaceReview *firstReview = [place reviews][0];

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
}];

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

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

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

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

// MARK: - UITextViewDelegate

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

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

#pragma mark - UITextViewDelegate

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

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

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

Listings by Example Company

ऊपर दिए गए उदाहरण में, Example Company टेक्स्ट रेंज को एक NSLink एट्रिब्यूट से कवर किया गया है.

असली उपयोगकर्ताओं के पतों के लिए, अपने-आप पूरा होने की सुविधा

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

पिछली इमेज में, बाईं ओर मौजूद पतों की सूची पर, Google Maps के कॉन्टेंट से जुड़ी पाबंदियां अब भी लागू हैं. असली उपयोगकर्ता के अपना पता चुनने के बाद, उस पते पर, Google Maps के कॉन्टेंट से जुड़ी पाबंदियां सिर्फ़ उस असली उपयोगकर्ता के लागू होने वाले लेन-देन के लिए लागू नहीं होती हैं.