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

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

नीतियां

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

डेटा स्टोरेज, कैश मेमोरी, और स्क्रैपिंग

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

  • कैश मेमोरी में सेव करने और स्क्रैप करने से जुड़ी पाबंदियां (सेक्शन 3.2.3(a) और (b)): Google Maps के कॉन्टेंट को कैश मेमोरी में सेव या स्टोर सिर्फ़ तब करें, जब Google Maps Platform की सेवा से जुड़ी खास शर्तों के तहत इसकी अनुमति दी गई हो. Google Maps के कॉन्टेंट को सेवाओं से बाहर इस्तेमाल करने के लिए, उसे एक्सपोर्ट, एक्सट्रैक्ट या स्क्रैप न करें. उदाहरण के लिए, सेवाओं के बाहर Google Maps के कॉन्टेंट को पहले से फ़ेच, इंडेक्स, स्टोर या फिर से डिस्ट्रिब्यूट न करें. साथ ही, मैप टाइल, Street View की इमेज, जियोकोड, निर्देश, दूरी के मैट्रिक्स के नतीजे, सड़कों की जानकारी, जगहों की जानकारी, ऊंचाई की वैल्यू या टाइम ज़ोन की जानकारी को एक साथ डाउनलोड न करें. इसके अलावा, कारोबार के नाम, पते या उपयोगकर्ताओं की समीक्षाओं को कॉपी और सेव न करें.
  • डेरिवेटिव कॉन्टेंट पर पाबंदियां (सेक्शन 3.2.3(c)): अपने ऐप्लिकेशन में Google Maps के कॉन्टेंट का इस्तेमाल, Google Maps Platform की सेवा की शर्तों के मुताबिक करें. Google Maps के कॉन्टेंट के आधार पर कॉन्टेंट न बनाएं. उदाहरण के लिए, सैटलाइट से ली गई तस्वीरों से सुविधाओं को ट्रेस या डिजिटाइज़ न करें, 3D या इलाके के मॉडल न बनाएं, पॉइंट-इन-पॉलीगॉन विश्लेषण के लिए इनपुट के तौर पर जगहों के अक्षांश और देशांतर की वैल्यू का इस्तेमाल न करें, Street View की तस्वीरों से जगह का इंडेक्स न बनाएं या टेक्स्ट के तौर पर मौजूद ड्राइविंग के समय को सिंथसाइज़्ड स्पीच में न बदलें.

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

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

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

Google Maps Platform की सेवा से जुड़ी खास शर्तों के तहत, कैश मेमोरी में सेव करने से जुड़ी ये सीमित छूट मिलती हैं:

  • जगह के आईडी: जगह के आईडी का इस्तेमाल, किसी जगह की खास तौर पर पहचान करने के लिए किया जाता है. इस पर कैश मेमोरी में सेव करने से जुड़ी पाबंदियां लागू नहीं होतीं. इसलिए, जगह के आईडी की वैल्यू को अनिश्चित समय तक सेव किया जा सकता है. एपीआई से मिली जानकारी में, जगह के आईडी id या place_id फ़ील्ड में दिखते हैं. जगह के आईडी की गाइड में, जगह के आईडी सेव करने, रीफ़्रेश करने, और मैनेज करने का तरीका जानें.
  • अक्षांश और देशांतर के निर्देशांक: अक्षांश (latitude) और देशांतर (longitude) की वैल्यू को लगातार 30 कैलेंडर दिनों तक कैश मेमोरी में सेव किया जा सकता है. इसके बाद, आपको कैश मेमोरी में सेव किए गए निर्देशांकों को मिटाना होगा. ऐसा तब करना होगा, जब ऐसी सेवाओं का इस्तेमाल किया जा रहा हो जो Google Maps Platform की सेवा की खास शर्तों में इस अपवाद को अनुमति देती हैं:
    • Routes API, Route Optimization API, Directions API (लेगसी), और Roads API
    • Geocoding API, Geolocation API, और Address Validation API
    • Places API, जगहों की जानकारी देने वाली यूआई किट, और Navigation SDK
  • सेवा के हिसाब से कैश मेमोरी में डेटा सेव रखने की अवधि: Google Maps Platform की सेवा की खास शर्तें, फ़ील्ड के हिसाब से कैश मेमोरी में डेटा सेव रखने की अवधि और Address Validation API, Air Quality API, Pollen API, Solar API, Weather API, और Places Aggregate API के लिए, अनुमति वाले मकसद भी तय करती हैं.

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

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

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

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

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

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

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

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

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

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

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 के लोगो के एट्रिब्यूशन के लिए, स्वीकार किए जाने वाले वैरिएशन के उदाहरण

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

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

Google Maps के एट्रिब्यूशन की ऐसेट डाउनलोड करना

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

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

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

Google Maps के लोगो के लिए, साइज़ से जुड़ी इन ज़रूरी शर्तों का पालन करें:
  • लोगो की कम से कम ऊंचाई: 16dp
  • लोगो की ज़्यादा से ज़्यादा ऊंचाई: 19dp
  • लोगो के आस-पास कम से कम खाली जगह: बाईं, दाईं, और ऊपर की ओर 10dp, नीचे की ओर 5dp

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

Google Maps का लोगो, जिसमें कम से कम खाली जगह और स्वीकार किए जाने वाले साइज़ की रेंज दिखाई गई है
Google Maps के लोगो का उदाहरण, जिसमें लोगो के आस-पास कम से कम खाली जगह और लोगो के लिए स्वीकार किए जाने वाले साइज़ की रेंज दिखाई गई है

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

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

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

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

Google Maps के टेक्स्ट एट्रिब्यूशन के स्वीकार किए जाने वाले वैरिएशन
Google Maps के टेक्स्ट एट्रिब्यूशन के स्वीकार किए जाने वाले वैरिएशन के उदाहरण
  • Google Maps टेक्स्ट में किसी भी तरह का बदलाव न करें:
    • Google Maps के कैपिटल लेटर में बदलाव न करें
    • Google Maps को एक से ज़्यादा लाइनों में न बांटें
    • Google Maps को किसी दूसरी भाषा में स्थानीय भाषा के हिसाब से न बनाएं.
    • एचटीएमएल एट्रिब्यूट translate="no" का इस्तेमाल करके, ब्राउज़र को Google Maps का अनुवाद करने से रोकें.
Google Maps के टेक्स्ट एट्रिब्यूशन के अमान्य वर्शन
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 Maps का कॉन्टेंट न बताएं.
  • पुष्टि करें कि एट्रिब्यूशन हमेशा दिखता हो और उसे पढ़ा जा सके. इसे कभी भी न हटाएं, न छिपाएं, न धुंधला करें, और न ही इसमें बदलाव करें.

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

कॉन्टेंट के सबसे ऊपर, सबसे नीचे, और बगल में मौजूद Google Maps एट्रिब्यूशन का उदाहरण
कॉन्टेंट के ऊपर, नीचे, और बगल में Google Maps एट्रिब्यूशन का उदाहरण

Google Maps के कॉन्टेंट (जगह की रेटिंग) को अन्य कॉन्टेंट से अलग दिखाने के दो तरीकों का उदाहरण
Google Maps के कॉन्टेंट (जगह की रेटिंग) को अन्य कॉन्टेंट से अलग करने के दो तरीकों का उदाहरण

Google Maps के एट्रिब्यूशन को न छिपाएं या उसे अन्य सोर्स के कॉन्टेंट के साथ न मिलाएं
Google Maps एट्रिब्यूशन को न छिपाएं या इसे अन्य सोर्स के कॉन्टेंट के साथ न मिलाएं

तृतीय-पक्ष डेटा प्रदाता

मैपिंग से जुड़े हमारे प्रॉडक्ट में मौजूद कुछ डेटा और इमेज, 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 के कॉन्टेंट से जुड़ी पाबंदियां लागू नहीं होती हैं. ऐसा सिर्फ़ उस असली उपयोगकर्ता के लागू लेन-देन के लिए होता है.