इस विषय में, Android के लिए Places SDK टूल की मदद से बनाए गए सभी ऐप्लिकेशन के लिए एट्रिब्यूशन की ज़रूरी शर्तों के बारे में बताया गया है. इनमें, उस एपीआई का हिस्सा बनी, जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सेवा भी शामिल है. Google Maps Platform की ज़्यादा शर्तों के लिए, Google Maps Platform की सेवा की शर्तें देखें.
नीतियां
इस सेक्शन में, Places SDK for Android से जुड़ी नीतियों के बारे में बताया गया है. नीतियों में, सेवा को सही तरीके से और 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 Maps पर दिखाया जाता है जहां एट्रिब्यूशन पहले से दिख रहा है, तो आपको अतिरिक्त एट्रिब्यूशन जोड़ने की ज़रूरत नहीं है.
Google Maps का एट्रिब्यूशन शामिल किया गया हो
Google Maps के उस एट्रिब्यूशन के लिए जो Google Maps Platform ने पहले से ही यूज़र इंटरफ़ेस में उपलब्ध कराया है, जैसे कि जगहों की जानकारी देने वाली यूआई किट में:
- शामिल किए गए एट्रिब्यूट को न हटाएं, भले ही वह कहीं भी दिखता हो. एट्रिब्यूशन में बदलाव न करें, उसे न छिपाएं और न ही उसे धुंधला करें. साथ ही, पक्का करें कि वह बैकग्राउंड के मुकाबले साफ़ तौर पर दिख रहा हो.
- यूज़र इंटरफ़ेस (यूआई) के लिए दिए गए निर्देशों का इस्तेमाल करके, 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
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 के टेक्स्ट को स्टाइल करने के लिए, यहां दी गई टेबल में बताए गए तरीके अपनाएं:
Google Maps पर टेक्स्ट स्टाइल से जुड़ी ज़रूरी शर्तें प्रॉपर्टी स्टाइल फ़ॉन्ट फ़ैमिली Roboto. फ़ॉन्ट लोड करना ज़रूरी नहीं है. फ़ॉलबैक फ़ॉन्ट फ़ैमिली आपके प्रॉडक्ट में पहले से इस्तेमाल किया जा रहा कोई भी सैंस-सरफ़़ (बिना शिरफ़़) बॉडी फ़ॉन्ट या डिफ़ॉल्ट सिस्टम फ़ॉन्ट को चालू करने के लिए "सैंस-सरफ़़" फ़ॉन्ट स्टाइल सामान्य फ़ॉन्ट की मोटाई 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 एट्रिब्यूशन को विज़ुअल तौर पर दिखाने के लिए, इन ज़रूरी शर्तों का पालन करें.एट्रिब्यूशन को कॉन्टेंट के ऊपर या नीचे, और उसी विज़ुअल कंटेनर में रखें. कॉन्टेंट की एक लाइन के लिए, एट्रिब्यूशन को दाईं या बाईं ओर रखा जा सकता है.
यूज़र इंटरफ़ेस (यूआई) के लिए दिए गए निर्देशों का इस्तेमाल करके, Google Maps Platform के कॉन्टेंट को अन्य कॉन्टेंट से अलग दिखाएं. जैसे, बॉर्डर, बैकग्राउंड का रंग, शैडो या ज़रूरत के मुताबिक खाली जगह.
- Google Maps को गलत तरीके से पेश न करें. इसके लिए, Google Maps Platform से बाहर के कॉन्टेंट का इस्तेमाल न करें.
- पुष्टि करें कि एट्रिब्यूशन हमेशा दिख रहा हो और उसे पढ़ा जा सकता हो. इसे कभी न हटाएं, छिपाएं, धुंधला करें या उसमें बदलाव न करें.
नीचे दिए गए उदाहरणों में, विज़ुअल से जुड़ी इन ज़रूरी शर्तों के बारे में बताया गया है.
तृतीय-पक्ष डेटा प्रदाता
हमारे मैपिंग प्रॉडक्ट पर मौजूद कुछ डेटा और इमेज, Google के अलावा अन्य कंपनियों से मिलती हैं. Map Tiles API जैसे कुछ प्रॉडक्ट के लिए, हम आपको तीसरे पक्ष के डेटा उपलब्ध कराने वाली कंपनी को ज़रूरी एट्रिब्यूशन दे सकते हैं. ऐसा करने पर, आपके एट्रिब्यूशन के टेक्स्ट में "Google Maps" और डेटा उपलब्ध कराने वाली कंपनी का नाम होना चाहिए. जैसे, "मैप का डेटा: Google, Maxar Technologies." जब Google, तीसरे पक्ष का एट्रिब्यूशन उपलब्ध कराता है, तो सिर्फ़ "Google Maps" या Google का लोगो शामिल करना, सही एट्रिब्यूशन नहीं है.
एट्रिब्यूशन से जुड़ी अन्य ज़रूरी शर्तें
तीसरे पक्ष के एट्रिब्यूशन को वापस पाने और अपने ऐप्लिकेशन में एट्रिब्यूशन दिखाने के लिए, इन निर्देशों का पालन करें.
किसी जगह से एट्रिब्यूशन पाना
अगर आपका ऐप्लिकेशन आईडी से जगह की जानकारी पाएं को कॉल करके मिली जानकारी दिखाता है, तो ऐप्लिकेशन को जगह की मिली जानकारी के लिए तीसरे पक्ष के एट्रिब्यूशन भी दिखाने होंगे.
एपीआई, Place ऑब्जेक्ट दिखाता है. Place ऑब्जेक्ट से एट्रिब्यूशन वापस पाने के लिए, Place.getAttributions() को कॉल करें.
यह तरीका, String ऑब्जेक्ट का List दिखाता है. अगर दिखाने के लिए कोई एट्रिब्यूशन नहीं है, तो यह तरीका null दिखाता है.
String placeId = "INSERT_PLACE_ID_HERE"; List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME); FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields); placesClient.fetchPlace(request).addOnSuccessListener((response) -> { Place place = response.getPlace(); textView.append("Place found: " + place.getName()); List<String> attributions = place.getAttributions(); if (attributions != null) { StringBuilder stringBuilder = new StringBuilder("Attributions: "); for (String attribution : attributions) { stringBuilder.append(attribution).append("\n"); } textView.append(stringBuilder.toString()); }}).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { // Handle the error. } } );
किसी फ़ोटो के लिए एट्रिब्यूशन दिखाना
अगर आपका ऐप्लिकेशन किसी जगह की फ़ोटो दिखाता है, तो आपको हर फ़ोटो के लिए एट्रिब्यूशन दिखाना होगा.
PhotoMetadata में, इनमें से कोई एक एट्रिब्यूशन शामिल हो सकता है:
- एट्रिब्यूशन, एक एट्रिब्यूशन स्ट्रिंग, जिसे
PhotoMetadata.getAttributions()से ऐक्सेस किया जाता है. - AuthorAttributions, एक ऐसा
AuthorAttributionsऑब्जेक्ट है जिसका ऐक्सेसPhotoMetadata.getAuthorAttributions()के पास होता है.
किसी फ़ोटो के लिए एट्रिब्यूशन वाली स्ट्रिंग पाने के लिए, PhotoMetadata.getAttributions() को कॉल करें. यह तरीका, एट्रिब्यूशन दिखाने के लिए, एचटीएमएल वर्ण क्रम या खाली स्ट्रिंग दिखाता है.
// Get the photo metadata from the Place object. PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0); // Get the attribution text. String attributions = photoMetadata.getAttributions();
किसी फ़ोटो के लिए, क्रिएटर का क्रेडिट पाने के लिए, PhotoMetadata.getAuthorAttributions() को कॉल करें. यह तरीका, AuthorAttributions ऑब्जेक्ट दिखाता है. इस ऑब्जेक्ट में AuthorAttribution ऑब्जेक्ट के List होते हैं. हर लेखक के एट्रिब्यूशन के लिए एक ऑब्जेक्ट होता है.
// Get the photo metadata from the Place object. PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0); // Get the author attributions object. AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions(); List<AuthorAttribution> authorAttributionList = authorAttributions.asList();
खोज के नतीजों के एट्रिब्यूशन
यूरोप में, Google की बिना किसी बदलाव वाली रैंकिंग का इस्तेमाल करते समय, खोज के नतीजों में दिखने वाले प्रॉडक्ट के लिए, एक क्लिक से ज़्यादा दूर नहीं होना चाहिए. इसमें, खोज के नतीजों की रैंकिंग तय करने वाले मुख्य फ़ैक्टर और उनके वज़न के बारे में बताने वाला एक्सप्लेनेटर टेक्स्ट होना चाहिए. ज़्यादा जानकारी देने वाला टेक्स्ट:
हेडर: इन नतीजों के बारे में जानकारी
मुख्य हिस्सा: अपने आस-पास के कारोबार या जगहें खोजने पर, Google Maps आपको स्थानीय नतीजे दिखाएगा. आपको सबसे सटीक नतीजे दिखाने के लिए, कई चीज़ों का ध्यान रखा जाता है. जैसे, वह कारोबार या जगह आपके कितने काम की है, वह कितनी दूरी पर है, और वह कितनी लोकप्रिय है.
पहला बटन: ज़्यादा जानें
"ज़्यादा जानें" टेक्स्ट, सहायता केंद्र के किसी लेख से लिंक होना चाहिए.
दूसरा बटन: ठीक है
समीक्षा दिखाना
Place ऑब्जेक्ट में ज़्यादा से ज़्यादा पांच समीक्षाएं हो सकती हैं. हर समीक्षा को Review ऑब्जेक्ट से दिखाया जाता है. आपके पास इन समीक्षाओं को अपने ऐप्लिकेशन में दिखाने का विकल्प होता है.
Google उपयोगकर्ताओं की दी गई समीक्षाएं दिखाते समय, आपको लेखक का नाम समीक्षा के आस-पास रखना होगा. हमारा सुझाव है कि अगर Review ऑब्जेक्ट के लेखक एट्रिब्यूशन फ़ील्ड में उपलब्ध हो, तो लेखक की फ़ोटो शामिल करें और उसकी प्रोफ़ाइल को भी लिंक करें. यहां दी गई इमेज में, किसी पार्क की समीक्षा का उदाहरण दिया गया है:
Google यह भी सुझाव देता है कि आप यह दिखाएं कि समीक्षाओं को उपयोगकर्ताओं के लिए किस तरह से क्रम में लगाया जा रहा है.
समीक्षाएं ऐक्सेस करने के लिए, कॉल करें
Place.getReviews():
// Specify the fields to return. final List<Place.Field> placeFields = Arrays.asList(Place.Field.REVIEWS); // Construct a request object, passing the place ID and fields array. final FetchPlaceRequest request = FetchPlaceRequest.newInstance("INSERT_PLACE_ID_HERE", placeFields); placesClient.fetchPlace(request).addOnSuccessListener((response) -> { Place place = response.getPlace(); List<Review> reviews = place.getReviews(); // For loop for iterating over the List for (int i = 0; i < reviews.size(); i++) { // For each review, get the Review object. Review placeReview = reviews.get(i); // Get any attribution and author attribution. String reviewAttribution = placeReview.getAttribution(); AuthorAttribution authorAttribution = placeReview.getAuthorAttribution(); // Display the review contents and attributions as necessary. } }).addOnFailureListener((exception) -> { if (exception instanceof ApiException) { // Handle the error. } });
तीसरे पक्ष के एट्रिब्यूशन दिखाना
तीसरे पक्ष की सेवा देने वाली कंपनियों के एट्रिब्यूशन में, एचटीएमएल फ़ॉर्मैट में कॉन्टेंट और लिंक होते हैं. आपको इन कॉन्टेंट और लिंक को उसी फ़ॉर्मैट में सेव करके उपयोगकर्ता को दिखाना चाहिए जिस फ़ॉर्मैट में ये उपलब्ध कराए गए हैं. Google का सुझाव है कि इस जानकारी को जगह की जानकारी के नीचे दिखाएं.
एपीआई, उन सभी जगहों के लिए एट्रिब्यूशन जनरेट करता है जिनका इस्तेमाल ऐप्लिकेशन करता है. एट्रिब्यूशन, हर जगह के हिसाब से नहीं, बल्कि हर एपीआई कॉल के हिसाब से दिए जाते हैं.
एट्रिब्यूशन दिखाने का एक तरीका,
TextView का इस्तेमाल करना है.
उदाहरण के लिए:
TextView attributionsText = (TextView) findViewById(R.id.attributions); String thirdPartyAttributions = place.getAttributions(); attributionsText.setText(thirdPartyAttributions);
तीसरे पक्ष के एट्रिब्यूशन का उदाहरण
Listings by <a href="https://www.example.com/">Example Company</a>
असली उपयोगकर्ता के पतों के लिए, अपने-आप पूरा होने की सुविधा
जब कोई असली उपयोगकर्ता, आपके ग्राहक के ऐप्लिकेशन में ऑटोकंप्लीट की सुविधा का इस्तेमाल करके, सड़क का पता डालता है और वह सड़क का पता, ऑटोकंप्लीट की सुविधा के बिना भी पूरी तरह से और सटीक तरीके से डाला जा सकता था, तो असली उपयोगकर्ता का चुना गया पता, आपके Google Maps Platform के कानूनी समझौते में बताई गई Google Maps के कॉन्टेंट से जुड़ी पाबंदियों के दायरे में नहीं आता. यह अपवाद सिर्फ़ असली उपयोगकर्ता के चुने गए पते पर लागू होता है. साथ ही, यह सिर्फ़ उस असली उपयोगकर्ता के खास लेन-देन पर लागू होता है. यह अपवाद, अपने-आप पूरा होने की सुविधा से सुझाए गए पतों की सूची या Google Maps के अन्य कॉन्टेंट पर लागू नहीं होता. यह अपवाद, Google Maps Platform की अन्य सेवाओं से मिलने वाली, किसी भी लोकप्रिय जगह या पते की जानकारी खोजने की सुविधा पर लागू नहीं होता.
पिछली इमेज में, बाईं ओर मौजूद पते की सूची पर अब भी Google Maps कॉन्टेंट से जुड़ी पाबंदियां लागू हैं. जब असली उपयोगकर्ता अपना चुना हुआ पता चुन लेता है, तो उस पते पर Google Maps कॉन्टेंट से जुड़ी पाबंदियां लागू नहीं होतीं. ऐसा सिर्फ़ उस असली उपयोगकर्ता के लागू होने वाले लेन-देन के मकसद से किया जाता है.