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