आपके ऐप्लिकेशन में उपलब्ध, Android के लिए Places SDK टूल की सुविधाओं का पता, SDK टूल के वर्शन नंबर (उदाहरण के लिए, 3.5.0) के आधार पर लगाया जाता है. यह नंबर, ऐप्लिकेशन कॉन्फ़िगरेशन में बताया जाता है. साथ ही, यह भी इस बात पर निर्भर करता है कि आपकी एपीआई पासकोड पर कौनसे एपीआई चालू हैं और आपने ऐप्लिकेशन को कैसे शुरू किया है. इस गाइड में, वर्शन के बीच के अंतर के बारे में बताया गया है. साथ ही, यह भी बताया गया है कि आपके ऐप्लिकेशन में कौनसे वर्शन चालू करने हैं.
SDK टूल के वर्शन के नंबर
ऐप्लिकेशन-लेवल की build.gradle फ़ाइल में बताए गए SDK टूल के वर्शन नंबर से यह तय होता है कि आपके ऐप्लिकेशन के पास, किसी खास रिलीज़ में जोड़ी गई सुविधाओं का ऐक्सेस है या नहीं. उदाहरण के लिए, ऑटोकंप्लीट (नया) सुविधा सिर्फ़ SDK के 3.5.0 या इसके बाद के वर्शन में उपलब्ध है.
SDK टूल के हर वर्शन में किए गए बदलावों के बारे में ज़्यादा जानने के लिए, Android के लिए Places SDK टूल के रिलीज़ नोट देखें.
Places SDK for Android के लिए Places API के वर्शन
एसडीके के वर्शन नंबर के साथ-साथ, आपको Google Cloud Console में वह Places API सेवा भी चुननी होगी जिसे एसडीके कॉल करता है: Places API या Places API (नया). SDK टूल के वर्शन नंबर के साथ-साथ, आपके चुने गए एपीआई की सेवा से यह तय होता है कि आपके ऐप्लिकेशन में कौनसी सुविधाओं के कौनसे वर्शन उपलब्ध हैं. जैसे, ऑटोकंप्लीट या ऑटोकंप्लीट (नया). एसडीके के सिर्फ़ एक वर्शन का नंबर दिया जा सकता है. हालांकि, अपनी एपीआई पासकोड पर एक साथ Places API और Places API (नया) को चालू किया जा सकता है. इसके बाद, अपने ऐप्लिकेशन में एसडीके को शुरू करने के तरीके के ज़रिए, यह चुना जा सकता है कि एसडीके किस सेवा को कॉल करे. हालांकि, ज़्यादातर मामलों में, आपको Places API (नया) चालू करना होगा और अपने ऐप्लिकेशन में एसडीके की सुविधाओं के (नए) वर्शन का इस्तेमाल करना होगा.
SDK टूल का वर्शन और एपीआई सेवाएं चुनना
यह चुनने के लिए कि आपके ऐप्लिकेशन में SDK टूल की कौनसी सुविधाएं उपलब्ध हैं, यह तरीका अपनाएं:
- अपने Google Cloud प्रोजेक्ट में, Places API, Places API (नया) या दोनों को चालू करें. ज़्यादा जानकारी के लिए, एपीआई चालू करना लेख पढ़ें
- एपीआई पासकोड की पाबंदियों में, Places API, Places API (नया) या दोनों को चालू करें. ज़्यादा जानकारी के लिए, एपीआई पासकोड पर पाबंदी लगाना लेख पढ़ें.
ऐप्लिकेशन-लेवल की build.gradle फ़ाइल में, वर्शन नंबर डालें. ज़्यादा जानकारी के लिए, इंस्टॉलेशन देखें.
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() |
किन वर्शन को चालू करना है, यह चुनने के लिए ध्यान रखने वाली बातें
कौनसा वर्शन चुनना है, यह तय करने के लिए इन बातों का ध्यान रखें:
- अगर आप नए ग्राहक हैं और आपने Places SDK for Android का इस्तेमाल अभी-अभी शुरू किया है, तो Places API (नया) और नए SDK टूल का इस्तेमाल शुरू करें.
- अगर आप मौजूदा ग्राहक हैं, तो मौजूदा SDK टूल का इस्तेमाल जारी रखा जा सकता है. हालांकि, Places SDK for Android (नया वर्शन) की परफ़ॉर्मेंस में हुए सुधारों और सुविधाओं में हुए बेहतरीन बदलावों का फ़ायदा पाने के लिए, आपको नए SDK टूल का इस्तेमाल करना चाहिए. नए SDK टूल पर माइग्रेट करने के लिए, SDK टूल का वर्शन और एपीआई सेवाएं चुनें में दिया गया तरीका अपनाएं.
- Places SDK for Android (नया वर्शन) में, सेशन टोकन 3.5.0 वर्शन से उपलब्ध हैं. ज़्यादा जानकारी के लिए, सेशन टोकन देखें.
- जगह के शुरुआती अक्षर लिखने पर सुझाव देने वाले विजेट का इस्तेमाल करके किए गए कॉल, हमेशा जगह के शुरुआती अक्षर लिखने पर सुझाव देने की सुविधा को कॉल करते हैं, न कि जगह के शुरुआती अक्षर लिखने पर सुझाव देने की सुविधा (नया वर्शन); विजेट कॉल पर, शुरू करने के तरीके का असर नहीं पड़ता.
- Place Photos (नया) सिर्फ़ बिटमैप इमेज का यूआरआई दिखाता है, जबकि Place Photos सिर्फ़ बिटमैप इमेज दिखाता है.
- मौजूदा जगह की जानकारी, सिर्फ़ Places SDK for Android में उपलब्ध है. यह जानकारी, Places SDK for Android (नया) में उपलब्ध नहीं है.
Android के लिए Places SDK टूल में किए गए सुधार (नया)
इस सेक्शन में, Places SDK for Android (नया वर्शन) में जोड़ी गई मुख्य सुविधाओं के बारे में बताया गया है.
Google Cloud के स्टैंडर्ड प्लैटफ़ॉर्म पर लागू किया गया हो
Places SDK for Android (नया) को Google Cloud पर मौजूद सेवा इन्फ़्रास्ट्रक्चर पर लागू किया गया है. इस सुविधा को लागू करने से, आपको ज़्यादा सुरक्षित और भरोसेमंद प्लैटफ़ॉर्म मिलता है. इस स्टैंडर्ड डिज़ाइन की मदद से, सभी एसडीके टूल एक जैसे दिखते हैं. इससे, Places SDK for Android (नया) के साथ डेवलपमेंट की प्रोसेस को बेहतर बनाने में मदद मिलती है.
बेहतर परफ़ॉर्मेंस
Places SDK for Android (नया) की परफ़ॉर्मेंस बेहतर है. इसलिए, मौजूदा SDK टूल का इस्तेमाल करने वाले ऐप्लिकेशन को बदलना फ़ायदेमंद होगा.
नई सुविधाएं
Places SDK for Android (नया) में, SDK टूल की सभी सुविधाओं के नए वर्शन शामिल हैं:
- ऑटोकंप्लीट (नया)
- जगह की जानकारी (नया)
- आस-पास की जगहों की जानकारी (नया)
- जगह की फ़ोटो (नया)
- टेक्स्ट खोज (नया)
टेक्स्ट से खोजने की नई सेवा
टेक्स्ट खोज (नया) सुविधा, किसी स्ट्रिंग के आधार पर जगहों के सेट के बारे में जानकारी दिखाती है. जैसे, "न्यूयॉर्क में पिज़्ज़ा" या "ओटावा के पास जूते के स्टोर" या "123 मुख्य सड़क". सेवा, टेक्स्ट स्ट्रिंग और सेट की गई जगह से जुड़ी जानकारी से मैच होने वाली जगहों की सूची के साथ जवाब देती है.
जगह की जानकारी (नया) और जगह की फ़ोटो (नया) में नया जवाब डेटा जोड़ा गया
जगह की जानकारी (नया) में अब जवाब
Placeऑब्जेक्ट में, समीक्षा की नई क्लास शामिल है. जगह क्लास में, इस फ़ील्ड के साथ काम करने के लिए नयाgetReviews()तरीका शामिल है. किसी जगह की पांच समीक्षाएं देखने के लिए,getReviews()को कॉल करें.फ़ोटो जोड़ें (नया) सुविधा,
PhotoMetadataक्लास मेंAuthorAttributionsको जोड़ती है.AuthorAttributionsमेंAuthorAttributionऑब्जेक्ट का एकListहै.
जगह की फ़ोटो में नया यूआरआई रिस्पॉन्स जोड़ा गया (नया)
अब इमेज बिटमैप का यूआरआई पाने के लिए, जगह की फ़ोटो (नया) का इस्तेमाल किया जा सकता है. पहले, सिर्फ़ इमेज के बिटमैप को दिखाया जा सकता था.
आसान कीमत
Places SDK for Android (नया) की मदद से, कीमत तय करना आसान हो गया है. इससे आपको सिर्फ़ उस डेटा के लिए पैसे चुकाने होंगे जिसका इस्तेमाल किया जाता है. आसान कीमत तय करने की सुविधा, फ़ील्ड की सूचियों का इस्तेमाल करके लागू की जाती है. इन्हें फ़ील्ड मास्क भी कहा जाता है.
जगह की जानकारी और टेक्स्ट खोज के साथ, फ़ील्ड की सूचियों का इस्तेमाल करके, रिस्पॉन्स में दिखाए जाने वाले फ़ील्ड की सूची को कंट्रोल किया जा सकता है. इसके बाद, आपसे सिर्फ़ उस डेटा के लिए शुल्क लिया जाता है जिसके लिए अनुरोध किया गया है. फ़ील्ड की सूची का इस्तेमाल करना, डिज़ाइन का एक अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने अनावश्यक डेटा का अनुरोध न किया हो. इससे, प्रोसेसिंग में लगने वाले समय और बिलिंग शुल्क से बचा जा सकता है.
दोनों 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 में बदल दिया है. इसका मतलब है कि अब इन टाइप का इस्तेमाल, खोज के हिस्से के तौर पर किया जा सकता है:
countryadministrative_area_level_1administrative_area_level_2postal_codelocality