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