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 के लिए Places SDK के नतीजों को Google Maps पर या मैप के बिना दिखाया जा सकता है. अगर आपको मैप पर, Places SDK for iOS के नतीजे दिखाने हैं, तो ये नतीजे Google Maps पर दिखाए जाने चाहिए. iOS के लिए Places SDK के डेटा का इस्तेमाल, Google Maps के अलावा किसी दूसरे मैप पर करने की अनुमति नहीं है.

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

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

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

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

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

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

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

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

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

अगर आपका ऐप्लिकेशन फ़ोटो दिखाता है, तो आपको उन सभी फ़ोटो के लिए कोई 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;
}

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

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

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

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

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

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

जगह खाली करना

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

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

समझने में आसान

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

रंग

Google Material Gray 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;