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