खास जानकारी

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript वेब सेवा

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

अगर आपका बिलिंग पता यूरोपियन इकनॉमिक एरिया में है, तो 8 जुलाई 2025 से, सेवाओं के आपके इस्तेमाल पर Google Maps Platform की ईईए से जुड़ी सेवा की शर्तें लागू होंगी. यह सुविधा, देश/इलाके के हिसाब से अलग-अलग हो सकती है. ज़्यादा जानें.

शुरू करने से पहले: Places SDK for Android का इस्तेमाल शुरू करने से पहले, आपके पास बिलिंग खाते वाला एक प्रोजेक्ट होना चाहिए. साथ ही, Places API की सुविधा चालू होनी चाहिए. हमारा सुझाव है कि आप एक से ज़्यादा प्रोजेक्ट के मालिक और बिलिंग एडमिन बनाएं, ताकि आपकी टीम के पास हमेशा इन भूमिकाओं वाले लोग उपलब्ध रहें. ज़्यादा जानने के लिए, Cloud Console में सेट अप करना लेख पढ़ें.

परिचय

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

ध्यान दें: Places SDK (नया), Android के लिए Places SDK का मौजूदा वर्शन है. लेगसी दस्तावेज़ और माइग्रेशन गाइड, लेगसी टैब पर उपलब्ध हैं.

कॉन्सेप्ट

यहां दिए गए इंटरफ़ेस, Android के लिए Places SDK में मुख्य एंट्री पॉइंट उपलब्ध कराते हैं:

• Places Google के स्थानीय जगह और कारोबार की जानकारी के डेटाबेस के साथ-साथ, डिवाइस की मौजूदा जगह की जानकारी को प्रोग्राम के हिसाब से ऐक्सेस करने की सुविधा देता है.
• Autocomplete उपयोगकर्ता की खोज क्वेरी के जवाब में, जगह के बारे में अनुमानित जानकारी देने के लिए, पहले से बने विजेट उपलब्ध कराता है.

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

ध्यान दें: जब भी आपका ऐप्लिकेशन, Android के लिए Places SDK से मिली जगहों की जानकारी दिखाता है, तब उसे एपीआई से मिले सभी ज़रूरी एट्रिब्यूशन भी दिखाने चाहिए. एट्रिब्यूशन दिखाने के बारे में जानकारी देने वाला दस्तावेज़ देखें.

एपीआई के बारे में खास जानकारी

अपने ग्राहकों को यह जानने में मदद करें कि वे कहां हैं और उनके आस-पास क्या है:

• जगह के नाम अपने-आप पूरे होने की सुविधा उपयोगकर्ताओं के टाइप करते ही, जगह का नाम और/या पता अपने-आप भर देती है.
• जगह की जानकारी, किसी जगह के बारे में ज़्यादा जानकारी दिखाता है.
• आस-पास की जगहों की जानकारी, किसी जगह और खोज के दायरे के आधार पर जगहों की सूची दिखाती है.
• Place Photos, किसी जगह की अच्छी क्वालिटी वाली इमेज दिखाता है.
• टेक्स्ट से खोजें, खोज के लिए इस्तेमाल की गई टेक्स्ट स्ट्रिंग के आधार पर जगहों की जानकारी दिखाता है.
• जगह के आईडी में, एक या उससे ज़्यादा जगहों के यूनीक आईडी सेव किए जाते हैं. इससे, मांग पर जगह की जानकारी को वापस पाया जा सकता है.

ध्यान दें: Google, इस्तेमाल से जुड़े आंकड़े इकट्ठा करता है. हालांकि, इसमें उपयोगकर्ता की पहचान ज़ाहिर नहीं की जाती.

नीतियां और शर्तें

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