Google का सुझाव है कि आपको ऑटोकंप्लीट (नया) के साथ सेशन का इस्तेमाल करना चाहिए. सेशन की मदद से, कीमत तय करना आसान हो जाता है. साथ ही, ये अपने-आप पूरा होने की सुविधा (नई) के साथ इस्तेमाल करने के लिए, कीमत तय करने का एक जैसा मॉडल उपलब्ध कराते हैं.
सेशन की शुरुआत, ऑटोकंप्लीट (नया) के पहले अनुरोध से होती है. इसमें सेशन टोकन शामिल होता है. यह ऑटोकंप्लीट (नया) के हर अनुरोध के साथ जारी रहता है. इसके बाद, इसे Place Details (नया) या Address Validation के अनुरोध से खत्म कर दिया जाता है. इस अनुरोध में सेशन टोकन का इस्तेमाल किया जाता है.
सत्र खत्म होने के बाद, Autocomplete (नया), Place Details (नया) या Address Validation को किए गए किसी भी कॉल के लिए, ऐसे बिलिंग की जाती है जैसे कोई सेशन टोकन इस्तेमाल नहीं किया गया हो. ऐसा तब होता है, जब कॉल में इस्तेमाल किया गया सेशन टोकन खत्म हो चुका हो.
अधूरे सेशन का मतलब ऐसे सेशन से है जिन्हें Place Details (नया) या Address Validation के अनुरोध से खत्म नहीं किया गया है. ऐसे सेशन के लिए, सिर्फ़ Autocomplete (नया) के अनुरोधों का बिल भेजा जाता है. इसके लिए, SKU: ऑटोकंप्लीट के अनुरोध का इस्तेमाल किया जाता है.
सेशन के हिसाब से बिलिंग
जगह की जानकारी (नई) के अनुरोध पर खत्म होने वाले सेशन
SKU: Places API Place Details Essentials से फ़ील्ड का इस्तेमाल करके किए गए अनुरोध में खत्म होने वाले, ऑटोकंप्लीट (नया) सेशन के लिए:
- अपने-आप पूरा होने की सुविधा (नई) के पहले 12 अनुरोध: आपसे अपने-आप पूरा होने की सुविधा (नई) के हर अनुरोध के लिए शुल्क लिया जाता है. यह शुल्क ज़्यादा से ज़्यादा 12 अनुरोधों के लिए लिया जाता है. इसके लिए, SKU: अपने-आप पूरा होने की सुविधा के अनुरोध का इस्तेमाल किया जाता है.
- एक ही सेशन में, ऑटोकंप्लीट (नया) के 13 या इससे ज़्यादा अनुरोधों के लिए: आपसे SKU: ऑटोकंप्लीट सेशन के इस्तेमाल के हिसाब से शुल्क लिया जाता है. इसका मतलब है कि इन अनुरोधों के लिए कोई शुल्क नहीं लिया जाता.
- जगह के बारे में ज़्यादा जानकारी (नया) देने वाले एपीआई के लिए ज़रूरी शर्तें: अनुरोध रद्द करने पर भी आपसे SKU: Places API Place Details Essentials के लिए शुल्क लिया जाएगा.
Address Validation या Place Details (नई) (गैर-Essentials) के अनुरोधों में खत्म होने वाले सेशन
ऑटोकंप्लीट (नया) सेशन के लिए, जो Address Validation अनुरोध या Place Details (नया) के अनुरोध में खत्म होते हैं. इसके लिए, Place Details Pro, Enterprise या Enterprise + Atmosphere से फ़ील्ड का इस्तेमाल किया जाता है:
- ऑटोकंप्लीट (नया) अनुरोध: ऑटोकंप्लीट (नया) के सभी अनुरोधों के लिए, एसकेयू: ऑटोकंप्लीट सेशन के इस्तेमाल के हिसाब से बिल भेजा जाता है. इसका मतलब है कि इन अनुरोधों के लिए कोई शुल्क नहीं लिया जाता है.
-
जगह के बारे में ज़्यादा जानकारी (नया) या पते की पुष्टि करने का अनुरोध: आपसे अनुरोध रद्द करने के लिए भी शुल्क लिया जाता है. इसके लिए, सही एसकेयू का इस्तेमाल किया जाता है:
- जगह के बारे में ज़्यादा जानकारी (नई) के अनुरोधों को खत्म करने के लिए, एसकेयू: जगह के बारे में ज़्यादा जानकारी Enterprise + Atmosphere के हिसाब से बिल भेजा जाता है. भले ही, अनुरोध किए गए फ़ील्ड कुछ भी हों.
- पते की पुष्टि करने के अनुरोधों को बंद करने के लिए, SKU: Address Validation Enterprise के हिसाब से बिल भेजा जाता है.
सेशन की कीमत तय करने के उदाहरण
सेशन की कीमत तय करने के तीन सबसे सामान्य तरीके ये हैं:
- जगह की जानकारी के लिए ऑटोकंप्लीट सुविधा
- जगह की जानकारी अपने-आप पूरी होने की सुविधा
- चेकआउट और डिलीवरी के लिए ऑटोकंप्लीट सुविधा
यहां दिए गए सेक्शन में, हर स्थिति के लिए अलग-अलग बिलिंग शुल्क के बारे में बताया गया है.
जगह की जानकारी के डेटा के लिए ऑटोकंप्लीट की सुविधा
जगह की जानकारी के डेटा के लिए ऑटोकंप्लीट सुविधा का इस्तेमाल करने के उदाहरण में, आपको किसी जगह की जानकारी पाने के लिए, ऑटोकंप्लीट (नया) और Place Details (नया) का इस्तेमाल करना है. उदाहरण के लिए, आपने ऑटोकंप्लीट (नया) से कोई सुझाव चुना. इसके बाद, आपने Place Details (नया) का इस्तेमाल करके, उस जगह के अक्षांश और देशांतर के निर्देशांक पाए, ताकि उस जगह को मैप पर दिखाया जा सके.
जगह की जानकारी में यह शामिल हो सकता है:
- पता
- अक्षांश और देशांतर के कोऑर्डिनेट के तौर पर जगह की जानकारी
- Plus Code
- टाइप
- व्यूपोर्ट
इस सेशन को, Place Details (नया) के एक अनुरोध से बंद कर दिया जाता है. यह अनुरोध, SKU: Place Details Essentials में तय किए गए फ़ील्ड के लिए किया जाता है.
इसके बाद, आपसे इस तरह बिल लिया जाता है:
- ऑटोकंप्लीट (नई) सुविधा के पहले 12 अनुरोधों के लिए, एसकेयू: ऑटोकंप्लीट के अनुरोध के हिसाब से बिल भेजा जाता है.
- ऑटोकंप्लीट (नया) के बाकी बचे अनुरोधों के लिए, SKU: ऑटोकंप्लीट सेशन का इस्तेमाल के हिसाब से बिल भेजा जाता है. इसका मतलब है कि इन अनुरोधों के लिए कोई शुल्क नहीं लिया जाता.
- जगह के बारे में ज़्यादा जानकारी (नया) के अनुरोध को बंद करने पर, SKU: Places API Place Details Essentials के हिसाब से शुल्क लिया जाता है.
जगह की जानकारी खोजने के लिए, अपने-आप सुझाव मिलने की सुविधा
जगह की जानकारी खोजने के लिए, अपने-आप भरने की सुविधा का इस्तेमाल करने पर, आपको किसी जगह के बारे में सिर्फ़ जगह की जानकारी का डेटा से ज़्यादा जानकारी चाहिए होती है. उदाहरण के लिए, इनमें से किसी भी चीज़ का अनुरोध किया जा सकता है:
- सुलभता से जुड़े विकल्प
- कारोबार के खुले होने का मौजूदा समय
- पार्किंग के विकल्प
- समीक्षाएं
- रेटिंग
इस स्थिति में, Place Details (New) के लिए किए गए एक अनुरोध से ही आपका सेशन खत्म हो जाता है. इस अनुरोध में, Place Details (New) Pro, Enterprise या Enterprise + Atmosphere SKU में शामिल कोई भी फ़ील्ड शामिल हो सकता है.
इसके बाद, आपसे इस तरह बिल लिया जाता है:
- अपने-आप पूरा होने की सुविधा (नई) के सभी अनुरोधों के लिए, एसकेयू: अपने-आप पूरा होने की सुविधा के सेशन का इस्तेमाल के हिसाब से बिल भेजा जाता है. इसका मतलब है कि इन अनुरोधों के लिए कोई शुल्क नहीं लिया जाता.
- Place Details (नया) के अनुरोध को बंद करने के लिए, SKU: Places API Place Details Enterprise + Atmosphere के हिसाब से बिल भेजा जाता है.
चेकआउट और डिलीवरी के लिए अपने-आप पूरी होने की सुविधा
Address Validation API एक ऐसी सेवा है जो पते को स्वीकार करती है. यह पते के कॉम्पोनेंट की पहचान करता है और उनकी पुष्टि करता है. यह पते को इस हिसाब से भी बनाता है कि उस पर डाक या कूरियर भेजा जा सके. साथ ही, उसके लिए सबसे सटीक अक्षांश और देशांतर के निर्देशांक का पता लगाता है.
चेकआउट और डिलीवरी के लिए अपने-आप भरने की सुविधा के मामले में, चुने गए पते की पुष्टि करने के लिए, Address Validation API को अनुरोध भेजकर सेशन खत्म किया जाता है.
इसके बाद, आपसे इस तरह बिल लिया जाता है:
- अपने-आप पूरा होने की सुविधा (नई) के सभी अनुरोधों के लिए, एसकेयू: अपने-आप पूरा होने की सुविधा के सेशन का इस्तेमाल के हिसाब से बिल भेजा जाता है. इसका मतलब है कि इन अनुरोधों के लिए कोई शुल्क नहीं लिया जाता.
- अगर पता की पुष्टि करने के अनुरोध को खत्म करने से पहले, जगह की जानकारी के बारे में ज़रूरी जानकारी पाने का अनुरोध किया जाता है, तो इसके लिए कोई शुल्क नहीं लिया जाता.
- पते की पुष्टि करने के अनुरोध को बंद करने के लिए, SKU: Address Validation Enterprise के हिसाब से बिल भेजा जाता है.
सेशन के बिना कीमत
अगर सेशन का इस्तेमाल नहीं किया जाता है, तो आपको SKU: ऑटोकंप्लीट के अनुरोध का इस्तेमाल करके, ऑटोकंप्लीट (नया) के हर अनुरोध के लिए बिल भेजा जाता है.
अधूरे या छोड़े गए सेशन के लिए कीमत
अगर कोई सेशन बंद कर दिया जाता है, तो इसका मतलब है कि Place Details (New) या Address Validation API के लिए कॉल करके सेशन को खत्म नहीं किया गया है. ऐसे में, Autocomplete (New) API के अनुरोधों के लिए, हर अनुरोध के हिसाब से कीमत तय करने वाला मॉडल लागू हो जाता है. साथ ही, SKU: Autocomplete Requests के हिसाब से बिल भेजा जाता है.