Place Autocomplete (लेगसी) सेवा, सेशन टोकन का इस्तेमाल करती है. इससे, उपयोगकर्ता की ऑटोकंप्लीट खोज के क्वेरी और सिलेक्शन फ़ेज़ को बिलिंग के मकसद से एक अलग सेशन में ग्रुप किया जाता है. सेशन तब शुरू होता है, जब उपयोगकर्ता कोई क्वेरी टाइप करना शुरू करता है. यह तब खत्म होता है, जब उपयोगकर्ता कोई जगह चुनता है और Place Details (लेगसी) को कॉल किया जाता है. हर सेशन में, अपने-आप पूरी होने वाली कई क्वेरी हो सकती हैं. इसके बाद, एक जगह चुनी जाती है. किसी सेशन में हर अनुरोध के लिए इस्तेमाल किए गए एपीआई पासकोड, एक ही Google Cloud Console प्रोजेक्ट से जुड़े होने चाहिए. सेशन खत्म होने के बाद, टोकन मान्य नहीं रहता. आपके ऐप्लिकेशन को हर सेशन के लिए एक नया टोकन जनरेट करना होगा. अगर sessiontoken पैरामीटर को शामिल नहीं किया जाता है या सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन के लिए शुल्क इस तरह लिया जाता है जैसे कोई सेशन टोकन नहीं दिया गया हो. हर अनुरोध के लिए अलग से बिल भेजा जाता है.
हमारा सुझाव है कि आप इन दिशा-निर्देशों का पालन करें:
- अपने-आप पूरा होने वाले सभी सेशन के लिए, सेशन टोकन इस्तेमाल करें.
- हर सेशन के लिए एक नया टोकन जनरेट करें.
- पक्का करें कि किसी सेशन में, किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) और जगह की जानकारी (लेगसी) के सभी अनुरोधों के लिए इस्तेमाल किए गए एपीआई पासकोड, एक ही Google Cloud Console प्रोजेक्ट से जुड़े हों.
- पक्का करें कि हर नए सेशन के लिए, एक यूनीक सेशन टोकन पास किया जाए. एक से ज़्यादा सेशन के लिए एक ही टोकन का इस्तेमाल करने पर, हर अनुरोध के लिए अलग से बिल भेजा जाएगा.
आपके पास किसी अनुरोध से, ऑटोकंप्लीट सेशन टोकन को हटाने का विकल्प होता है. अगर सेशन टोकन को शामिल नहीं किया जाता है, तो हर अनुरोध के लिए अलग से बिल भेजा जाता है. इससे, ऑटोकंप्लीट - हर अनुरोध के लिए एसकेयू ट्रिगर होता है. अगर किसी सेशन टोकन का फिर से इस्तेमाल किया जाता है, तो सेशन को अमान्य माना जाता है. साथ ही, अनुरोधों के लिए शुल्क इस तरह लिया जाता है जैसे कोई सेशन टोकन नहीं दिया गया हो.
उदाहरण
जब उपयोगकर्ता कोई क्वेरी टाइप करता है, तो कुछ कीस्ट्रोक (हर वर्ण के लिए नहीं) के बाद, ऑटोकंप्लीट की सुविधा के लिए अनुरोध किया जाता है. इसके बाद, संभावित नतीजों की सूची दिखती है. जब उपयोगकर्ता, नतीजों की सूची में से कोई विकल्प चुनता है, तो उसे एक अनुरोध के तौर पर गिना जाता है. साथ ही, खोज के दौरान किए गए सभी अनुरोधों को एक साथ जोड़कर, एक अनुरोध के तौर पर गिना जाता है. अगर उपयोगकर्ता कोई जगह चुनता है, तो सर्च क्वेरी बिना किसी शुल्क के उपलब्ध होती है. साथ ही, सिर्फ़ जगह की जानकारी के डेटा के अनुरोध के लिए शुल्क लिया जाता है. अगर उपयोगकर्ता सेशन शुरू होने के कुछ मिनटों के अंदर कोई विकल्प नहीं चुनता है, तो सिर्फ़ सर्च क्वेरी के लिए शुल्क लिया जाता है.
किसी ऐप्लिकेशन के नज़रिए से, इवेंट के इस फ़्लो को देखें:
- एक उपयोगकर्ता, "पेरिस, फ़्रांस" खोजने के लिए क्वेरी टाइप करना शुरू करता है.
- उपयोगकर्ता के इनपुट का पता चलने पर, ऐप्लिकेशन एक नया सेशन टोकन, "टोकन A" बनाता है.
- उपयोगकर्ता के टाइप करने पर, एपीआई हर कुछ वर्णों के बाद, ऑटोकंप्लीट का अनुरोध करता है. इससे हर अनुरोध के लिए, संभावित नतीजों की एक नई सूची दिखती है:
"P"
"Par"
"Paris,"
"Paris, Fr"
- जब उपयोगकर्ता कोई विकल्प चुनता है:
- क्वेरी से मिलने वाले सभी अनुरोधों को ग्रुप किया जाता है और "टोकन A" से दिखाए गए सेशन में एक अनुरोध के तौर पर जोड़ा जाता है.
- उपयोगकर्ता के चुने गए विकल्प को जगह की जानकारी के अनुरोध के तौर पर गिना जाता है. साथ ही, इसे "टोकन A" से दिखाए गए सेशन में जोड़ा जाता है.
- सेशन खत्म हो जाता है और ऐप्लिकेशन "टोकन A" को खारिज कर देता है.
किसी जगह के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा (लेगसी) के अनुरोधों के लिए बिलिंग के तरीके के बारे में ज़्यादा जानने के लिए, इस्तेमाल और बिलिंग देखें.
सेशन टोकन बनाना
सेशन टोकन बनाने के लिए, अपनी पसंद के किसी भी प्रोग्रामैटिक तरीके का इस्तेमाल किया जा सकता है. हमारा सुझाव है कि सेशन टोकन के लिए, वर्शन 4 यूयूआईडी का इस्तेमाल करें.