खास जानकारी

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

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

परिचय

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

ध्यान दें: Google Maps Platform, Android, iOS, JavaScript, और वेब सेवाओं के लिए, Places लाइब्रेरी के अलग-अलग वर्शन उपलब्ध कराता है. हमारा सुझाव है कि आप अपने प्लैटफ़ॉर्म के हिसाब से, जगहों की जानकारी वाली लाइब्रेरी के वर्शन का इस्तेमाल करें. इसका मतलब है कि अगर कोई Android ऐप्लिकेशन डेवलप किया जा रहा है, तो आपको Places के Android वर्शन का इस्तेमाल करना चाहिए.

कॉन्सेप्ट

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

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

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

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

SDK टूल का वर्शन चुनना

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

सबसे पहले, यह तय करें कि आपको किस SDK टूल का इस्तेमाल करना है. यह तब सही होता है, जब आप नए ग्राहक हों या पहले से ही SDK टूल का इस्तेमाल कर रहे मौजूदा ग्राहक हों. SDK टूल के दो वर्शन के बीच के मुख्य अंतर जानने के लिए, SDK टूल का वर्शन चुनें लेख पढ़ें.

SDK टूल के हर वर्शन के लिए कीमत

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

एपीआई की खास जानकारी

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

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

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

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

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