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