Places API का इस्तेमाल और बिलिंग

फ़ील्ड मास्क के बारे में जानकारी

जगह की जानकारी (नया), आस-पास खोजने की सुविधा (नई), और टेक्स्ट से खोजने की सुविधा (नई) के लिए, एपीआई अनुरोधों में FieldMask हेडर का इस्तेमाल करें. इससे, जवाब में लौटाए जाने वाले फ़ील्ड की सूची तय की जा सकती है. इसके बाद, आपसे आपके अनुरोध पर लागू होने वाले सबसे महंगे एसकेयू का शुल्क लिया जाता है. इसका मतलब है कि अगर आपने Essentials और Pro, दोनों एसकेयू में फ़ील्ड चुने हैं, तो आपसे Pro एसकेयू के हिसाब से शुल्क लिया जाएगा.

फ़ील्ड मास्किंग का इस्तेमाल करना, डिज़ाइन का एक अच्छा तरीका है. इससे यह पक्का किया जा सकता है कि आपने बेवजह डेटा का अनुरोध न किया हो. इससे, प्रोसेसिंग में लगने वाले बेवजह समय और बिलिंग शुल्क से बचा जा सकता है.

ऑटोकंप्लीट (नया) सेशन के बारे में जानकारी

ऑटोकंप्लीट (नया) सेशन में, ऑटोकंप्लीट (नया) के एक या उससे ज़्यादा अनुरोध शामिल होते हैं. साथ ही, इसमें जगह की जानकारी (नया) का अनुरोध या पते की पुष्टि करने का अनुरोध भी शामिल होता है. एक ही सेशन टोकन को Autocomplete (New) अनुरोध और उसके बाद के Place Details (New) अनुरोध या Address Validation अनुरोध में पास किया जाता है.

सेशन, अपने-आप भरने की सुविधा (नया वर्शन) के पहले अनुरोध से शुरू होता है. जब उपयोगकर्ता, Autocomplete (New) के किसी सुझाव को चुनता है, तब Place Details (New) का अनुरोध या पते की पुष्टि करने का अनुरोध किया जाता है. अगर कोई सेशन छोड़ दिया जाता है, तो इसका मतलब है कि जगह की जानकारी (नई) का कोई अनुरोध या पते की पुष्टि करने का अनुरोध नहीं किया गया है. ऐसे में, अपने-आप भरने की सुविधा (नई) के अनुरोधों के लिए, इस तरह शुल्क लिया जाता है जैसे कोई सेशन टोकन नहीं दिया गया हो.

जब कोई उपयोगकर्ता किसी जगह को चुन लेता है, तो आपको नए सेशन टोकन का इस्तेमाल करके नया सेशन शुरू करना होगा. इसका मतलब है कि जगह की ज़्यादा जानकारी (नया) पाने का अनुरोध या पते की पुष्टि करने का अनुरोध किया गया है.

सेशन टोकन का इस्तेमाल सिर्फ़ एक सेशन के लिए किया जा सकता है. इसका इस्तेमाल एक से ज़्यादा सेशन के लिए नहीं किया जा सकता. अगर किसी सेशन टोकन का दोबारा इस्तेमाल किया जाता है, तो सेशन को अमान्य माना जाता है. साथ ही, अनुरोधों के लिए शुल्क तब लिया जाता है, जब कोई सेशन टोकन नहीं दिया गया हो.

Places API के लिए, एसकेयू की जानकारी और कीमत

यहां दी गई टेबल में, Places API के लिए एसकेयू की जानकारी और कीमत दी गई है.

कैटगरीPlaces API (नया प्रॉडक्ट) के एसकेयू की जानकारीएसकेयू की कीमत
Essentials एसकेयू: ऑटोकंप्लीट के अनुरोध कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Essentials SKU: ऑटोकंप्लीट सेशन का इस्तेमाल कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Essentials SKU: Place Details Essentials (IDs Only) कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Essentials एसकेयू: जगह की जानकारी दिखाने के बुनियादी दिशा-निर्देश कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Essentials SKU: Text Search Essentials (IDs Only) कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro SKU: Nearby Search Pro कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro SKU: Place Details Pro कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro SKU: Text Search Pro कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise एसकेयू: Nearby Search Enterprise कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise एसकेयू: Nearby Search Enterprise Plus कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise SKU: Place Details Enterprise कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise SKU: Place Details Enterprise + Atmosphere कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise SKU: Text Search Enterprise कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise एसकेयू: Text Search Enterprise + Atmosphere कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise SKU: जगह की जानकारी देने वाली फ़ोटो कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
कैटगरीPlaces API (लेगसी) के एसकेयू की जानकारीएसकेयू की कीमत
Essentials SKU: ऑटोकंप्लीट - हर अनुरोध से जुड़ा एट्रिब्यूशन मॉडल कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Essentials एसकेयू: ऑटोकंप्लीट (जगह की जानकारी के साथ शामिल) - हर सेशन के लिए कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Essentials

एसकेयू: बुनियादी डेटा

अतिरिक्त शुल्क:

कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Essentials SKU: Find Place - ID only कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Essentials SKU: Place Details Essentials - ID Refresh कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Essentials SKU: क्वेरी अपने-आप पूरी होने की सुविधा - हर अनुरोध के लिए कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro SKU: जगह की जानकारी के बिना ऑटोकंप्लीट - हर सेशन के लिए कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro

एसकेयू: जगह ढूंढें

अतिरिक्त शुल्क:

कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro

SKU: Places - Nearby Search

अतिरिक्त शुल्क:

कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro

SKU: Places - Text Search

अतिरिक्त शुल्क:

कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro

एसकेयू: जगहों की जानकारी

अतिरिक्त शुल्क:

कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise

एसकेयू: वायुमंडल का डेटा

अतिरिक्त शुल्क:

कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise

एसकेयू: संपर्क डेटा

अतिरिक्त शुल्क:

कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Enterprise SKU: Place Photos कीमत की मुख्य सूची
भारत के लिए कीमत की सूची

इस्तेमाल करने की सीमा

अपने कोटे और इस्तेमाल की सीमाओं की समीक्षा करने और उन्हें मैनेज करने के लिए, कोटे और कोटा से जुड़ी सूचनाएं देखें.

  • Places API (नया प्रॉडक्ट): हर मिनट के लिए तय की गई दर की सीमा, हर प्रोजेक्ट के लिए हर एपीआई तरीके के हिसाब से तय की जाती है. इसका मतलब है कि हर एपीआई तरीके का कोटा अलग होता है.

  • Places API (लेगसी): हर मिनट के लिए दर की सीमा का हिसाब, एक ही प्रोजेक्ट के क्रेडेंशियल का इस्तेमाल करने वाले सभी ऐप्लिकेशन के लिए, क्लाइंट-साइड और सर्वर-साइड के अनुरोधों के योग के तौर पर लगाया जाता है.

कोटा में बदलाव करना

कोटा की सीमाओं से यह तय होता है कि किसी तय समयसीमा में, किसी खास एपीआई या सेवा के लिए ज़्यादा से ज़्यादा कितने अनुरोध किए जा सकते हैं. जब आपके प्रोजेक्ट में अनुरोधों की संख्या, कोटा की सीमा तक पहुंच जाती है, तो आपकी सेवा अनुरोधों का जवाब देना बंद कर देती है.

अपने एपीआई के लिए कोटा वैल्यू में बदलाव करने के लिए, यह तरीका अपनाएं:

  1. Cloud Console में, Google Maps Platform > कोटा पर जाएं.
  2. वह एपीआई चुनें जिसके लिए आपको कोटा में बदलाव करना है.
  3. वह कोटा वैल्यू ढूंढें जिसे आपको बदलना है. इसके बाद, चेकबॉक्स का इस्तेमाल करके उसे चुनें.
  4. बदलाव करें पर क्लिक करें. इसके बाद, नई कोटा वैल्यू डालें और अनुरोध सबमिट करें पर क्लिक करें.

कोटा बढ़ाने के अनुरोध देखना

कोटा बढ़ाने के सभी अनुरोध देखने के लिए, यह तरीका अपनाएं. इसमें पिछले और स्वीकार किए जाने बाकी अनुरोध भी शामिल हैं:

  1. Cloud Console में, Google Maps Platform > कोटा पर जाएं.
  2. वह एपीआई चुनें जिसके लिए आपको कोटा बढ़ाने का अनुरोध देखना है.
  3. अनुरोधों की संख्या बढ़ाएं पर क्लिक करें.

इस्तेमाल की शर्तों से जुड़ी पाबंदियां

इस्तेमाल की शर्तों के बारे में जानने के लिए, Places API की नीतियां और Google Maps Platform की सेवा की शर्तों का लाइसेंस से जुड़ी पाबंदियां सेक्शन देखें.