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

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

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

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

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

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

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

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

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

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

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

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

SKU: बुनियादी डेटा

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

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

SKU: Find Place

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

ग्लोबल प्राइसिंग लिस्ट
भारत के लिए प्राइसिंग लिस्ट
Pro

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

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

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

SKU: Places - Text Search

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

ग्लोबल प्राइसिंग लिस्ट
भारत के लिए प्राइसिंग लिस्ट
Pro

एसकेयू: Places Details

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

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

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

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

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

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

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

ग्लोबल प्राइसिंग लिस्ट
भारत के लिए प्राइसिंग लिस्ट
Enterprise SKU: Place Photos ग्लोबल प्राइसिंग लिस्ट
भारत के लिए प्राइसिंग लिस्ट

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

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

  • Places API (नया वर्शन): हर मिनट के लिए अनुरोध संख्या सीमित करना, हर प्रोजेक्ट के लिए एपीआई के हर तरीके के हिसाब से तय होती है. दूसरे शब्दों में कहें, तो हर एपीआई तरीके का कोटा अलग होता है.

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

Places API के लिए कम लागत वाली रणनीतियां

इस सेक्शन में, Places API के इस्तेमाल को ऑप्टिमाइज़ करने और इससे जुड़ी लागत को कम करने के तरीके बताए गए हैं.

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

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

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

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

जगह की जानकारी (नई) के साथ सेशन के हिसाब से कीमत तय करने की सुविधा का इस्तेमाल करना

अगर आपके ऐप्लिकेशन में हर महीने 1,00,001 से 5,00,000 या इससे ज़्यादा कॉल आते हैं या अगर उपयोगकर्ता हर सेशन में 12 से ज़्यादा ऑटोकंप्लीट अनुरोध करते हैं, तो Google ऑटोकंप्लीट (नया) के साथ सेशन का इस्तेमाल करने का सुझाव देता है. सेशन की मदद से, कीमत तय करना आसान हो जाता है. साथ ही, ऑटोकंप्लीट (नया) के साथ इस्तेमाल करने के लिए, एक जैसा प्राइसिंग मॉडल मिलता है.

ज़्यादा जानकारी के लिए, ऑटोकंप्लीट (नया) और सेशन की कीमत देखें.

कोटा अडजस्ट करना

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

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

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

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

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

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

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

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