iOS के लिए स्थल SDK से जुड़ी नीतियां

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

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

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

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

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

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

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

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

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

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

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

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

iOS परिणामों के लिए Places SDK टूल दिखाना

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

अगर आपका ऐप्लिकेशन Google मैप पर डेटा दिखाता है, तो Google लोगो को शामिल किया जाएगा और इसमें कोई बदलाव नहीं किया जा सकता. जो ऐप्लिकेशन Google मैप वाली स्क्रीन पर ही 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 की तरह ही ऐक्सेस और दिखाया जा सकता है.

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

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

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

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

समीक्षा दिखाएं

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

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

लेखक एट्रिब्यूशन डिसप्ले

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

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

Swift

// 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.

  }
})

Objective-C

// 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 पर ऐक्सेस देने का विकल्प सेट करें और YES वापस करने के लिए, अपने UITextViewDelegate के shouldInteractWithURL तरीके को सेट करें.

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 एट्रिब्यूट के तहत कवर किया गया है.

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;