Places API, एपीआई के दो वर्शन के साथ काम करता है: Place API मौजूदा एपीआई हैं और Place API (नया), एपीआई के अगली-पीढ़ी की टेक्नोलॉजी वाले वर्शन हैं.
Places API (नया वर्शन) के रिलीज़ होने के बाद, आपको सबसे पहले यह तय करना होगा कि एपीआई के किस सेट का इस्तेमाल करना है. अगर आप नए ग्राहक हैं या ऐसे मौजूदा ग्राहक हैं जो एपीआई का पहले से इस्तेमाल कर रहे हैं, तो यह बात लागू होती है. दोनों एपीआई के बीच के अहम अंतर को समझने के लिए, इस गाइड का इस्तेमाल करें.
एपीआई की सूची
नीचे दी गई टेबल में एपीआई के दोनों सेट की सूची दी गई है. अगर आप मौजूदा ग्राहक हैं, तो इस टेबल का इस्तेमाल करके, मौजूदा एपीआई की जगह नए एपीआई का पता लगाने के लिए यह टेबल देखें.
Places API | Places API (नया प्रॉडक्ट) | ध्यान दें |
---|---|---|
जगह ढूंढें | टेक्स्ट खोज (नई सुविधा) | जगह ढूंढें का कोई नया वर्शन उपलब्ध नहीं है. टेक्स्ट सर्च (नया) ने इसकी जगह ले ली है. |
आस-पास खोज | आस-पास खोजने की सुविधा (नया) | मौजूदा एपीआई का इस्तेमाल करने वाले ऐसे सभी अनुरोधों में Text Search (नया) का इस्तेमाल करना चाहिए जिनमें टेक्स्ट क्वेरी शामिल हो. इसकी वजह यह है कि आस-पास सर्च (नया) में टेक्स्ट इनपुट की सुविधा काम नहीं करती. |
टेक्स्ट से खोजें | टेक्स्ट खोज (नई सुविधा) | |
जगह की जानकारी | जगह की जानकारी (नई) | |
जगह की फ़ोटो | जगह की फ़ोटो (नई) | |
जगह की जानकारी के अपने-आप पूरे होने की सुविधा | ऑटोकंप्लीट की सुविधा (नई सुविधा) | |
क्वेरी के लिए ऑटोकंप्लीट की सुविधा | ऑटोकंप्लीट की सुविधा (नई सुविधा) | ऑटोकंप्लीट की सुविधा में जोड़ी गई सुविधाएं (नई) |
अपनी API कुंजी पर सक्षम की जाने वाली Places API सेवा का वर्शन आपके ऐप्लिकेशन द्वारा उपयोग किए जाने वाले API को नियंत्रित करता है:
Places API: मौजूदा एपीआई चालू करता है. अगर आपके ऐप्लिकेशन के लिए इस्तेमाल की गई एपीआई पासकोड से जुड़े प्रोजेक्ट के लिए, सिर्फ़ जगहें एपीआई चालू है, तो आपके ऐप्लिकेशन को नए एपीआई का ऐक्सेस नहीं मिलेगा.
Places API (नया वर्शन): यह नीति, iOS के लिए बने SDK टूल (नया) में बताई गई सभी नए एपीआई और सुविधाओं को चालू करती है. आपके ऐप्लिकेशन के पास मौजूदा एपीआई का ऐक्सेस नहीं होगा.
दोनों: iOS के लिए Places SDK (नया) और iOS के लिए Places SDK टूल, दोनों के लिए सभी सुविधाओं और एपीआई को चालू करता है.
Places API सेवा चुनने के बारे में ज़्यादा जानकारी के लिए, अपना Google Cloud प्रोजेक्ट सेट अप करना लेख पढ़ें.
नए एपीआई पर माइग्रेट करें
अगर किसी मौजूदा एपीआई का इस्तेमाल किया जा रहा है और आपको नए एपीआई पर माइग्रेट करना है, तो हर एपीआई के लिए, नीचे दी गई माइग्रेशन गाइड देखें:
- Nearby Search पर माइग्रेट करना (नया)
- Text Search पर माइग्रेट करना (नया)
- जगह की जानकारी पर माइग्रेट करना (नई जानकारी)
- जगह की फ़ोटो पर माइग्रेट करें (नई)
- ऑटोकंप्लीट सुविधा पर माइग्रेट करना (नई सुविधा)
Places API में मुख्य सुविधाएं जोड़ी गईं (नई)
इस सेक्शन में, Places API (नया) में जोड़ी गई मुख्य सुविधाओं के बारे में बताया गया है.
Google Cloud के स्टैंडर्ड प्लैटफ़ॉर्म पर लागू की गई
Places API (नया वर्शन) को Google Cloud पर मौजूद सेवा के इन्फ़्रास्ट्रक्चर पर लागू किया गया. लागू करने से, यह ज़्यादा सुरक्षित और भरोसेमंद प्लैटफ़ॉर्म बन गया है. इसमें OAuth जैसे बेहतर सुरक्षा विकल्प भी शामिल हैं. इस स्टैंडर्ड एपीआई डिज़ाइन से, सभी एपीआई को एक जैसा लेवल मिलता है. इससे, Places API (नया वर्शन) की मदद से डेवलपमेंट की क्षमता बेहतर होती है.
बेहतर परफ़ॉर्मेंस
Places API (नया वर्शन), इसकी परफ़ॉर्मेंस को बेहतर बनाता है. इससे, मौजूदा Places API का इस्तेमाल करने वाले ऐप्लिकेशन की जगह, नए ऐप्लिकेशन को इस्तेमाल करना आसान हो जाता है.
आसान कीमत
Places API (नया वर्शन) की मदद से कीमत को आसान बनाया गया है, ताकि आप सिर्फ़ इस्तेमाल किए गए डेटा के लिए पैसे चुकाएं. फ़ील्ड मास्क का इस्तेमाल करके, आसान कीमत लागू की जाती है.
जगह की जानकारी (नया), आस-पास की खोज (नया), और टेक्स्ट सर्च (नया) के साथ, फ़ील्ड मास्क का इस्तेमाल करके, जवाब में वापस आने के लिए फ़ील्ड की सूची को कंट्रोल किया जा सकता है. इसके बाद, आपको सिर्फ़ उस डेटा का बिल भेजा जाता है जिसका अनुरोध किया गया है. फ़ील्ड मास्किंग का इस्तेमाल करना, डिज़ाइन का एक अच्छा तरीका है. इससे यह पक्का किया जाता है कि आप गैर-ज़रूरी डेटा का अनुरोध न करें. इससे प्रोसेसिंग में लगने वाले समय और बिलिंग शुल्क से बचने में मदद मिलती है.
किसी जगह के लिए, एक जैसे रिस्पॉन्स का डेटा
मौजूदा एपीआई के साथ, जगह की जानकारी, आस-पास खोज करने की सुविधा, और टेक्स्ट सर्च एपीआई ने किसी जगह के लिए रिस्पॉन्स का अलग-अलग डेटा दिखाया है. Places API (नया वर्शन) रिस्पॉन्स को स्टैंडर्ड तय करता है, ताकि ये सभी एपीआई किसी जगह के लिए एक जैसा डेटा दिखाएं.
बढ़ाई गई जगहों के टाइप
एपीआई से मिले रिस्पॉन्स में, अब जगह का प्राइमरी टाइप शामिल किया जा सकता है. हर जगह के लिए एक टाइप की वैल्यू हो सकती है, जिसे जगह के प्राइमरी टाइप के तौर पर बताया गया हो, जैसा कि टेबल A में बताया गया है.
इसके अलावा, एपीआई का नया वर्शन, नीचे दी गई टेबल में दिखाई गई जगहों के टाइप को जोड़ता है. आप इन नए प्रकारों और मौजूदा प्रकारों का उपयोग आस-पास खोज (नया) और टेक्स्ट खोज (नया) के साथ खोज के लिए कर सकते हैं. सभी नए टाइप, टेबल 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
जगह का डाइनैमिक डेटा
Places API (नया वर्शन), डाइनैमिक रिस्पॉन्स डेटा के साथ काम करता है. जैसे, ईवी चार्जिंग स्टेशन की उपलब्धता या किसी पेट्रोल पंप के लिए ईंधन की नई कीमतें. उपयोगकर्ता अनुभव को बेहतर बनाने के लिए, इन रिस्पॉन्स फ़ील्ड का इस्तेमाल करें.
आपको कौनसा एपीआई चुनना है?
ऐप्लिकेशन डेवलपमेंट शुरू करने से पहले, आपको अपना एपीआई चुनना होगा:
अगर आप एक नए ग्राहक हैं और आपने Places API का इस्तेमाल अभी शुरू किया है, तो नए एपीआई के साथ शुरुआत करें.
अगर आप नए ग्राहक हैं और किसी मौजूदा एपीआई की जगह कोई दूसरा एपीआई उपलब्ध नहीं है, जैसे कि 'जगह के हिसाब से अपने-आप पूरा होना' या 'क्वेरी ऑटोकंप्लीट' सुविधा, तो नए और मौजूदा एपीआई, दोनों का इस्तेमाल किया जा सकता है.
अगर आप मौजूदा ग्राहक हैं, तो मौजूदा एपीआई का इस्तेमाल करना जारी रखा जा सकता है. हालांकि, परफ़ॉर्मेंस में हुए सुधारों और Places API (नया वर्शन) की सुविधा को बेहतर बनाने के लिए, नए एपीआई पर माइग्रेट किया जा सकता है.
माइग्रेशन के बारे में ज़्यादा जानकारी के लिए, माइग्रेशन की खास जानकारी देखें.