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

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

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

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

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

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

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

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

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

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

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

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

SKU: Find Place

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

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

SKU: Places - Nearby Search

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

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

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

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

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

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

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

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