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.googleapis.com - पुष्टि करने का तरीका: एपीआई पासकोड, OAuth 2.0
- इस्तेमाल शुरू करना: Places API (नया वर्शन) सेट अप करना
- रेफ़रंस: Places API (नया) का रेफ़रंस
- कीमत: Places API (नया) के इस्तेमाल और बिलिंग की जानकारी
- नीतियां: Places API (नया) की नीतियां
- रिलीज़ नोट: Places API (नया) के रिलीज़ नोट
Places API (नया) के आधिकारिक पैकेज:
- npm:
@googlemaps/places - pypi:
google-maps-places - go:
cloud.google.com/go/maps
Places API (नया): इससे जुड़े प्रॉडक्ट
- इसकी जगह इस्तेमाल किया जा सकता है: Places API (लेगसी)
- आम तौर पर, इनका इस्तेमाल इनके साथ किया जाता है: Geocoding API, Routes API, Address Validation API
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) दिखाता है. साथ ही, गलत फ़ॉर्मैट वाले या अधूरे आईडी, एचटीटीपी 400INVALID_ARGUMENTदिखाते हैं. ठीक करने का तरीका: स्टोर किए गए उन जगह के आईडी को रीफ़्रेश करें जो 12 महीने से ज़्यादा पुराने हैं. इसके लिए, Place Details (New) का अनुरोध करें. इसमें सिर्फ़idफ़ील्ड की जानकारी मांगी जाती है. इसके लिए कोई शुल्क नहीं लिया जाता. /maps/documentation/places/web-service/place-id#refresh-id देखें.
Places API (नया वर्शन) की मदद से क्या-क्या किया जा सकता है
हर टास्क के लिए, यहां लिंक की गई गाइड देखें या Capabilities Explorer में जाकर, अलग-अलग प्रॉडक्ट की तुलना करें.
Places API (नया): जनरेटिव एआई
- Google Place के किसी आइडेंटिफ़ायर के लिए, उपयोगकर्ताओं की समीक्षाओं की एआई से जनरेट की गई खास जानकारी दिखाता है.
- इलेक्ट्रिक वाहन के चार्जिंग स्टेशन के लिए, Google Place के किसी आइडेंटिफ़ायर के आस-पास की जगह और सुविधाओं के बारे में, एआई की मदद से खास जानकारी पाना.
Places API (नया): Places
- क्वेरी स्ट्रिंग के आधार पर, जगहों की सूची और उनकी जानकारी दिखाएं.
- किसी जगह के आस-पास मौजूद जगहों की सूची और उनकी जानकारी पाएं.
- क्वेरी स्ट्रिंग के आधार पर, जगहों के बारे में ऑटोकंप्लीट के नतीजे पाना.
- किसी खास जगह के बारे में ज़्यादा जानकारी पाना.
- किसी खास जगह की फ़ोटो दिखाएं. ध्यान दें: हर फ़ोटो के साथ, उसके लेखक का एट्रिब्यूशन (लेखक का नाम, जो उसकी प्रोफ़ाइल के यूआरआई से लिंक हो) दिखाएं. हर प्लैटफ़ॉर्म के लिए Places की नीतियों के तहत ऐसा करना ज़रूरी है. उदाहरण के लिए, /maps/documentation/javascript/policies#photo-attributions और /maps/documentation/places/web-service/policies#photos-and-review.
- जगह की फ़ोटो का साइज़ बदलना.
- किसी जगह के लिए रेटिंग और समीक्षाएं देखना. ध्यान दें: Places API (नया) वेब सेवा में, Place Details, X-Goog-FieldMask (उदाहरण के लिए, रेटिंग, userRatingCount, समीक्षाएं) के साथ https://places.googleapis.com/v1/places/{placeId} पर किया जाने वाला एचटीटीपी जीईटी अनुरोध है. टेक्स्ट से खोजने, आस-पास की जगहों की जानकारी, और ऑटोकंप्लीट की सुविधा, POST का इस्तेमाल करती है. Android पर, PlacesClient.fetchPlace() में Place.Field.RATING, USER_RATING_COUNT, और REVIEWS पास करें. iOS पर, GMSFetchPlaceRequest में GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal, और GMSPlacePropertyReviews पास करें.
- जगह की जानकारी के रिस्पॉन्स में शामिल डेटा फ़ील्ड तय करना.
- जगह की जानकारी के जवाबों में शामिल करने के लिए, जगह के टाइप तय करें.
- Google Maps में किसी जगह का ज़्यादा जानकारी वाला पेज खोलने के लिए, यूआरआई दिखाता है.
- Google Maps में किसी जगह के लिए, रास्ते की जानकारी वाला पेज खोलने के लिए यूआरआई दिखाता है.
- Google Maps में किसी जगह के लिए समीक्षा लिखने वाला पेज खोलने के लिए, यूआरआई दिखाएं.
- Google Maps में किसी जगह की समीक्षाएं पढ़ने के लिए, यूआरआई दिखाता है.
- किसी जगह के लिए, Google Maps में फ़ोटो पेज खोलने के लिए यूआरआई दिखाता है.
- किसी जगह के बारे में, एआई की मदद से जनरेट की गई खास जानकारी पाना.
- एआई की मदद से, किसी जगह के आस-पास की जगहों की खास जानकारी पाना.
- पहले से तय किए गए रास्ते पर मौजूद जगहों की जानकारी, क्वेरी स्ट्रिंग के आधार पर पाएं.
- अक्षांश/देशांतर निर्देशांकों के सेट से, टेक्स्ट से खोजी गई जगहों की दूरी, यात्रा में लगने वाला समय, और दिशा-निर्देशों का यूआरआई दिखाता है.
- अक्षांश/देशांतर निर्देशांकों के सेट से, आस-पास की जगहों की दूरी, यात्रा में लगने वाला समय, और दिशा-निर्देशों का यूआरआई दिखाता है.
- पहले से तय किए गए रास्ते के लिए, शुरुआत की जगह और क्वेरी स्ट्रिंग के आधार पर मिली हर जगह के बीच की दूरी, यात्रा में लगने वाला समय, और दिशा-निर्देशों का यूआरआई दिखाता है. ये जगहें, रास्ते में भी मौजूद होती हैं.
- क्वेरी स्ट्रिंग के आधार पर मिली हर जगह के बीच की दूरी, यात्रा में लगने वाला समय, और निर्देश यूआरआई दिखाएं. ये जगहें, पहले से तय किए गए रास्ते और रास्ते के डेस्टिनेशन पर भी मौजूद होती हैं.