Maps JavaScript API के लिए नीतियां और एट्रिब्यूशन

इस दस्तावेज़ में, Maps JavaScript API की मदद से बनाए गए ऐप्लिकेशन के लिए ज़रूरी शर्तें बताई गई हैं. ध्यान दें कि Maps JavaScript API का इस्तेमाल, Google के साथ हुए आपके कानूनी समझौते के मुताबिक किया जाता है.

नीतियां

इस सेक्शन में, Maps JavaScript API से जुड़ी नीतियों के बारे में बताया गया है. नीतियों में, सेवा को लागू करने के लिए व्यावहारिक दिशा-निर्देश और ज़रूरी शर्तें दी गई हैं. इनसे आपको सेवा का सही तरीके से इस्तेमाल करने में मदद मिलती है. साथ ही, Google Maps Platform की उम्मीदों के मुताबिक काम करने में मदद मिलती है.

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

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

कॉन्टेंट स्क्रैप करना

आपके ऐप्लिकेशन के साथ उपयोगकर्ता के इंटरैक्शन के आधार पर, आपको जगह का नाम दिखाया जा सकता है. अगर आपको उपयोगकर्ता सेशन के बाहर किसी अन्य संदर्भ में इस्तेमाल करने के लिए, जगह का नाम कैप्चर करना है या उसे सेव रखना है, तो यह स्क्रैपिंग माना जाएगा. हमारी शर्तों के मुताबिक, इसकी अनुमति नहीं है.

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

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

• ईईए में Google Maps Platform की सेवा की शर्तें
• ईईए में 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 के लोगो का इस्तेमाल करते समय, इन दिशा-निर्देशों का पालन करें.

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

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

• लोगो की कम से कम ऊंचाई: 16dp
• लोगो की ज़्यादा से ज़्यादा ऊंचाई: 19dp
• लोगो के आस-पास कम से कम खाली जगह: बाईं, दाईं, और ऊपर की ओर 10dp, नीचे की ओर 5dp

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

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

• लोगो और बैकग्राउंड के बीच सुलभ कंट्रास्ट बनाए रखें.
• 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 Platform के कॉन्टेंट को अन्य कॉन्टेंट से अलग दिखाने के लिए, यूज़र इंटरफ़ेस (यूआई) के संकेतों का इस्तेमाल करें. जैसे, बॉर्डर, बैकग्राउंड का रंग, शैडो या ज़रूरत के मुताबिक खाली जगह.

• Google Maps को किसी ऐसे कॉन्टेंट के साथ न दिखाएं जो Google Maps Platform का नहीं है.
• पुष्टि करें कि एट्रिब्यूशन हमेशा दिखता हो और उसे पढ़ा जा सके. इसे कभी भी हटाएं, छिपाएं, धुंधला न करें या इसमें बदलाव न करें.

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

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

मैपिंग से जुड़े हमारे प्रॉडक्ट में मौजूद कुछ डेटा और इमेज, Google के अलावा अन्य कंपनियों से मिलती हैं. Map Tiles API जैसे कुछ प्रॉडक्ट के लिए, हम आपको तीसरे पक्ष के डेटा की सेवा देने वाली कंपनी को ज़रूरी एट्रिब्यूशन देने की सुविधा दे सकते हैं. ऐसा करने पर, आपके एट्रिब्यूशन के टेक्स्ट में "Google Maps" और डेटा उपलब्ध कराने वाली कंपनियों के नाम शामिल होने चाहिए. जैसे, "मैप डेटा: Google, Maxar Technologies." जब Google तीसरे पक्ष का एट्रिब्यूशन देता है, तो सिर्फ़ "Google Maps" या Google का लोगो शामिल करना सही एट्रिब्यूशन नहीं होता.

एट्रिब्यूशन से जुड़ी अन्य ज़रूरी शर्तें

तीसरे पक्ष के एट्रिब्यूशन को वापस पाने और उन्हें अपने ऐप्लिकेशन में दिखाने के लिए, इन निर्देशों का पालन करें.

किसी जगह से एट्रिब्यूशन वापस पाना

अगर आपका ऐप्लिकेशन, Place.fetchFields को कॉल करके मिली समीक्षा की जानकारी दिखाता है, तो उसे जगह की जानकारी के लिए तीसरे पक्ष के एट्रिब्यूशन भी दिखाने होंगे.

एपीआई, Place ऑब्जेक्ट दिखाता है. Place ऑब्जेक्ट से एट्रिब्यूशन पाने के लिए, Place.attributions प्रॉपर्टी का इस्तेमाल करें. यह प्रॉपर्टी हर अनुरोध के साथ मिलती है. इसे फ़ील्ड के साथ बताने की ज़रूरत नहीं होती. यह प्रॉपर्टी, String ऑब्जेक्ट का List दिखाती है. अगर दिखाने के लिए कोई एट्रिब्यूशन नहीं है, तो यह null दिखाती है. यहां दिए गए उदाहरण के कोड में, किसी जगह की जानकारी पाने और एट्रिब्यूशन की सूची बनाने का तरीका बताया गया है.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

  

समीक्षा दिखाना

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

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

यहां दिए गए उदाहरण में, किसी जगह की जानकारी पाने, समीक्षाओं की जांच करने, और पहली समीक्षा का डेटा दिखाने का तरीका बताया गया है:

// Create a new Place instance.
const place = new Place({
    id: 'ChIJpyiwa4Zw44kRBQSGWKv4wgA', // Faneuil Hall Marketplace, Boston, MA
});

// Call fetchFields, passing 'reviews' and other needed fields.
await place.fetchFields({
    fields: ['displayName', 'formattedAddress', 'location', 'reviews'],
});

// Create an HTML container.
const content = document.createElement('div');
const title = document.createElement('div');
const rating = document.createElement('div');
const address = document.createElement('div');
const review = document.createElement('div');
const authorLink = document.createElement('a');

// If there are any reviews display the first one.
if (place.reviews && place.reviews.length > 0) {
    // Get info for the first review.
    const reviewRating = place.reviews[0].rating;
    const reviewText = place.reviews[0].text;
    const authorName = place.reviews[0].authorAttribution.displayName;
    const authorUri = place.reviews[0].authorAttribution.uri;

    // Safely populate the HTML.
    title.textContent = place.displayName || '';
    address.textContent = place.formattedAddress || '';
    rating.textContent = `Rating: ${reviewRating} stars`;
    review.textContent = reviewText || '';
    authorLink.textContent = authorName;
    authorLink.href = authorUri || '';
    authorLink.target = '_blank';

    content.appendChild(title);
    content.appendChild(address);
    content.appendChild(rating);
    content.appendChild(review);
    content.appendChild(authorLink);
} else {
    content.textContent = `No reviews were found for ${place.displayName}.`;
}

// Create an infoWindow to display the review.
infoWindow = new InfoWindow({
    content,
    ariaLabel: place.displayName,
});
index.js

जगहों की समीक्षाओं के लिए दस्तावेज़ देखें.

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

अगर आपका ऐप्लिकेशन फ़ोटो दिखाता है, तो आपको हर उस फ़ोटो के लिए लेखक का एट्रिब्यूशन दिखाना होगा जिसमें वह मौजूद है. किसी जवाब के Place ऑब्जेक्ट में मौजूद फ़ोटो की जानकारी, photos कलेक्शन में मौजूद होती है. जवाब में photos कलेक्शन जोड़ने के लिए, अनुरोध में photos डेटा फ़ील्ड शामिल करें.

फ़ोटो कलेक्शन का हर एलिमेंट, Photo का एक इंस्टेंस होता है. इसमें AuthorAttribution टाइप का authorAttributions कलेक्शन होता है. AuthorAttribution ऑब्जेक्ट के फ़ील्ड, स्ट्रिंग होते हैं. इनमें एट्रिब्यूशन के displayName, uri, और photoUri शामिल होते हैं. अगर दिखाने के लिए कोई एट्रिब्यूशन नहीं है, तो खाली स्ट्रिंग होती है.

जगह की फ़ोटो के लिए दस्तावेज़ देखें.

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

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

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

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

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

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

असली उपयोगकर्ता के पतों के लिए ऑटोकंप्लीट की सुविधा

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

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

एआई की मदद से जनरेट की गई खास जानकारी

अपने ऐप्लिकेशन में एआई की मदद से जनरेट की गई खास जानकारी दिखाते समय, आपको ये काम करने होंगे. इसमें किसी जगह, इलाके, और समीक्षाओं की खास जानकारी शामिल है:

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

एआई की मदद से जनरेट की गई खास जानकारी के बारे में बताने वाला टेक्स्ट दिखाएं

एआई की मदद से जनरेट की गई किसी भी तरह की खास जानकारी दिखाते समय, खास जानकारी के ठीक नीचे, स्थानीय भाषा में ज़ाहिर की गई जानकारी का टेक्स्ट (जवाब के मुख्य हिस्से के disclosureText फ़ील्ड में दिया गया है) हमेशा शामिल करें. एपीआई से मिली जानकारी के टेक्स्ट में कभी भी बदलाव न करें या उसे न बढ़ाएं.

जगह और इलाके की खास जानकारी के लिए अतिरिक्त ज़रूरी शर्तें

आपके ऐप्लिकेशन में दिखाई गई जगह और इलाके की खास जानकारी के साथ, यह टेक्स्ट और ज़रूरी लिंक होने चाहिए:

समीक्षा की खास जानकारी के लिए ज़रूरी शर्तें

आपके ऐप्लिकेशन में दिखाई गई समीक्षा की खास जानकारी के साथ, "समीक्षा की खास जानकारी" टेक्स्ट वाली हेडिंग होनी चाहिए. इसके अलावा, आपको यहां दिए गए टेक्स्ट और ज़रूरी लिंक का इस्तेमाल करना होगा:

ऑटोमोटिव के इस्तेमाल के उदाहरणों के लिए, डिसप्ले से जुड़े दिशा-निर्देश

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

• तीन से ज़्यादा लाइनें न हों
• 120 वर्ण या 24 शब्द या इससे कम
• फ़ॉन्ट का साइज़ कम से कम 24dp होना चाहिए

खास तौर पर, Automotive के संदर्भ में, यह डेवलपर की ज़िम्मेदारी है कि वह एआई की मदद से मिलने वाली खास जानकारी को इस तरह से रेंडर करे कि वह सुरक्षित हो और सभी स्थानीय नियमों और कानूनों का पालन करती हो.