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