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