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

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

नीतियां

इस सेक्शन में, Places SDK for Android से जुड़ी नीतियों के बारे में बताया गया है. नीतियों में, सेवा को लागू करने के लिए व्यावहारिक दिशा-निर्देश और ज़रूरी शर्तें दी गई हैं. इनसे आपको सेवा का सही तरीके से इस्तेमाल करने में मदद मिलती है. साथ ही, 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 ऑब्जेक्ट दिखाता है. Place ऑब्जेक्ट से एट्रिब्यूशन वापस पाने के लिए, Place.getAttributions() को कॉल करें. यह तरीका, String ऑब्जेक्ट का List दिखाता है. अगर दिखाने के लिए कोई एट्रिब्यूशन नहीं है, तो यह शून्य दिखाता है.

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, इसमें दो तरह के एट्रिब्यूशन हो सकते हैं:

• Attributions, एक एट्रिब्यूशन स्ट्रिंग है जिसे PhotoMetadata.getAttributions() से ऐक्सेस किया जाता है.
• AuthorAttributions, एक AuthorAttributions ऑब्जेक्ट है जिसे PhotoMetadata.getAuthorAttributions() से ऐक्सेस किया जाता है.

किसी फ़ोटो के लिए स्ट्रिंग एट्रिब्यूशन पाने के लिए, 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 आपको उससे जुड़े स्थानीय नतीजे दिखाएगा. मुख्य तौर पर काम की जानकारी, दूरी, और लोकप्रियता जैसी कई बातों के आधार पर, खोज के सबसे सटीक नतीजे दिखाए जाते हैं.

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

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

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

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 Maps Platform के कानूनी समझौते में Google Maps के कॉन्टेंट पर पाबंदियों के दायरे में नहीं आता. यह अपवाद, असली उपयोगकर्ता के चुने गए मोहल्ले के पते पर ही लागू होता है. साथ ही, यह सिर्फ़ उस असली उपयोगकर्ता के लेन-देन पर लागू होता है. यह अपवाद, अपने-आप पूरा होने की सुविधा से मिले पतों की सूची या Google Maps के अन्य कॉन्टेंट पर लागू नहीं होता. यह अपवाद, Google Maps Platform की अन्य सेवाओं से मिलने वाली किसी भी लोकप्रिय जगह या पते को खोजने की सुविधा पर लागू नहीं होता.

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