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