अपने SDK टूल का वर्शन चुनें

आपके ऐप्लिकेशन में उपलब्ध, Android के लिए Places SDK टूल की सुविधाओं का पता, SDK टूल के वर्शन नंबर (उदाहरण के लिए, 3.5.0) के आधार पर लगाया जाता है. यह नंबर, ऐप्लिकेशन कॉन्फ़िगरेशन में बताया जाता है. साथ ही, यह भी इस बात पर निर्भर करता है कि आपने एपीआई पासकोड पर कौनसे एपीआई चालू किए हैं और आपने ऐप्लिकेशन को कैसे शुरू किया है. इस गाइड में, वर्शन के बीच के अंतर के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि आपके ऐप्लिकेशन में कौनसे वर्शन चालू किए जाएं.

SDK टूल के वर्शन के नंबर

ऐप्लिकेशन-लेवल की build.gradle फ़ाइल में बताए गए SDK टूल के वर्शन नंबर से यह तय होता है कि आपके ऐप्लिकेशन के पास, किसी खास रिलीज़ में जोड़ी गई सुविधाओं का ऐक्सेस है या नहीं. उदाहरण के लिए, अपने-आप पूरा होने की सुविधा (नया वर्शन) सिर्फ़ SDK टूल के 3.5.0 या इसके बाद के वर्शन में उपलब्ध है.

SDK टूल के हर वर्शन में किए गए बदलावों के बारे में ज़्यादा जानने के लिए, Android के लिए Places SDK टूल के रिलीज़ नोट देखें.

Android के लिए Places SDK टूल के Places API के वर्शन

SDK टूल के वर्शन नंबर के साथ-साथ, आपको Google Cloud Console में वह Places API सेवा भी चुननी होगी जिसे SDK टूल कॉल करता है: Places API या Places API (नया). SDK टूल के वर्शन नंबर के साथ-साथ, आपके चुने गए एपीआई की सेवा से यह तय होता है कि आपके ऐप्लिकेशन में कौनसी सुविधाओं के कौनसे वर्शन उपलब्ध हैं. जैसे, ऑटोकंप्लीट या ऑटोकंप्लीट (नया). SDK टूल के सिर्फ़ एक वर्शन का नंबर दिया जा सकता है. हालांकि, अपनी एपीआई पासकोड पर एक साथ Places API और Places API (नया) को चालू किया जा सकता है. इसके बाद, अपने ऐप्लिकेशन में SDK टूल को शुरू करने के तरीके के हिसाब से यह चुना जा सकता है कि SDK टूल किस सेवा को कॉल करे. हालांकि, ज़्यादातर मामलों में, आपको Places API (नया) चालू करना होगा और अपने ऐप्लिकेशन में SDK टूल की सुविधाओं के (नए) वर्शन का इस्तेमाल करना होगा.

SDK टूल का वर्शन और एपीआई सेवाएं चुनना

यह चुनने के लिए कि आपके ऐप्लिकेशन में SDK टूल की कौनसी सुविधाएं उपलब्ध हैं, यह तरीका अपनाएं:

  1. अपने Google Cloud प्रोजेक्ट में, Places API, Places API (नया) या दोनों को चालू करें. ज़्यादा जानकारी के लिए, एपीआई चालू करना लेख पढ़ें
  2. एपीआई पासकोड की पाबंदियों में, Places API, Places API (नया) या दोनों को चालू करें. ज़्यादा जानकारी के लिए, एपीआई पासकोड पर पाबंदी लगाना लेख पढ़ें.

  3. ऐप्लिकेशन-लेवल की build.gradle फ़ाइल में, वर्शन नंबर डालें. ज़्यादा जानकारी के लिए, इंस्टॉलेशन देखें.

  4. Places.initializeWithNewPlacesApiEnabled() या Places.initialize() में से किसी एक तरीके को कॉल करके, अपने ऐप्लिकेशन को शुरू करें.

Places API सेवा चुनने के बारे में ज़्यादा जानने के लिए, अपना Google Cloud प्रोजेक्ट सेट अप करना लेख पढ़ें.

SDK टूल के हर वर्शन में उपलब्ध सुविधाएं

इस टेबल में बताया गया है कि SDK टूल की हर सुविधा के लिए, SDK टूल और एपीआई के कौनसे वर्शन ज़रूरी हैं:

सुविधा एपीआई पासकोड पर Places API चालू है शुरू करने का तरीका SDK टूल का सबसे पुराना वर्शन
ऑटोकंप्लीट (नया) Places API (नया प्रॉडक्ट) initializeWithNewPlacesApiEnabled() 3.5.0
जगह की जानकारी (नया) Places API (नया प्रॉडक्ट) initializeWithNewPlacesApiEnabled() 3.3.0
आस-पास की जगहों की जानकारी (नया) Places API (नया प्रॉडक्ट) initializeWithNewPlacesApiEnabled() 3.5.0
फ़ोटो की जगह की जानकारी जोड़ना (नया) Places API (नया प्रॉडक्ट) initializeWithNewPlacesApiEnabled() 3.4.0
टेक्स्ट खोज (नया) Places API (नया प्रॉडक्ट) initializeWithNewPlacesApiEnabled() 3.3.0
किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा Places API initialize()
मौजूदा जगह Places API initialize()
जगह की जानकारी Places API initialize()
फ़ोटो को जगह के हिसाब से व्यवस्थित करना Places API initialize()

कौनसे वर्शन चालू करने हैं, यह चुनने के लिए ध्यान रखने वाली बातें

कौनसा वर्शन चुनना है, यह तय करने के लिए इन बातों का ध्यान रखें:

  • अगर आप नए ग्राहक हैं और आपने अभी-अभी Android के लिए Places SDK टूल का इस्तेमाल शुरू किया है, तो Places API (नया) और नए SDK टूल का इस्तेमाल शुरू करें.
  • अगर आप मौजूदा ग्राहक हैं, तो मौजूदा SDK का इस्तेमाल जारी रखा जा सकता है. हालांकि, Android के लिए Places SDK टूल (नया वर्शन) की परफ़ॉर्मेंस में हुए सुधारों और सुविधाओं में हुए बेहतरीन बदलावों का फ़ायदा पाने के लिए, आपको नए SDK टूल का इस्तेमाल करना चाहिए. नए SDK टूल पर माइग्रेट करने के लिए, SDK टूल का वर्शन और एपीआई सेवाएं चुनें में दिया गया तरीका अपनाएं.
  • Android के लिए Places SDK टूल (नया वर्शन) में, सेशन टोकन 3.5.0 वर्शन से उपलब्ध हैं. ज़्यादा जानकारी के लिए, सेशन टोकन देखें.
  • जगह की जानकारी अपने-आप भरने की सुविधा वाले विजेट का इस्तेमाल करके किए गए कॉल, हमेशा जगह की जानकारी अपने-आप भरने की सुविधा को कॉल करते हैं, न कि जगह की जानकारी अपने-आप भरने की सुविधा (नया वर्शन); विजेट कॉल पर, शुरू करने के तरीके का असर नहीं पड़ता.
  • Place Photos (नया) सिर्फ़ बिटमैप इमेज का यूआरआई दिखाता है, जबकि Place Photos सिर्फ़ बिटमैप इमेज दिखाता है.
  • मौजूदा जगह सिर्फ़ Android के लिए Places SDK टूल में उपलब्ध है, न कि Android के लिए Places SDK टूल (नया).

Android के लिए Places SDK टूल में किए गए सुधार (नया)

इस सेक्शन में, Android के लिए Places SDK (नया वर्शन) में जोड़ी गई मुख्य सुविधाओं के बारे में बताया गया है.

Google Cloud के स्टैंडर्ड प्लैटफ़ॉर्म पर लागू किया गया

Android के लिए Places SDK (नया) को Google Cloud पर मौजूद सेवा के इंफ़्रास्ट्रक्चर पर लागू किया गया है. इस सुविधा को लागू करने से, आपको ज़्यादा सुरक्षित और भरोसेमंद प्लैटफ़ॉर्म मिलता है. इस स्टैंडर्ड डिज़ाइन की मदद से, सभी SDK टूल एक जैसे दिखते हैं. इससे Android के लिए Places SDK टूल (नया) की मदद से, डेवलपमेंट की प्रोसेस को बेहतर बनाने में मदद मिलती है.

बेहतर परफ़ॉर्मेंस

Android के लिए Places SDK टूल (नया) की परफ़ॉर्मेंस बेहतर है. इसलिए, मौजूदा SDK टूल का इस्तेमाल करने वाले ऐप्लिकेशन को बदलना बेहतर होगा.

नई सुविधाएं

Android के लिए Places SDK टूल (नया) में, SDK टूल की सभी सुविधाओं के नए वर्शन शामिल हैं:

टेक्स्ट खोज की नई सेवा

टेक्स्ट खोज (नया) सुविधा, किसी स्ट्रिंग के आधार पर जगहों के एक सेट के बारे में जानकारी दिखाती है. उदाहरण के लिए, "न्यूयॉर्क में पिज़्ज़ा" या "ओटावा के पास जूते के स्टोर" या "123 मुख्य सड़क". सेवा, टेक्स्ट स्ट्रिंग और सेट की गई जगह के हिसाब से, मिलती-जुलती जगहों की सूची के साथ जवाब देती है.

जगह की जानकारी (नया) और जगह की फ़ोटो (नया) में नया रिस्पॉन्स डेटा जोड़ा गया

  • जगह की जानकारी (नया) में अब जवाब Place ऑब्जेक्ट में, नई समीक्षा क्लास शामिल है. जगह क्लास में, इस फ़ील्ड के साथ काम करने के लिए नया getReviews() तरीका शामिल है. किसी जगह की पांच समीक्षाएं पाने के लिए, getReviews() को कॉल करें.

  • जगह की फ़ोटो (नया) फ़ंक्शन, PhotoMetadata क्लास में AuthorAttributions जोड़ता है. AuthorAttributions में AuthorAttribution ऑब्जेक्ट का List शामिल है.

जगह की फ़ोटो में नया यूआरआई रिस्पॉन्स जोड़ा गया (नया)

अब इमेज बिटमैप में यूआरआई दिखाने के लिए, फ़ोटो डालें (नया) का इस्तेमाल किया जा सकता है. पहले, सिर्फ़ इमेज बिटमैप को दिखाया जा सकता था.

आसान कीमत

Android के लिए Places SDK टूल (नया) की मदद से, कीमत तय करना आसान हो गया है. इससे आपको सिर्फ़ उस डेटा के लिए पैसे चुकाने होंगे जिसका इस्तेमाल किया जाता है. आसान कीमत तय करने की सुविधा, फ़ील्ड की सूचियों का इस्तेमाल करके लागू की जाती है. इन्हें फ़ील्ड मास्क भी कहा जाता है.

जगह की जानकारी और टेक्स्ट खोज के लिए, फ़ील्ड की सूचियों का इस्तेमाल करके, जवाब में दिखाए जाने वाले फ़ील्ड की सूची को कंट्रोल किया जा सकता है. इसके बाद, आपसे सिर्फ़ उस डेटा के लिए शुल्क लिया जाएगा जिसके लिए अनुरोध किया गया है. फ़ील्ड की सूची का इस्तेमाल करना, डिज़ाइन के लिए एक अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने अनावश्यक डेटा का अनुरोध न किया हो. इससे, प्रोसेसिंग में लगने वाले समय और बिलिंग शुल्क से बचा जा सकता है.

दोनों SDK टूल के लिए कीमत की ज़्यादा जानकारी के लिए, इस्तेमाल और बिलिंग देखें.

जगह के टाइप की जानकारी देने के लिए, ज़्यादा विकल्प

नया SDK टूल, यहां दी गई टेबल में दिखाए गए जगह के टाइप जोड़ता है. ये टाइप, जगह की जानकारी और टेक्स्ट खोज के जवाब के हिस्से के तौर पर दिखाए जाते हैं. टेक्स्ट खोज की सुविधा का इस्तेमाल करके, इन नए और मौजूदा टाइप का इस्तेमाल भी किया जा सकता है. नए टाइप, टेबल A में शामिल किए गए हैं.

टाइप
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant खेत korean_restaurant sporting_goods_store
barber_shop फ़ार्मस्टे lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal बाज़ार steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant दर्जी
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant मोटल thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
सलाहकार हेलीपोर्ट खेल का मैदान vegetarian_restaurant
convention_center hiking_area प्रीस्कूल vietnamese_restaurant
कॉटेज historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center होस्टल resort_hotel थोक दुकानदार
dental_clinic होटल rest_stop

इन नए टाइप के साथ-साथ, Places API (नया वर्शन) ने इन टाइप को, Places API की टेबल 2 से Places API (नया वर्शन) की टेबल A में ले जाया है. इसका मतलब है कि अब खोज के लिए, इन टाइप का इस्तेमाल किया जा सकता है:

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality