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

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

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

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

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

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

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

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

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

Places API के लिए SKU की जानकारी और कीमत

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

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

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

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

दुनिया भर के लिए कीमत की सूची
भारत के लिए कीमत की सूची
Essentials एसकेयू: Find Place - ID only दुनिया भर के लिए कीमत की सूची
भारत के लिए कीमत की सूची
Essentials एसकेयू: Place Details Essentials - आईडी रीफ़्रेश दुनिया भर के लिए कीमत की सूची
भारत के लिए कीमत की सूची
Essentials एसकेयू: क्वेरी ऑटोकंप्लीट - हर अनुरोध के लिए दुनिया भर के लिए कीमत की सूची
भारत के लिए कीमत की सूची
Pro एसकेयू: Autocomplete without Place Details - Per Session दुनिया भर के लिए कीमत की सूची
भारत के लिए कीमत की सूची
Pro

SKU: Find Place

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

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

SKU: Places - आस-पास की जगहों की जानकारी

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

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

एसकेयू: Places - टेक्स्ट से खोजें

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

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

एसकेयू: Places Details

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

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

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

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

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

SKU: संपर्क डेटा

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

दुनिया भर के लिए कीमत की सूची
भारत के लिए कीमत की सूची
Enterprise एसकेयू: जगह की फ़ोटो दुनिया भर के लिए कीमत की सूची
भारत के लिए कीमत की सूची

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

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

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

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

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

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

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

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

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

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

Place Details (New) के साथ सेशन के हिसाब से कीमत तय करने की सुविधा का इस्तेमाल करना

अगर आपके ऐप्लिकेशन में हर महीने 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 की सेवा की शर्तों का लाइसेंस से जुड़ी पाबंदियों वाला सेक्शन देखें.