आपके ऐप्लिकेशन में उपलब्ध iOS की सुविधाओं के लिए Places SDK टूल, आपके ऐप्लिकेशन के वर्शन नंबर (उदाहरण के लिए, 9.0.0) के कॉम्बिनेशन से तय होता है. आपके एपीआई पासकोड पर चालू रहने वाले एपीआई और पैकेज डिपेंडेंसी में इस बारे में जानकारी दी जाती है. इस गाइड में, वर्शन के बीच के अंतर बताए गए हैं. साथ ही, यह भी बताया गया है कि आपके ऐप्लिकेशन में चालू होने वाले वर्शन कैसे चुनें.
SDK टूल के वर्शन का नंबर
पैकेज डिपेंडेंसी में आपने एसडीके का जो वर्शन नंबर बताया है उससे यह तय होता है कि आपके ऐप्लिकेशन में उन सुविधाओं का ऐक्सेस है या नहीं जिन्हें किसी खास रिलीज़ में जोड़ा गया था. उदाहरण के लिए, ऑटोकंप्लीट की सुविधा (नया वर्शन), सिर्फ़ SDK टूल के 9.0.0 या इसके बाद के वर्शन में उपलब्ध है.
SDK टूल के हर वर्शन में किए गए बदलावों के बारे में ज़्यादा जानकारी के लिए, iOS के लिए SDK टूल की जानकारी वाला दस्तावेज़ देखें.
iOS के लिए Places SDK टूल के Places API वर्शन
SDK टूल के वर्शन का नंबर तय करने के अलावा, आपको Places API की वह सेवा भी चुननी होगी जिसे SDK टूल, Google Cloud Console में कॉल करता है. इसमें, Places API या जगहें एपीआई (नया) चुनना होगा. SDK टूल के वर्शन नंबर के साथ, आपकी चुनी गई एपीआई सेवा यह तय करती है कि आपके ऐप्लिकेशन में कौनसी खास सुविधाएं उपलब्ध हैं. जैसे, अपने-आप पूरा होना या अपने-आप पूरा होना (नया). आपके पास SDK टूल का सिर्फ़ एक वर्शन नंबर तय करने का विकल्प होता है. हालांकि, एपीआई पासकोड पर Places API और Places API (नया) दोनों को एक साथ चालू किया जा सकता है. हालांकि, ज़्यादातर मामलों में, आपको Places API (नया) चालू करना होगा और अपने ऐप्लिकेशन में SDK टूल के (नए) वर्शन इस्तेमाल करने होंगे.
अपने SDK टूल का वर्शन और एपीआई सेवाएं चुनें
यह चुनने के लिए कि आपके ऐप्लिकेशन में SDK टूल की कौनसी सुविधाएं उपलब्ध हैं, यह तरीका अपनाएं:
- अपने Google Cloud प्रोजेक्ट में, Places API, Places API (नया) या दोनों को चालू करें. ज़्यादा जानकारी के लिए, एपीआई चालू करें देखें
- एपीआई पासकोड से जुड़ी पाबंदियों में, Places API, Places API (नया) या दोनों को चालू करें. ज़्यादा जानकारी के लिए, एपीआई पासकोड को सीमित करना देखें.
- SDK टूल इंस्टॉल करते समय, वर्शन का नंबर बताएं. ज़्यादा जानकारी के लिए, Xcode प्रोजेक्ट सेट अप करना लेख पढ़ें.
Places API सेवा चुनने के बारे में ज़्यादा जानकारी के लिए, अपना Google Cloud प्रोजेक्ट सेट अप करना लेख पढ़ें.
हर वर्शन में उपलब्ध SDK टूल की सुविधाएं
इस टेबल में बताया गया है कि SDK टूल की हर सुविधा के लिए, SDK टूल और एपीआई के कौनसे वर्शन की ज़रूरत होती है:
सुविधा | एपीआई कुंजी पर Places API चालू है | SDK टूल का कम से कम वर्शन |
---|---|---|
ऑटोकंप्लीट की सुविधा (नई सुविधा) | Places API (नया प्रॉडक्ट) | 9.0.0 |
जगह की जानकारी (नई) | Places API (नया प्रॉडक्ट) | 9.0.0 |
आस-पास खोजने की सुविधा (नया) | Places API (नया प्रॉडक्ट) | 9.0.0 |
जगह की फ़ोटो (नई) | Places API (नया प्रॉडक्ट) | 9.0.0 |
टेक्स्ट खोज (नई सुविधा) | Places API (नया प्रॉडक्ट) | 8.5.0 |
जगह की जानकारी के अपने-आप पूरे होने की सुविधा | Places API | 3.0.0 |
मौजूदा जगह | Places API | 3.0.0 |
जगह की जानकारी | Places API | 3.0.0 |
जगह की फ़ोटो | Places API | 3.0.0 |
चालू करने के लिए वर्शन चुनने से पहले ध्यान देने वाली बातें
- अगर आपने iOS के लिए Places SDK टूल का इस्तेमाल अभी शुरू किया है, तो जगह एपीआई (नया) और नए SDK टूल के साथ शुरुआत करें.
- अगर आप मौजूदा ग्राहक हैं, तो आपके पास मौजूदा SDK टूल का इस्तेमाल करने का विकल्प है. हालांकि, iOS के लिए Places SDK टूल (नया) के परफ़ॉर्मेंस में हुए सुधारों और उसकी सुविधाओं को बेहतर बनाने के लिए, आपको Places API (नया) को चालू करना होगा और नए SDK टूल का इस्तेमाल करना होगा. SDK टूल के नए वर्शन का इस्तेमाल करने के लिए, किसी माइग्रेट करने की ज़रूरत नहीं है. SDK टूल के वर्शन और एपीआई की सेवाएं चुनें में दिया गया तरीका अपनाएं.
- Places API (नया वर्शन), मौजूदा जगह,
GMSPlace.isOpen
, औरGMSPlaceisOpenAtDate
जैसी कुछ मौजूदा सुविधाएं चालू नहीं करता है.
Google PlacesSwift की झलक रिलीज़ का इस्तेमाल करें
अगर आपको GooglePlaceSwift के 0.1.0 वर्शन की झलक रिलीज़ का इस्तेमाल करना है, तो जगह की जानकारी का एपीआई (नया) चालू करें और GooglePlaceSwift SDK टूल इंस्टॉल करें.
नए एपीआई पर माइग्रेट करें
अगर किसी मौजूदा एपीआई का इस्तेमाल किया जा रहा है और आपको नए एपीआई पर माइग्रेट करना है, तो हर एपीआई के लिए, नीचे दी गई माइग्रेशन गाइड देखें:
- जगह की जानकारी पर माइग्रेट करना (नई जानकारी)
- जगह की फ़ोटो पर माइग्रेट करें (नई)
- ऑटोकंप्लीट सुविधा पर माइग्रेट करना (नई सुविधा)
iOS के लिए Places SDK टूल में हुए सुधार (नया)
इस सेक्शन में iOS के लिए, Places SDK टूल में जोड़ी गई मुख्य सुविधाओं के बारे में बताया गया है (नया).
Google Cloud के स्टैंडर्ड प्लैटफ़ॉर्म पर लागू की गई
iOS के लिए Places SDK टूल (नया वर्शन) को Google Cloud पर मौजूद सेवा के इंफ़्रास्ट्रक्चर पर लागू किया गया है. इस तरीके को लागू करने से, ज़्यादा सुरक्षित और भरोसेमंद प्लैटफ़ॉर्म बन जाता है. इस स्टैंडर्ड डिज़ाइन से, सभी SDK टूल को एक जैसा स्तर मिलता है. इससे iOS के लिए, Places SDK टूल की मदद से डेवलपमेंट की क्षमता बेहतर होती है (नया).
बेहतर परफ़ॉर्मेंस
iOS के लिए Places SDK टूल (नया) की मदद से, ऐप्लिकेशन की परफ़ॉर्मेंस बेहतर होती है. इससे, मौजूदा SDK टूल का इस्तेमाल करने वाले ऐप्लिकेशन की जगह, उसे इस्तेमाल करना आसान हो जाता है.
नई सुविधाएं
iOS के लिए Places SDK टूल (नया वर्शन) में SDK टूल की सभी सुविधाओं के नए वर्शन शामिल होते हैं:
- ऑटोकंप्लीट की सुविधा (नई सुविधा)
- जगह की जानकारी (नई)
- आस-पास खोजने की सुविधा (नया)
- जगह की फ़ोटो (नई)
- टेक्स्ट खोज (नई सुविधा)
आसान कीमत
iOS के लिए Places SDK टूल (नया) की मदद से कीमत को आसान बनाया गया है, ताकि आपको सिर्फ़ इस्तेमाल किए गए डेटा के लिए पैसे चुकाने पड़ें. आसान कीमत को फ़ील्ड सूचियों की मदद से लागू किया जाता है. इसे फ़ील्ड मास्क भी कहा जाता है.
iOS और टेक्स्ट खोज के लिए 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 में ले गया. इसका मतलब है कि अब खोज के हिस्से के तौर पर इन तरीकों का इस्तेमाल किया जा सकता है:
country
administrative_area_level_1
administrative_area_level_2
postal_code
locality