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