Android के लिए Places SDK, मौजूदा जगह की जानकारी के साथ काम करता है. अगर आपको Android के लिए मौजूदा Places SDK टूल के बारे में पता है, तो जगह की जानकारी के नए वर्शन में ये बदलाव किए गए हैं:
कीमत तय करने के लिए नए मॉडल का इस्तेमाल करता है. सभी एपीआई की कीमत की जानकारी के लिए, Android के लिए Places SDK टूल (नया) देखें.
आपको
Places.initializeWithNewPlacesApiEnabled()तरीका कॉल करके, अपने ऐप्लिकेशन को शुरू करना होगा. Places API सेवा चुनने के बारे में ज़्यादा जानने के लिए, अपना Google Cloud प्रोजेक्ट सेट अप करना लेख पढ़ें.फ़ील्ड मास्क करना ज़रूरी है. आपको यह बताना होगा कि आपको रिस्पॉन्स में कौनसे फ़ील्ड चाहिए. दिखाए गए फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. अगर इस सूची को शामिल नहीं किया जाता है, तो ये तरीके गड़बड़ी का मैसेज दिखाते हैं.
नीचे दिए गए सेक्शन में, अन्य बदलावों के बारे में बताया गया है.
जगह की जानकारी के नए टाइप ऐक्सेस करना
हर जगह के लिए, एक या उससे ज़्यादा टाइप वैल्यू हो सकती हैं. Android के 3.3.0 और उसके बाद के वर्शन के लिए, Places SDK टूल में कई तरह की नई वैल्यू जोड़ी गई हैं. पूरी सूची के लिए, जगह के टाइप के लिए उपलब्ध विकल्प देखें.
Place.getPlaceTypes() तरीका, टाइप की वैल्यू को स्ट्रिंग वैल्यू की सूची के तौर पर दिखाता है. रिटर्न की गई वैल्यू, Android के लिए Places SDK टूल के आपके वर्शन पर निर्भर करती हैं:
Android के लिए Places SDK टूल (नया): जगह के टाइप (नया) पर दिखाई गई टेबल A और टेबल B में बताई गई स्ट्रिंग दिखाता है. इसमें, वर्शन 3.3.0 में जोड़े गए सभी जगह के टाइप भी शामिल हैं.
Android के लिए Places SDK टूल:
Place.Typesके ज़रिए तय किए गए एनम को दिखाता है. इसमें 3.3.0 और उसके बाद के वर्शन में जोड़े गए नए टाइप शामिल नहीं होते.
किसी जगह की समीक्षाएं ऐक्सेस करना
Android के लिए Places SDK (नया वर्शन) में Review क्लास जोड़ी गई है. इसमें किसी जगह की समीक्षा शामिल होती है. Place ऑब्जेक्ट में ज़्यादा से ज़्यादा पांच समीक्षाएं हो सकती हैं.
Review क्लास में एट्रिब्यूशन और लेखक का एट्रिब्यूशन भी शामिल हो सकता है. अगर आपने अपने ऐप्लिकेशन में समीक्षा दिखाई है, तो आपको कोई एट्रिब्यूशन या लेखक का एट्रिब्यूशन भी दिखाना होगा. ज़्यादा जानकारी के लिए, समीक्षा दिखाना लेख पढ़ें.
ज़्यादा जानकारी के लिए, क्रेडिट से जुड़ा दस्तावेज़ देखें.
जगह के नाम की भाषा का कोड ऐक्सेस करना
मौजूदा
Place.getName()
तरीका, किसी जगह का नाम वाली टेक्स्ट स्ट्रिंग दिखाता है. जगह के नाम के साथ Place ऑब्जेक्ट को पॉप्युलेट करने के लिए, आपको जगह की जानकारी के अनुरोध की फ़ील्ड सूची में Place.Field.DISPLAY_NAME शामिल करना होगा.
Place ऑब्जेक्ट में अब नाम की स्ट्रिंग के लिए भाषा का कोड शामिल है. Place ऑब्जेक्ट में भाषा कोड डालने के लिए, आपको ये काम करने होंगे:
अनुरोध के फ़ील्ड की सूची में
Place.Field.DISPLAY_NAMEशामिल करें. यह वैल्यू, जवाब को कॉन्फ़िगर करती है, ताकिPlaceऑब्जेक्ट में जगह का नाम और भाषा कोड, दोनों शामिल किए जा सकें.PlacesClient.fetchPlace()को कॉल करें.PlacesClient.findCurrentPlace()में भाषा कोड फ़ील्ड का इस्तेमाल नहीं किया जा सकता.Placeऑब्जेक्ट में भाषा कोड फ़ील्ड को ऐक्सेस करने के लिए,Place.getNameLanguageCode()तरीका इस्तेमाल करें.
क्षेत्र का कोड सेट करना
Android के लिए Places SDK टूल (नया वर्शन), जगह की जानकारी में क्षेत्र कोड का अनुरोध पैरामीटर जोड़ता है. क्षेत्र कोड का इस्तेमाल, रिस्पॉन्स को फ़ॉर्मैट करने के लिए किया जाता है. इसे दो वर्णों वाले CLDR कोड की वैल्यू के तौर पर तय किया जाता है. इस पैरामीटर से, खोज के नतीजों पर भी असर पड़ सकता है. इस एट्रिब्यूट के लिए कोई डिफ़ॉल्ट वैल्यू नहीं है. क्षेत्र कोड सेट करने के लिए, आपको नया SDK चालू करना होगा.
अगर जवाब में दिए गए पते के फ़ील्ड में देश का नाम, इलाके के कोड से मेल खाता है, तो पते से देश का कोड हटा दिया जाता है.
ज़्यादातर CLDR कोड, ISO 3166-1 कोड से मेल खाते हैं. हालांकि, कुछ कोड अलग होते हैं. उदाहरण के लिए, यूनाइटेड किंगडम का ccTLD "uk" (.co.uk) है, जबकि उसका ISO 3166-1 कोड "gb" है. तकनीकी तौर पर, यह कोड "यूनाइटेड किंगडम ऑफ़ ग्रेट ब्रिटेन ऐंड नॉर्दर्न आयरलैंड" इकाई के लिए है. लागू होने वाले कानून के आधार पर, पैरामीटर से नतीजों पर असर पड़ सकता है.
अनुरोध का उदाहरण
पूरा उदाहरण देखने के लिए, जगह की जानकारी (नया) देखें.