Places API (लेगसी) के लिए क्विक रेफ़रंस

अक्टूबर 2026 से, नए Google Cloud प्रोजेक्ट के लिए Places API (लेगसी) को चालू नहीं किया जा सकेगा. मौजूदा प्रोजेक्ट पूरी तरह से काम करते रहेंगे. नई सुविधाओं और बेहतर परफ़ॉर्मेंस के लिए, Places API (New) पर माइग्रेट करें.

Places API (लेगसी): अहम जानकारी

  • प्रॉडक्ट: Places API (लेगसी)
  • इसे इस नाम से भी जाना जाता है: Places API (लेगसी वेब सेवा), Places API वेब सेवा (maps/api/place)
  • कैटगरी: जगहें
  • प्लैटफ़ॉर्म: वेब सेवा (REST)
  • इस पर चलता है: सर्वर (बैकएंड कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: लेगसी
  • इसकी जगह इस्तेमाल किया जा रहा है: Places API (नया)
  • खास जानकारी: Places API (लेगसी) के बारे में खास जानकारी

Places API (लेगसी): इसका इस्तेमाल कब करना चाहिए

Places API (लेगसी) का इस्तेमाल तब करें, जब:

  • आपके पास कोई ऐसा मौजूदा प्रोजेक्ट है जिसमें Places API (लेगसी) पहले से चालू है और maps.googleapis.com/maps/api/place एंडपॉइंट को कॉल करता है.
  • माइग्रेट करते समय, आपको Find Place, आस-पास की जगहों की जानकारी, टेक्स्ट से खोजें, जगह के बारे में ज़्यादा जानकारी, Place Photos या ऑटोकंप्लीट (लेगसी) के मौजूदा कॉल की ज़रूरत होगी, ताकि काम जारी रखा जा सके.

Places API (लेगसी) का इस्तेमाल तब न करें, जब:

  • आपने एक नया Google Cloud प्रोजेक्ट बनाने की प्रोसेस शुरू की है. अक्टूबर 2026 से, Places API (लेगसी) को नए प्रोजेक्ट के लिए चालू नहीं किया जा सकेगा. इसके बजाय, Places API (नया) का इस्तेमाल करें.
  • आपको आस-पास की जगहों की जानकारी और टेक्स्ट से खोजने की सुविधा के लिए, नई सुविधाएं, OAuth से पुष्टि करने की सुविधा या फ़ील्ड मास्क की ज़रूरत है, ताकि आपको सिर्फ़ उन फ़ील्ड के लिए पैसे चुकाने पड़ें जिनके लिए आपने अनुरोध किया है. इसके बजाय, Places API (नया) का इस्तेमाल करें.
  • आपको नए कोड में, Find Place (लेगसी) या क्वेरी ऑटोकंप्लीट (लेगसी) की ज़रूरत है. टेक्स्ट से खोजें (नया) और ऑटोकंप्लीट (नया) ने उनकी जगह ले ली है. इसके बजाय, Places API (नया) का इस्तेमाल करें.

Places API (लेगसी): सेटअप

Places API (लेगसी): सामान्य गलतियां

  • समस्या: अगर जगह की जानकारी (लेगसी) के अनुरोध में fields पैरामीटर शामिल नहीं किया जाता है या कोई फ़ील्ड नहीं बताया जाता है, तो एपीआई सभी फ़ील्ड दिखाता है और उन सभी के लिए आपसे शुल्क लेता है. ठीक करने का तरीका: हमेशा fields पैरामीटर सेट करें या फ़ील्ड मास्क के साथ, Place Details (New) पर माइग्रेट करें. /maps/documentation/places/web-service/legacy/details देखें.
  • समस्या: आस-पास की जगहों की जानकारी (लेगसी) और टेक्स्ट से खोजें (लेगसी) की मदद से, यह तय नहीं किया जा सकता कि कौनसे फ़ील्ड दिखाए जाएं. ये हमेशा फ़ील्ड का एक तय सेट (जगह की जानकारी वाले फ़ील्ड का सबसेट) दिखाते हैं. साथ ही, बुनियादी डेटा, संपर्क डेटा, और माहौल से जुड़े डेटा के एसकेयू को ट्रिगर करते हैं. ठीक करने का तरीका: फ़ील्ड मास्क के साथ, आस-पास की जगहों की जानकारी (नया) या टेक्स्ट से खोजें (नया) पर माइग्रेट करें. इसके अलावा, Find Place (लेगसी) के साथ fields पैरामीटर का इस्तेमाल करके, सिर्फ़ उन फ़ील्ड के लिए अनुरोध करें और पेमेंट करें जिनकी आपको ज़रूरत है. /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku देखें.
  • समस्या: photo_reference को कैश मेमोरी में सेव नहीं किया जा सकता और इसकी समयसीमा खत्म हो सकती है. इसलिए, सेव किए गए रेफ़रंस काम करना बंद कर देते हैं. ठीक करने का तरीका: फ़ोटो का अनुरोध करने से पहले, जगह की जानकारी, Find Place, आस-पास की जगहों की जानकारी या टेक्स्ट से खोजें के जवाब से नया photo_reference पाएं. /maps/documentation/places/web-service/legacy/photos देखें.
  • समस्या: अगर किसी ऐसे प्रोजेक्ट से Places API (लेगसी) को कॉल किया जाता है जिसमें यह एपीआई चालू नहीं है, तो आपको गड़बड़ी का मैसेज REQUEST_DENIED मिलेगा. इसमें लिखा होगा कि "आपने लेगसी एपीआई को कॉल किया है, जो आपके प्रोजेक्ट के लिए चालू नहीं है..." LegacyApiNotActivatedMapError. अक्टूबर 2026 से, Places API (लेगसी) को नए प्रोजेक्ट के लिए चालू नहीं किया जा सकेगा. ठीक करने का तरीका: नए प्रोजेक्ट के लिए Places API (नया) का इस्तेमाल करें और मौजूदा ऐप्लिकेशन को माइग्रेट करें. माइग्रेट करते समय, लेगसी पेज पर मौजूद सुझाव, राय देने या शिकायत करने के लिए फ़ॉर्म का इस्तेमाल करके, लेगसी एपीआई को कुछ समय के लिए चालू करने का अनुरोध किया जा सकता है. /maps/legacy#LegacyApiNotActivatedMapError देखें.

Places API (लेगसी): लेगसी और बंद की जा चुकी सुविधाएं