इस दस्तावेज़ में उन सभी ऐप्लिकेशन के लिए ज़रूरी शर्तें दी गई हैं जिन्हें Places SDK for iOS की मदद से डेवलप किया गया है. इनमें, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा भी शामिल है, जो उस एपीआई का हिस्सा है. 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 के एट्रिब्यूशन की ज़रूरी शर्तें
इस सेक्शन में, आपके ऐप्लिकेशन में Google Maps और कॉन्टेंट दिखाने के लिए, एट्रिब्यूशन की ज़रूरी शर्तों और दिशा-निर्देशों के बारे में बताया गया है.
एट्रिब्यूशन का उदाहरण
जगहों की जानकारी देने वाली यूआई किट के लिए, एट्रिब्यूशन का एक उदाहरण यहां दिया गया है.
Google Maps एट्रिब्यूशन दिखाना
अपने ऐप्लिकेशन या वेबसाइट पर Google Maps Platform API से कॉन्टेंट दिखाते समय, आपको Google Maps के एट्रिब्यूशन की ज़रूरी शर्तों का पालन करना होगा. अगर कॉन्टेंट को Google मैप पर दिखाया जाता है, तो आपको अलग से एट्रिब्यूशन जोड़ने की ज़रूरत नहीं है. ऐसा इसलिए, क्योंकि Google मैप पर एट्रिब्यूशन पहले से ही दिखता है.
Google Maps एट्रिब्यूशन शामिल किया गया
Google Maps Platform, जगहों की जानकारी देने वाली यूआई किट जैसे यूज़र इंटरफ़ेस में Google Maps के एट्रिब्यूशन पहले से उपलब्ध कराता है. इसके लिए:
- एट्रिब्यूशन को न हटाएं, भले ही वह कहीं भी दिखाया गया हो. एट्रिब्यूशन में बदलाव न करें, उसे छिपाएं नहीं या उसे धुंधला न करें. साथ ही, पक्का करें कि वह बैकग्राउंड में साफ़ तौर पर दिख रहा हो.
- Google Maps Platform के कॉन्टेंट को अन्य कॉन्टेंट से अलग दिखाने के लिए, यूज़र इंटरफ़ेस (यूआई) के संकेतों का इस्तेमाल करें. जैसे, बॉर्डर, बैकग्राउंड का रंग, शैडो या खाली जगह.
- विज़ुअल में बदलाव करते समय, आपको Google Maps के एट्रिब्यूशन की सभी ज़रूरी शर्तों का पालन करना होगा.
Google Maps का लोगो और टेक्स्ट एट्रिब्यूशन
जहां भी संभव हो, एट्रिब्यूशन के लिए Google Maps के लोगो का इस्तेमाल किया जाना चाहिए. अगर जगह कम है, तो Google Maps टेक्स्ट का इस्तेमाल किया जा सकता है. असली उपयोगकर्ताओं को हमेशा यह साफ़ तौर पर पता होना चाहिए कि कौनसा कॉन्टेंट Google Maps से मिला है.
लोगो एट्रिब्यूशन
अपने ऐप्लिकेशन या वेबसाइट में Google Maps के लोगो का इस्तेमाल करने के लिए, इन ज़रूरी शर्तों का पालन करें.Google Maps के लोगो डाउनलोड करना
Google Maps के आधिकारिक लोगो की फ़ाइलों का इस्तेमाल करें. यहां दिए गए लोगो डाउनलोड करें और इस सेक्शन में दिए गए दिशा-निर्देशों का पालन करें.
Google Maps की एट्रिब्यूशन ऐसेट डाउनलोड करनाGoogle Maps के लोगो का इस्तेमाल करते समय, इन दिशा-निर्देशों का पालन करें.
- लोगो में किसी भी तरह का बदलाव न करें.
- लोगो का आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) बनाए रखें, ताकि वह खराब न दिखे.
- मैप या इमेज जैसे मिले-जुले पैटर्न वाले बैकग्राउंड पर, आउटलाइन वाले लोगो का इस्तेमाल करें.
- बिना आउटलाइन वाले लोगो का इस्तेमाल, सादे बैकग्राउंड पर करें. जैसे, कोई सॉलिड कलर या हल्का ग्रेडिएंट.
लोगो के साइज़ से जुड़ी ज़रूरी शर्तें
Google Maps के लोगो के लिए, साइज़ से जुड़ी इन ज़रूरी शर्तों का पालन करें:- लोगो की कम से कम ऊंचाई: 16dp
- लोगो की ज़्यादा से ज़्यादा ऊंचाई: 19dp
- लोगो के आस-पास कम से कम खाली जगह: बाईं, दाईं, और ऊपर की ओर 10dp, नीचे की ओर 5dp
डीपी के बारे में जानने के लिए, मटीरियल डिज़ाइन की वेबसाइट पर पिक्सल डेंसिटी देखें.
लोगो की सुलभता
Google Maps के लोगो के लिए, सुलभता से जुड़ी इन ज़रूरी शर्तों का पालन करें:- लोगो और बैकग्राउंड के बीच सुलभ कंट्रास्ट बनाए रखें.
- Google Maps टेक्स्ट के साथ सुलभता लेबल शामिल करें.
टेक्स्ट एट्रिब्यूशन
अगर आपके इंटरफ़ेस का साइज़, Google Maps के लोगो के इस्तेमाल के मुताबिक नहीं है, तो टेक्स्ट में Google Maps लिखा जा सकता है. इन दिशानिर्देशों का पालन करें:
- Google Maps टेक्स्ट में किसी भी तरह का बदलाव न करें:
- Google Maps के कैपिटल लेटर में बदलाव न करें
- Google Maps को एक से ज़्यादा लाइनों में न लिखें
- Google Maps को किसी दूसरी भाषा में स्थानीय भाषा के हिसाब से न बनाएं.
- एचटीएमएल एट्रिब्यूट
translate="no"का इस्तेमाल करके, ब्राउज़र को Google Maps का अनुवाद करने से रोकें.
Google Maps के टेक्स्ट को स्टाइल करने के लिए, यहां दी गई टेबल में बताया गया तरीका अपनाएं:
Google Maps पर टेक्स्ट-स्टाइलिंग से जुड़ी ज़रूरी शर्तें प्रॉपर्टी स्टाइल फ़ॉन्ट फ़ैमिली Roboto. फ़ॉन्ट लोड करना ज़रूरी नहीं है. फ़ॉलबैक फ़ॉन्ट फ़ैमिली आपके प्रॉडक्ट में पहले से इस्तेमाल किया गया कोई भी sans serif बॉडी फ़ॉन्ट या डिफ़ॉल्ट सिस्टम फ़ॉन्ट को शुरू करने के लिए "Sans-Serif" फ़ॉन्ट स्टाइल सामान्य फ़ॉन्ट की मोटाई 400 फ़ॉन्ट का रंग सफ़ेद, काला (#1F1F1F) या स्लेटी (#5E5E5E). बैकग्राउंड के मुकाबले, ऐक्सेस किए जा सकने वाले (4.5:1) कंट्रास्ट को बनाए रखें. फ़ॉन्ट का साइज़ फ़ॉन्ट का साइज़ कम से कम: 12एसपी
फ़ॉन्ट का साइज़ ज़्यादा से ज़्यादा: 16एसपी
एसपी के बारे में जानने के लिए, 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 के एट्रिब्यूशन को विज़ुअल तौर पर दिखाने के लिए, इन ज़रूरी शर्तों को पूरा करें.एट्रिब्यूशन को कॉन्टेंट के सबसे ऊपर या सबसे नीचे और उसी विज़ुअल कंटेनर में रखें. कॉन्टेंट की एक लाइन के लिए, एट्रिब्यूशन को दाईं या बाईं ओर रखा जा सकता है.
Google Maps Platform के कॉन्टेंट को अन्य कॉन्टेंट से अलग दिखाने के लिए, यूज़र इंटरफ़ेस (यूआई) के संकेतों का इस्तेमाल करें. जैसे, बॉर्डर, बैकग्राउंड का रंग, शैडो या ज़रूरत के मुताबिक खाली जगह.
- Google Maps को किसी ऐसे कॉन्टेंट के साथ न दिखाएं जो Google Maps Platform का नहीं है.
- पुष्टि करें कि एट्रिब्यूशन हमेशा दिखता हो और उसे पढ़ा जा सके. इसे कभी भी हटाएं, छिपाएं, धुंधला न करें या इसमें बदलाव न करें.
यहां दिए गए उदाहरणों में, विज़ुअल से जुड़ी इन ज़रूरी शर्तों के बारे में बताया गया है.
तृतीय-पक्ष डेटा प्रदाता
मैपिंग से जुड़े हमारे प्रॉडक्ट में मौजूद कुछ डेटा और इमेज, Google के अलावा अन्य कंपनियों से मिलती हैं. Map Tiles API जैसे कुछ प्रॉडक्ट के लिए, हम आपको तीसरे पक्ष के डेटा की सेवा देने वाली कंपनी को ज़रूरी एट्रिब्यूशन देने की सुविधा दे सकते हैं. ऐसा करने पर, आपके एट्रिब्यूशन के टेक्स्ट में "Google Maps" और डेटा उपलब्ध कराने वाली कंपनियों के नाम शामिल होने चाहिए. जैसे, "मैप डेटा: Google, Maxar Technologies." जब Google तीसरे पक्ष का एट्रिब्यूशन देता है, तो सिर्फ़ "Google Maps" या Google का लोगो शामिल करना सही एट्रिब्यूशन नहीं होता.
एट्रिब्यूशन से जुड़ी अन्य ज़रूरी शर्तें
तीसरे पक्ष के सेवा देने वाले लोगों या कंपनियों के एट्रिब्यूशन में, ऐसा कॉन्टेंट और लिंक शामिल होते हैं जिन्हें आपको उपयोगकर्ता को उसी फ़ॉर्मैट में दिखाना चाहिए जिसमें वे उपलब्ध कराए गए हैं. Google का सुझाव है कि आपका ऐप्लिकेशन, जगह की जानकारी के नीचे यह जानकारी दिखाए.
एपीआई से मिले तीसरे पक्ष के एट्रिब्यूशन में, Google एट्रिब्यूशन शामिल नहीं होता. आपको यह एट्रिब्यूशन खुद शामिल करना होगा, जैसा कि Google का लोगो और एट्रिब्यूशन दिखाना में बताया गया है.
किसी एक जगह या जगहों के कलेक्शन के लिए, तीसरे पक्ष के एट्रिब्यूशन को वापस पाने के लिए, इन निर्देशों का पालन करें.
किसी एक जगह के लिए एट्रिब्यूशन की जानकारी पाना
आईडी की मदद से किसी जगह की जानकारी पाने पर, आपको GMSPlace पर attributions प्रॉपर्टी से उस जगह के एट्रिब्यूशन मिल सकते हैं.
attributions को NSAttributedString ऑब्जेक्ट के तौर पर दिया जाता है.
जगहों के कलेक्शन के लिए एट्रिब्यूशन पाना
अगर आपका ऐप्लिकेशन, डिवाइस की मौजूदा जगह की जानकारी का अनुरोध करके, उससे मिली जानकारी दिखाता है, तो ऐप्लिकेशन को जगह की जानकारी के लिए तीसरे पक्ष के एट्रिब्यूशन दिखाने होंगे. अनुरोध में मिली सभी जगहों के एट्रिब्यूशन को,
GMSPlaceLikelihoodList पर मौजूद attributions प्रॉपर्टी से वापस पाया जा सकता है.
attributions को NSAttributedString ऑब्जेक्ट के तौर पर उपलब्ध कराया जाता है. इसे एक ही जगह पर attributions की तरह ऐक्सेस और दिखाया जा सकता है, जैसा कि ऊपर बताया गया है.
खोज के नतीजों के एट्रिब्यूशन
यूरोप में, Google की ओर से तय की गई रैंकिंग का इस्तेमाल करते समय, खोज के नतीजों में दिखने वाले प्रॉडक्ट के बारे में जानकारी देने वाला टेक्स्ट, एक क्लिक से ज़्यादा दूर नहीं होना चाहिए. इस टेक्स्ट में, खोज के नतीजों की रैंकिंग तय करने वाले मुख्य फ़ैक्टर और उनके महत्व के बारे में बताया जाना चाहिए. ज़्यादा जानकारी देने वाला टेक्स्ट:
हेडर: इन नतीजों के बारे में जानकारी
मुख्य हिस्सा: किसी जगह के आस-पास मौजूद कारोबार या जगहें खोजने पर, Google Maps आपको उससे जुड़े स्थानीय नतीजे दिखाएगा. मुख्य तौर पर काम की जानकारी, दूरी, और लोकप्रियता जैसी कई बातों के आधार पर, खोज के सबसे सटीक नतीजे दिखाए जाते हैं.
बटन 1: ज़्यादा जानें
"ज़्यादा जानें" टेक्स्ट को सहायता केंद्र के लेख से लिंक किया जाना चाहिए.
दूसरा बटन: ठीक है
किसी फ़ोटो के लिए एट्रिब्यूशन दिखाना
अगर आपका ऐप्लिकेशन फ़ोटो दिखाता है, तो आपको हर उस फ़ोटो के लिए 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 पर एक डेलिगेट सेट करें. साथ ही, 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 की लिस्टिंग
ऊपर दिए गए उदाहरण में, Example Company टेक्स्ट रेंज को NSLink एट्रिब्यूट से कवर किया गया है.
असली उपयोगकर्ता के पतों के लिए ऑटोकंप्लीट की सुविधा
जब कोई असली उपयोगकर्ता, आपके ग्राहक ऐप्लिकेशन में ऑटोकंप्लीट की सुविधा का इस्तेमाल करके, मोहल्ले का पता टाइप करता है और वह पता, ऑटोकंप्लीट की सुविधा के बिना भी असली उपयोगकर्ता ने पूरी तरह और सटीक तरीके से दिया होता, तो असली उपयोगकर्ता का चुना गया पता, आपके Google Maps Platform के कानूनी समझौते में Google Maps के कॉन्टेंट पर पाबंदियों के दायरे में नहीं आता. यह अपवाद, असली उपयोगकर्ता के चुने गए मोहल्ले के पते पर ही लागू होता है. साथ ही, यह सिर्फ़ उस असली उपयोगकर्ता के लेन-देन पर लागू होता है. यह अपवाद, अपने-आप पूरा होने की सुविधा से मिले पतों की सूची या Google Maps के अन्य कॉन्टेंट पर लागू नहीं होता. यह अपवाद, Google Maps Platform की अन्य सेवाओं से मिलने वाली किसी भी लोकप्रिय जगह या पते को खोजने की सुविधा पर लागू नहीं होता.

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