Method: places.get

किसी जगह के संसाधन के नाम के आधार पर उसकी जानकारी पाएं. यह places/{placeId} फ़ॉर्मैट में एक स्ट्रिंग होती है.

एचटीटीपी अनुरोध

GET https://places.googleapis.com/v1/{name=places/*}

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. किसी जगह का संसाधन नाम, जो places/{placeId} फ़ॉर्मैट में होता है.

क्वेरी पैरामीटर

पैरामीटर
languageCode

string

ज़रूरी नहीं. अगर चुनी गई भाषा में जगह की जानकारी उपलब्ध है, तो वह उसी भाषा में दिखेगी.

फ़िलहाल, इन भाषाओं में जानकारी उपलब्ध है: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

ज़रूरी नहीं. वह देश/इलाका जहां से अनुरोध किया गया है उसका यूनिकोड कोड (CLDR). इस पैरामीटर का इस्तेमाल, जगह की जानकारी दिखाने के लिए किया जाता है. जैसे, अगर जगह के नाम की जानकारी, इलाके के हिसाब से उपलब्ध है, तो वह दिखाई जाएगी. लागू कानून के आधार पर, इस पैरामीटर से नतीजों पर असर पड़ सकता है. ज़्यादा जानकारी के लिए, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html पर जाएं.

ध्यान दें कि फ़िलहाल, तीन अंकों वाले इलाके के कोड काम नहीं करते.
sessionToken

string

ज़रूरी नहीं. यह एक स्ट्रिंग है, जिससे बिलिंग के मकसद से, Autocomplete सेशन की पहचान की जाती है. यह यूआरएल और फ़ाइल के नाम के लिए सुरक्षित, base64 स्ट्रिंग होनी चाहिए. साथ ही, इसमें ज़्यादा से ज़्यादा 36 ASCII वर्ण होने चाहिए. ऐसा न होने पर, INVALID_ARGUMENT गड़बड़ी दिखती है.

सेशन तब शुरू होता है, जब उपयोगकर्ता कोई क्वेरी टाइप करना शुरू करता है. यह तब खत्म होता है, जब वह कोई जगह चुनता है और Place Details या Address Validation के लिए कॉल करता है. हर सेशन में कई क्वेरी हो सकती हैं. इसके बाद, Place Details या Address Validation के लिए एक अनुरोध किया जा सकता है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए गए क्रेडेंशियल, एक ही Google Cloud Console प्रोजेक्ट से जुड़े होने चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता. आपके ऐप्लिकेशन को हर सेशन के लिए नया टोकन जनरेट करना होगा. अगर sessionToken पैरामीटर शामिल नहीं किया जाता है या सेशन टोकन को दोबारा इस्तेमाल किया जाता है, तो सेशन के लिए शुल्क लिया जाता है. ऐसा माना जाता है कि कोई सेशन टोकन नहीं दिया गया है. इस स्थिति में, हर अनुरोध के लिए अलग से शुल्क लिया जाता है.

हमारा सुझाव है कि आप इन दिशा-निर्देशों का पालन करें:

  • Place Autocomplete के सभी कॉल के लिए, सेशन टोकन का इस्तेमाल करें.
  • हर सेशन के लिए नया टोकन जनरेट करें. हमारा सुझाव है कि आप वर्शन 4 UUID का इस्तेमाल करें.
  • पक्का करें कि किसी सेशन में Place Autocomplete, Place Details, और Address Validation के सभी अनुरोधों के लिए इस्तेमाल किए गए क्रेडेंशियल, एक ही Cloud Console प्रोजेक्ट से जुड़े हों.
  • हर नए सेशन के लिए, एक यूनीक सेशन टोकन पास करें. एक से ज़्यादा सेशन के लिए एक ही टोकन का इस्तेमाल करने पर, हर अनुरोध के लिए अलग-अलग शुल्क लिया जाएगा.

अनुरोध का मुख्य हिस्सा

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Place का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth अनुमति की ज़रूरत होती है:

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform