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