Places API (नया) के बारे में खास जानकारी

Places API (नया वर्शन) एक वेब सेवा है. यह कारोबारों, भौगोलिक जगहों, और लोकप्रिय जगहों की जानकारी का डेटा JSON फ़ॉर्मैट में दिखाती है. इसमें टेक्स्ट से खोजें (नया), आस-पास की जगहों की जानकारी (नया), ऑटोकंप्लीट (नया), जगह की जानकारी (नया), और जगह की फ़ोटो (नया) की सुविधा काम करती है.

Places API (नया वर्शन): अहम जानकारी

  • प्रॉडक्ट: Places API (नया प्रॉडक्ट)
  • इसे इस नाम से भी जाना जाता है: Places API
  • कैटगरी: जगहें
  • प्लैटफ़ॉर्म: वेब सेवा (REST)
  • इस पर चलता है: सर्वर (बैकएंड कोड)
  • लॉन्च स्टेज: GA
  • लाइफ़साइकल: चालू है
  • खास जानकारी: Places API (नया) के बारे में खास जानकारी
  • क्षेत्र के हिसाब से उपलब्धता: दुनिया भर में. ईईए के बिलिंग पते वाले प्रोजेक्ट, Google Maps Platform की ईईए से जुड़ी सेवा की शर्तों (8 जुलाई, 2025 से लागू) का इस्तेमाल करते हैं. इनके तहत, अक्षांश, देशांतर, और जगह के आईडी के अलावा, Places API के कॉन्टेंट को किसी भी मैप के साथ इस्तेमाल नहीं किया जा सकता. हालांकि, जगहों की जानकारी देने वाली यूआई किट के ज़रिए ऐसा किया जा सकता है. एआई की मदद से जगहों, समीक्षाओं, और इलाकों की खास जानकारी पाने की सुविधा, सिर्फ़ उन भाषाओं और देशों/इलाकों में उपलब्ध है जहां यह सुविधा काम करती है.

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

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

  • आपको टेक्स्ट क्वेरी (टेक्स्ट से खोजें (नया)) या किसी जगह के आस-पास (आस-पास की जगहों की जानकारी (नया)) का इस्तेमाल करके, सर्वर से जगहों की जानकारी खोजनी होगी.
  • आपको ऑटोकंप्लीट (नया) की मदद से, बैकएंड से जगह या क्वेरी के सुझाव चाहिए.
  • आपके पास जगह का आईडी है और आपको पता, फ़ोन नंबर, रेटिंग, समीक्षाएं या फ़ोटो जैसी जानकारी चाहिए.
  • आपको किसी जगह के लिए, एआई की मदद से जनरेट की गई जगह, समीक्षा या इलाके की खास जानकारी चाहिए.

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

  • आपको नेटिव Android ऐप्लिकेशन बनाना है. इसके बजाय, Places SDK for Android का इस्तेमाल करें.
  • नेटिव iOS ऐप्लिकेशन बनाया जा रहा है. इसके बजाय, Places SDK for iOS का इस्तेमाल करें.
  • आपको ब्राउज़र वेब ऐप्लिकेशन बनाना है और JavaScript में जगहों की लाइब्रेरी लोड करनी है. इसके बजाय, Maps JavaScript API का इस्तेमाल करें.

Places API (नया): सेटअप

Places API (नया) के आधिकारिक पैकेज:

  • npm: @googlemaps/places
  • pypi: google-maps-places
  • go: cloud.google.com/go/maps

Places API (नया): आम तौर पर होने वाली गलतियां

  • समस्या: Place Details (New), आस-पास की जगहों की जानकारी (New), और टेक्स्ट से खोजें (New) में, दिखाए जाने वाले फ़ील्ड की कोई डिफ़ॉल्ट सूची नहीं होती. फ़ील्ड मास्क के बिना किए गए अनुरोधों में गड़बड़ी दिखती है. ठीक करने का तरीका: fields या $fields पैरामीटर या X-Goog-FieldMask हेडर के साथ, रिस्पॉन्स फ़ील्ड मास्क पास करें. /maps/documentation/places/web-service/choose-fields देखें.
  • समस्या: अगर सेशन खत्म होने के बाद, Autocomplete (New) सेशन टोकन को शामिल नहीं किया जाता या उसका फिर से इस्तेमाल किया जाता है, तो हर अनुरोध के लिए अलग से बिल भेजा जाता है. इसे SKU: Autocomplete Requests के तौर पर बिल किया जाता है. समाधान: हर सेशन के लिए एक नया सेशन टोकन जनरेट करें. हमारा सुझाव है कि आप UUID v4 का इस्तेमाल करें. साथ ही, सेशन को Place Details (New) या Address Validation के अनुरोध के साथ खत्म करें. /maps/documentation/places/web-service/place-session-tokens देखें.
  • समस्या: किसी प्रोजेक्ट पर Places API (लेगसी) या Maps JavaScript API PlacesService को कॉल करने वाला मौजूदा या एआई से जनरेट किया गया कोड, LegacyApiNotActivatedMapError के साथ काम नहीं करता. ऐसा तब होता है, जब लेगसी एपीआई चालू न हो. ठीक करने का तरीका: कॉल को Places API (New) पर माइग्रेट करें और ज़रूरी फ़ील्ड मास्क शामिल करें. /maps/legacy#LegacyApiNotActivatedMapError देखें.
  • समस्या: सेव किए गए जगह के आईडी पुराने हो सकते हैं. ऐसे में, Place Details (New) NOT_FOUND (एचटीटीपी 404) दिखाता है. साथ ही, गलत फ़ॉर्मैट वाले या अधूरे आईडी, एचटीटीपी 400 INVALID_ARGUMENT दिखाते हैं. ठीक करने का तरीका: स्टोर किए गए उन जगह के आईडी को रीफ़्रेश करें जो 12 महीने से ज़्यादा पुराने हैं. इसके लिए, Place Details (New) का अनुरोध करें. इसमें सिर्फ़ id फ़ील्ड की जानकारी मांगी जाती है. इसके लिए कोई शुल्क नहीं लिया जाता. /maps/documentation/places/web-service/place-id#refresh-id देखें.

Places API (नया वर्शन) की मदद से क्या-क्या किया जा सकता है

हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.

Places API (नया): जनरेटिव एआई

Places API (नया): Places