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

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

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

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

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

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

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

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

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

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: Autocomplete without Place Details - Per Session कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro एसकेयू: जगह ढूंढें कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro SKU: Places - Nearby Search कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro SKU: Places - Text Search कीमत की मुख्य सूची
भारत के लिए कीमत की सूची
Pro SKU: Place Details 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 की सेवा की शर्तों का लाइसेंस से जुड़ी पाबंदियां सेक्शन देखें.