Android के लिए स्थल SDK से जुड़ी नीतियां

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

इस्तेमाल की शर्तें और निजता नीति उपलब्ध कराना

अगर आपने Android ऐप्लिकेशन के लिए Places SDK टूल डेवलप किया है, तो आपको अपने ऐप्लिकेशन के साथ इस्तेमाल की शर्तें और निजता नीति उपलब्ध करानी होगी जो Google के साथ आपके कानूनी समझौते में बताए गए दिशा-निर्देशों का पालन करती हो:

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

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

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

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

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

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

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

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

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

Android परिणामों के लिए स्थल SDK दिखाए जा रहे हैं

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

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

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

Google लोगो को मैप के सबसे नीचे बाएं कोने में होना चाहिए. एट्रिब्यूशन की जानकारी नीचे दाएं कोने में होनी चाहिए. ये दोनों जानकारी पूरे मैप पर होनी चाहिए, न कि मैप के नीचे या ऐप्लिकेशन में किसी अन्य जगह पर. नीचे दिए गए मैप के उदाहरण में, मैप के नीचे बाईं ओर Google लोगो और नीचे दाईं ओर एट्रिब्यूशन दिखाया गया है.

नीति एट्रिब्यूशन प्लेसमेंट

नीचे दी गई ZIP फ़ाइल में डेस्कटॉप, Android, और iOS ऐप्लिकेशन के लिए Google का लोगो सही साइज़ में है. आप किसी भी तरह से इन लोगो का साइज़ नहीं बदल सकते या उनमें बदलाव नहीं कर सकते.

डाउनलोड करें: google_logo.zip

एट्रिब्यूशन में बदलाव न करें. एट्रिब्यूशन की जानकारी को न तो हटाएं और न ही उसे धुंधला करें और न ही उसे काटें. Google के लोगो को इनलाइन में इस्तेमाल नहीं किया जा सकता. उदाहरण के लिए, "ये मैप [Google_logo] से लिए गए हैं".

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

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

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

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

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

किसी स्थान से विशेषता प्राप्त करना

अगर आपका ऐप्लिकेशन, आईडी के ज़रिए जगह की जानकारी पाएं पर कॉल करके मिली जानकारी दिखाता है, तो ऐप्लिकेशन में ली गई जगह की जानकारी के लिए तीसरे पक्ष की जानकारी भी दिखाई जानी चाहिए.

एपीआई, Place ऑब्जेक्ट दिखाता है. Place ऑब्जेक्ट से एट्रिब्यूशन पाने के लिए, Place.getAttributions() को कॉल करें. अगर दिखाने के लिए कोई एट्रिब्यूशन नहीं है, तो यह तरीका String ऑब्जेक्ट का List या शून्य दिखाता है.

String placeId = "INSERT_PLACE_ID_HERE";
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.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() को कॉल करें. अगर दिखाने के लिए कोई एट्रिब्यूशन नहीं है, तो यह तरीका एक एचटीएमएल वर्ण अनुक्रम या एक खाली स्ट्रिंग दिखाता है.

// 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 ऑब्जेक्ट दिखाता है. इस ऑब्जेक्ट में, हर लेखक एट्रिब्यूशन के लिए एक List AuthorAttribution ऑब्जेक्ट मौजूद है.

// 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();

समीक्षा दिखाएं

किसी 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 एट्रिब्यूशन के लिए स्टाइल से जुड़े दिशा-निर्देश

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

खाली जगह

लॉकअप के आस-पास की खाली जगह, Google में "G" की ऊंचाई के बराबर या उससे ज़्यादा होनी चाहिए.

एट्रिब्यूशन कॉपी और Google लोगो के बीच की जगह, "G" की चौड़ाई से आधी होनी चाहिए.

पढ़ने में आसानी

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

रंग

सफ़ेद या हल्के रंग के बैकग्राउंड पर Google मटीरियल स्लेटी 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;