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 के लिए एसकेयू की जानकारी और कीमत

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

कैटगरी	Places API (नया) के एसकेयू की जानकारी	एसकेयू की कीमत
Essentials	एसकेयू: Autocomplete Requests	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
Essentials	एसकेयू: ऑटोकंप्लीट सेशन का इस्तेमाल	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
Essentials	एसकेयू: Place Details Essentials (सिर्फ़ आईडी)	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
Essentials	एसकेयू: Place Details Essentials	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
Essentials	SKU: Text Search Essentials (IDs Only)	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
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	SKU: Autocomplete - Per Request	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
Essentials	एसकेयू: ऑटोकंप्लीट (जगह की जानकारी के साथ शामिल है) - हर सेशन के लिए	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
Essentials	एसकेयू: बेसिक डेटा अतिरिक्त शुल्क: एसकेयू: Places Details SKU: Find Place SKU: Places - आस-पास की जगहों की जानकारी एसकेयू: Places - टेक्स्ट से खोजें	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
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	एसकेयू: वायुमंडल से जुड़ा डेटा अतिरिक्त शुल्क: एसकेयू: Places Details SKU: Find Place SKU: Places - आस-पास की जगहों की जानकारी एसकेयू: Places - टेक्स्ट से खोजें	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
Enterprise	एसकेयू: संपर्क डेटा अतिरिक्त शुल्क: एसकेयू: Places Details SKU: Find Place SKU: Places - आस-पास की जगहों की जानकारी एसकेयू: Places - टेक्स्ट से खोजें	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची
Enterprise	SKU: Place Photos	दुनिया भर के लिए कीमत की सूची भारत के लिए कीमत की सूची

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

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

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