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

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

उपयोग की शर्तें और निजता नीति देना

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

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

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

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

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

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

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

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

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

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

Android के लिए Places SDK टूल के नतीजे दिखाना

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

अगर आपका ऐप्लिकेशन 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 ऑब्जेक्ट दिखाता है. 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() को कॉल करें. यह तरीका, एट्रिब्यूशन दिखाने के लिए, एचटीएमएल वर्ण क्रम या खाली स्ट्रिंग दिखाता है.

// 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 एट्रिब्यूशन के लिए स्टाइल के बारे में दिशा-निर्देश

अगर डाउनलोड किए जा सकने वाले 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;