Maps JavaScript API के लिए नीतियां

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

इस्तेमाल की शर्तें और निजता नीति देना

Maps JavaScript API ऐप्लिकेशन डेवलप करने पर, आपको अपने ऐप्लिकेशन के साथ इस्तेमाल की शर्तें और निजता नीति उपलब्ध कराना होगा. यह नीति, Google के साथ आपके कानूनी समझौते में बताए गए दिशा-निर्देशों के मुताबिक होनी चाहिए:

  • इस्तेमाल की शर्तें और निजता नीति सार्वजनिक तौर पर उपलब्ध होनी चाहिए.
  • आपको अपने ऐप्लिकेशन के इस्तेमाल की शर्तों में साफ़ तौर पर यह बताना होगा कि आपके ऐप्लिकेशन का इस्तेमाल करने पर, उपयोगकर्ताओं को Google की सेवा की शर्तों का पालन करना होगा.
  • आपको अपनी निजता नीति में उपयोगकर्ताओं को यह बताना होगा कि आपने Google Maps API का इस्तेमाल किया है. साथ ही, Google की निजता नीति को रेफ़रंस के तौर पर शामिल करना होगा.

इस्तेमाल की शर्तें और निजता नीति को उपलब्ध कराने के लिए सुझाई गई जगह, आपके ऐप्लिकेशन के प्लैटफ़ॉर्म पर निर्भर करती है.

मोबाइल ऐप्लिकेशन

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

वेब ऐप्लिकेशन

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

कॉन्टेंट को पहले से फ़ेच करना, कैश मेमोरी में सेव करना या स्टोर करना

Maps JavaScript API का इस्तेमाल करने वाले ऐप्लिकेशन, Google के साथ आपके समझौते की शर्तों के मुताबिक होते हैं. आपके समझौते की शर्तों के मुताबिक, आपको किसी भी कॉन्टेंट को पहले से फ़ेच, इंंडेक्स, स्टोर या कैश मेमोरी में सेव नहीं करना चाहिए. हालांकि, शर्तों में बताई गई सीमित शर्तों के तहत ऐसा किया जा सकता है.

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

Maps JavaScript API के नतीजे दिखाना

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

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

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

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

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

लेखक का एट्रिब्यूशन डिसप्ले

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

  // Use place ID to 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"],
  });

  // If there are any reviews display the first one.
  if (!place.reviews) {
      console.log('No reviews were found.');
  } else {
      // Log the review count so we can see how many there are.
      console.log("REVIEW COUNT: " + place.reviews.length);

      // Get info for the first review.
      let reviewRating = place.reviews[0].rating;
      let reviewText = place.reviews[0].text;
      let authorName = place.reviews[0].authorAttribution.displayName;
      let authorUri = place.reviews[0].authorAttribution.uri;

      // Create a bit of HTML to add to the info window
      const contentString =
        '<div id="title"><b>' + place.displayName + '</b></div>' +
        '<div id="address">' + place.formattedAddress + '</div>' +
        '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' +
        '<div id="rating">Rating: ' + reviewRating + ' stars</div>' +
        '<div id="rating""><p>Review: ' + reviewText + '</p></div>';

      // Create an info window.
      infoWindow = new InfoWindow({
          content: contentString,
          ariaLabel: place.displayName,
      });

      // Add a marker for the place.
      const marker = new AdvancedMarkerElement({
          map,
          position: place.location,
          title: place.displayName,
      });

      // Show the info window.
      infoWindow.open({
          anchor: marker,
          map,
      });
  }

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

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

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

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

जगहों की फ़ोटो से जुड़ा दस्तावेज़ देखें.

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

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

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

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

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

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

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;