शुरुआती जानकारी
Android के लिए, जगहें SDK टूल से आपको जगह की जानकारी का पता लगाने वाले ऐसे ऐप्लिकेशन बनाने में मदद मिलती है जो उपयोगकर्ता के डिवाइस के आस-पास मौजूद स्थानीय कारोबारों और आस-पास की जगहों के हिसाब से काम करते हैं. इसका मतलब है कि आपके पास उन जगहों के आधार पर रिच ऐप्लिकेशन बनाने का विकल्प होता है जो उपयोगकर्ता के लिए बहुत मायने रखते हैं. इन ऐप्लिकेशन का इस्तेमाल, Android जगह की जानकारी की ओर से दी जा रही भौगोलिक सेवाओं को बेहतर बनाने में किया जा सकता है.
कॉन्सेप्ट
ये इंटरफ़ेस, Android के लिए Places SDK टूल के मुख्य एंट्री पॉइंट उपलब्ध कराते हैं:
Placesप्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस की मदद से, Google पर मौजूद स्थानीय जगह और कारोबार की जानकारी के डेटाबेस के साथ-साथ, डिवाइस की मौजूदा जगह की जानकारी भी देखी जा सकती है.Autocompleteमें, पहले से बने विजेट मिलते हैं. इनकी मदद से, उपयोगकर्ता की खोज क्वेरी के जवाब में जगह का अनुमान लगाया जा सकता है.
जगह को एक ऐसी जगह कहा जाता है जिसका एक नाम होता है. किसी जगह के बारे में सोचने का एक और तरीका यह है कि यह हर वह चीज़ है जो आपको मैप पर मिल सकती है.
उदाहरण के लिए, स्थानीय कारोबार, लोकप्रिय जगहें, और भौगोलिक जगहें. एपीआई में, जगह को
Place
इंटरफ़ेस के तौर पर दिखाया जाता है. इसमें जगह का नाम, पता, भौगोलिक जगह, जगह का आईडी, फ़ोन नंबर, जगह का टाइप, वेबसाइट का यूआरएल वगैरह जैसी जानकारी शामिल होती है.
अपने SDK टूल का वर्शन चुनें
Android वर्शन 3.3.0 के लिए Places SDK टूल, दो SDK टूल के साथ काम करता है: मौजूदा Android के लिए साइट SDK टूल और Android के लिए साइट SDK टूल (नया), जो SDK टूल की अगली पीढ़ी का वर्शन है.
सबसे पहले आपको यह तय करना होगा कि किस SDK टूल का इस्तेमाल करना है. यह तब लागू होता है, जब आप नए ग्राहक हों या पहले से ही SDK टूल का इस्तेमाल कर रहे मौजूदा ग्राहक हों. SDK टूल के दो वर्शन के बीच मुख्य अंतर जानने के लिए, अपने SDK टूल का वर्शन चुनना लेख पढ़ें.
SDK टूल के हर वर्शन की कीमत
SDK टूल का चुना गया वर्शन, जगह की जानकारी, टेक्स्ट सर्च, और जगह की फ़ोटो के लिए कीमत तय करता है. Android के लिए स्थल SDK (नया) एक सरल मूल्य-निर्धारण मॉडल का समर्थन करता है, ताकि आप केवल उसी डेटा के लिए भुगतान करें, जिसका आप उपयोग करते हैं. दोनों SDK टूल की कीमत के बारे में ज़्यादा जानने के लिए, इस्तेमाल और बिलिंग देखें.
एपीआई की खास जानकारी
अपने ग्राहकों को यह पता लगाने में सहायता करें कि वे कहां हैं और उनके आस-पास क्या है:
- जैसे ही उपयोगकर्ता किसी जगह का नाम और/या पता टाइप करता है, जगह की जानकारी अपने-आप भर जाती है.
- मौजूदा जगह पर उन जगहों की सूची दिखती है जहां उपयोगकर्ता का डिवाइस आखिरी बार मौजूद था. साथ ही, हर जगह के आस-पास होने की संभावना का संकेत भी दिखता है.
- जगह की जानकारी वापस करें और किसी जगह की ज़्यादा जानकारी दिखाएं.
- टेक्स्ट खोज, खोज टेक्स्ट स्ट्रिंग के आधार पर जगहें दिखाती है. टेक्स्ट खोज, Android के लिए Places SDK टूल का हिस्सा है (नया).
- जगह की फ़ोटो, किसी जगह की अच्छी क्वालिटी की इमेज दिखाता है.
- जगह के आईडी, एक या एक से ज़्यादा जगहों के यूनीक आईडी को स्टोर करते हैं. इससे, जगह की जानकारी, मांग पर वापस पाई जा सकती है.
नीतियां और शर्तें
Android के लिए जगहें SDK टूल का इस्तेमाल करने वाले सभी ऐप्लिकेशन को Google Maps Platform की सेवा की शर्तों, इस्तेमाल और बिलिंग, और एट्रिब्यूशन दिखाना में बताई गई ज़रूरी शर्तों को पूरा करना होगा.