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