Google Maps Platform की रिपोर्टिंग

Google Maps Platform में रिपोर्टिंग की सुविधा, Google Cloud console में एपीआई के बुनियादी इस्तेमाल, कोटा, और बिलिंग की जानकारी की पहले से तय विज़ुअल रिपोर्ट का सेट उपलब्ध कराती है. इन रिपोर्ट का इस्तेमाल करके, यह पता लगाया जा सकता है कि आपने कितने एपीआई कॉल किए हैं. साथ ही, यह भी पता लगाया जा सकता है कि एपीआई के इस्तेमाल के कोटे को पूरा होने में कितना समय बाकी है. इसके अलावा, समय के साथ बिलिंग के इस्तेमाल पर नज़र रखी जा सकती है.

रिपोर्ट के टाइप में ये शामिल हैं:

• इस्तेमाल की रिपोर्ट: इससे पता चलता है कि आपका प्रोजेक्ट, Google Maps Platform API के लिए कितने अनुरोध करता है. इसके लिए, आपके प्रोजेक्ट से जुड़े क्रेडेंशियल का इस्तेमाल किया जाता है.
• कोटा रिपोर्ट: यह रिपोर्ट, कोटा के इस्तेमाल को ग्राफ़ में दिखाती है. इन ग्राफ़ को हर मिनट किए गए अनुरोधों के हिसाब से ग्रुप किया जा सकता है. चुने गए एपीआई के लिए मौजूदा कोटा सीमाएं, कोटा के इस्तेमाल के ग्राफ़ के नीचे दी गई टेबल में दिखाई जाती हैं.
• बिलिंग रिपोर्ट: इस रिपोर्ट में, समय के साथ लागत को स्टैक किए गए लाइन चार्ट के तौर पर दिखाया जाता है. मौजूदा महीने के कोटा के इस्तेमाल की जानकारी देखें. इसमें, इस्तेमाल के हिसाब से लागू किए गए क्रेडिट के साथ-साथ, मौजूदा महीने की कुल अनुमानित लागत भी शामिल होती है.

जवाब की स्थितियों और रिस्पॉन्स कोड की पूरी सूची देखने के लिए जो यह तय करते हैं कि कोई अनुरोध इस्तेमाल, कोटा, और बिलिंग रिपोर्ट में दिखता है या नहीं, जवाब की स्थिति और रिपोर्ट देखें.

Cloud Console का इस्तेमाल करके, Google Maps Platform के इस्तेमाल, कोटा, और बिलिंग की रिपोर्ट देखें.

इस्तेमाल की रिपोर्ट

इस्तेमाल, इस बात पर निर्भर करता है कि आपका प्रोजेक्ट, Google Maps Platform API को कितने अनुरोध करता है. इसके लिए, आपके प्रोजेक्ट से जुड़े क्रेडेंशियल का इस्तेमाल किया जाता है. अनुरोधों में ये शामिल हैं: पूरे हो चुके अनुरोध, सर्वर की गड़बड़ियों की वजह से पूरे न हो पाए अनुरोध, और क्लाइंट की गड़बड़ियों की वजह से पूरे न हो पाए अनुरोध. क्रेडेंशियल में एपीआई कुंजियां और क्लाइंट आईडी शामिल होते हैं. ये आईडी, प्रीमियम प्लान और माइग्रेट किए गए प्रीमियम प्लान प्रोजेक्ट के लिए होते हैं. ज़्यादा जानकारी के लिए, प्रीमियम प्लान की खास जानकारी और क्लाइंट आईडी इस्तेमाल करने के बारे में जानकारी देखें.

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

• सभी एपीआई: सभी एपीआई के लिए, इस्तेमाल से जुड़ी मेट्रिक को इन तरीकों से फ़िल्टर और ग्रुप किया जा सकता है:

  • समयावधि और एपीआई के हिसाब से फ़िल्टर करें.
  • जवाब के कोड, एपीआई, और क्रेडेंशियल के हिसाब से ग्रुप किया गया ट्रैफ़िक, गड़बड़ी, और इंतज़ार का समय देखें.

• कोई खास एपीआई: इन तरीकों से, किसी खास एपीआई के लिए इस्तेमाल से जुड़ी मेट्रिक को फ़िल्टर और ग्रुप किया जा सकता है:

  • समयावधि, एपीआई वर्शन, क्रेडेंशियल, और तरीकों के हिसाब से फ़िल्टर करें.
  • जवाब के कोड, एपीआई के तरीके, वर्शन, और क्रेडेंशियल के हिसाब से, ट्रैफ़िक, गड़बड़ी, और इंतज़ार का समय देखें.

एपीआई और सेवाओं के डैशबोर्ड पेज पर

एपीआई और सेवाओं का डैशबोर्ड, आपके प्रोजेक्ट के लिए चालू किए गए सभी एपीआई के इस्तेमाल से जुड़ी मेट्रिक की खास जानकारी देता है. इनमें Google Maps Platform के एपीआई के साथ-साथ अन्य एपीआई और सेवाएं भी शामिल हैं.

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

• ट्रैफ़िक ग्राफ़ में, हर एपीआई के लिए एक मिनट में की गई क्वेरी (क्यूपीएम) के हिसाब से इस्तेमाल दिखाया जाता है.

• गड़बड़ियां ग्राफ़ में, हर एपीआई के लिए गड़बड़ियों की वजह से पूरे न हो पाने वाले अनुरोधों का प्रतिशत दिखता है.

• लेटेंसी ग्राफ़ में, हर एपीआई के लिए अनुरोधों की मीडियन लेटेंसी दिखाई जाती है.

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

एपीआई और सेवाओं के डैशबोर्ड पेज को ऐक्सेस करने के लिए:

1. Cloud Console में प्रोजेक्ट चुनने वाला पेज खोलें:

   प्रोजेक्ट चुनने वाला पेज

2. अपना प्रोजेक्ट चुनें. आपको 'एपीआई और सेवाएं' डैशबोर्ड पेज दिखेगा.
   
   अगर पेज नहीं दिखता है, तो मेन्यू बटन चुनें और फिर एपीआई और सेवाएं चुनें.

ज़्यादा जानकारी के लिए, एपीआई के इस्तेमाल को मॉनिटर करना लेख पढ़ें.

Google Maps का खास जानकारी देने वाला पेज

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

ध्यान दें: चालू किए गए किसी भी एपीआई का नाम चुनने पर, आपको उस एपीआई के लिए Google Maps के मेट्रिक पेज पर रीडायरेक्ट कर दिया जाता है.

Google Maps Platform की खास जानकारी देने वाले पेज को ऐक्सेस करने के लिए:

1. Cloud Console में Google Maps Platform पेज खोलें:

   Google Maps Platform पेज पर जाएं

2. बाईं ओर दिए गए मेन्यू में, खास जानकारी को चुनें.

Google Maps Platform के एपीआई और सेवाओं वाला पेज

Google Maps के एपीआई और सेवाएं पेज पर, टाइल का एक ग्रिड होता है. इसमें आपके प्रोजेक्ट के लिए उपलब्ध एपीआई, एसडीके, और अन्य सेवाएं दिखती हैं. हर टाइल में, चालू करें या बंद करें को चुनकर, उस सेवा को चालू या बंद किया जा सकता है. साथ ही, चालू किए गए एपीआई के लिए क्रेडेंशियल की जानकारी, मेट्रिक, और उपयोगकर्ता गाइड ऐक्सेस की जा सकती हैं. चालू या बंद की गई सेवाओं और सेवा की अन्य कैटगरी देखने के लिए, पेज फ़िल्टर का भी इस्तेमाल किया जा सकता है.

Google Maps Platform के एपीआई और सेवाओं वाले पेज को ऐक्सेस करने के लिए:

1. Cloud Console में Google Maps Platform पेज खोलें:

   Google Maps Platform के पेज पर जाएं

2. बाईं ओर मौजूद मेन्यू में, एपीआई और सेवाएं चुनें.

Google Maps की मेट्रिक वाला पेज

Google Maps के मेट्रिक पेज पर तीन ग्राफ़ दिखते हैं: ट्रैफ़िक, गड़बड़ियां, और मीडियन लेटेंसी. ग्राफ़ में इस्तेमाल किए गए डेटा को रिस्पॉन्स कोड क्लास, एपीआई, एपीआई तरीके, क्रेडेंशियल, प्लैटफ़ॉर्म, और डोमेन के हिसाब से ग्रुप किया जा सकता है.

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

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

ध्यान दें: एपीआई चुनें ड्रॉप-डाउन सूची से Google Maps Platform के सभी एपीआई चुनने पर, इसके हिसाब से ग्रुप बनाएं ड्रॉप-डाउन सूची में प्लैटफ़ॉर्म और डोमेन के विकल्प नहीं दिखते. साथ ही, प्लैटफ़ॉर्म और डोमेन फ़िल्टर भी उपलब्ध नहीं होते. बेहतर तरीके से विश्लेषण करने के लिए, Google Maps Platform के सभी एपीआई विकल्प का इस्तेमाल करें: इस्तेमाल किए गए एपीआई और तरीके ढूंढें. साथ ही, क्रेडेंशियल के हिसाब से गड़बड़ी की दर और इस्तेमाल की जानकारी देखें. किसी खास एपीआई के विश्लेषण के बारे में ज़्यादा जानकारी पाने के लिए, एपीआई चुनें ड्रॉप-डाउन सूची से कोई एपीआई चुनें. एपीआई चुनें ड्रॉप-डाउन सूची से कोई एपीआई चुनने पर, एपीआई के इस्तेमाल का ज़्यादा बारीकी से विश्लेषण किया जा सकता है. जैसे, प्लैटफ़ॉर्म और डोमेन के हिसाब से ग्रुप बनाना और फ़िल्टर करना.

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

Google Maps Platform API के मेट्रिक पेज को ऐक्सेस करने के लिए:

1. Cloud Console में Google Maps Platform पेज खोलें:

   Google Maps Platform के पेज पर जाएं

2. बाईं ओर दिए गए मेन्यू में, मेट्रिक चुनें.

क्रेडेंशियल की रिपोर्टिंग

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

क्रेडेंशियल का फ़ॉर्मैट	मतलब
कुंजी का नाम उदाहरण के लिए, "मोबाइल ऐप्लिकेशन की कुंजी"	एपीआई को लोड करने के लिए एपीआई पासकोड का इस्तेमाल किया गया था. इसके लिए, ?key=... का इस्तेमाल किया गया था: आपको Maps Platform Console में पासकोड और क्रेडेंशियल में जाकर, पासकोड के नाम मिल सकते हैं.
प्रोजेक्ट नंबर उदाहरण के लिए, "project_number:123456". यहां 123456 आपका प्रोजेक्ट नंबर है.	अगर आपको यह क्रेडेंशियल दिखता है, तो दो संभावनाएं हो सकती हैं: Maps Platform के क्लाइंट आईडी स्वीकार करने वाले एपीआई के लिए: एपीआई को लोड करने के लिए, Maps Platform के क्लाइंट आईडी का इस्तेमाल किया गया था. उदाहरण के लिए, &client=gme-_mycompany_ का इस्तेमाल करना. ये एपीआई, क्लाइंट आईडी स्वीकार करते हैं: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API (लेगसी), Distance Matrix API (लेगसी), Geocoding API, टाइम ज़ोन API. ज़्यादा जानकारी के लिए, Premium प्लान के क्लाइंट आईडी मैनेज करना लेख पढ़ें. OAuth स्वीकार करने वाले एपीआई के लिए: एपीआई को OAuth का इस्तेमाल करके लोड किया गया था. हालांकि, इसमें एपीआई पासकोड शामिल नहीं था.

ध्यान दें: ऐसे कोई Maps Platform API नहीं हैं जो Maps Platform के क्लाइंट आईडी और OAuth, दोनों के साथ काम करते हों. इसलिए, यह पता लगाया जा सकता है कि एपीआई को क्लाइंट आईडी या OAuth के साथ लोड किया गया था. इसके लिए, यह देखा जा सकता है कि किस एपीआई का इस्तेमाल किया गया था.

रिस्पॉन्स कोड के ग्राफ़

रिस्पॉन्स कोड के हिसाब से ट्रैफ़िक और रिस्पॉन्स कोड के हिसाब से गड़बड़ी ग्राफ़ में, एचटीटीपी रिस्पॉन्स कोड क्लास के हिसाब से इस्तेमाल को बांटा जाता है. इस टेबल में, Google Maps Platform API के रिस्पॉन्स स्टेटस और एचटीटीपी रिस्पॉन्स कोड क्लास के बीच मैपिंग दिखाई गई है:

Maps API का स्टेटस	एचटीटीपी रिस्पॉन्स कोड क्लास - इस्तेमाल की रिपोर्ट (2xx, 3xx, 4xx, 5xx)	नोट
ठीक है	2xx	सफल रिस्पॉन्स. यह एक ऐसा अनुरोध है जिसके लिए शुल्क लिया जाता है. इससे कोटा का इस्तेमाल होगा.
ठीक है	3xx	सफल रिस्पॉन्स. यह एक ऐसा अनुरोध है जिसके लिए शुल्क लिया जाता है. इससे कोटा का इस्तेमाल होगा. उदाहरण के लिए, Place Photo के अनुरोध के पूरा होने पर, रेफ़रंस के लिए इमेज पर 302 रीडायरेक्ट मिलता है.
DATA_NOT_AVAILABLE	4xx^(1)	जवाब में यह बताया गया है कि इनपुट की गई जगहों के लिए कोई डेटा उपलब्ध नहीं है. इस अनुरोध के लिए शुल्क लिया जाएगा और कोटा इस्तेमाल किया जाएगा.
ZERO_RESULTS	4xx^(1)	जवाब में कोई नतीजा नहीं मिला. इस अनुरोध के लिए शुल्क लिया जाएगा और कोटा इस्तेमाल किया जाएगा.
NOT_FOUND	4xx^(1)	Directions API (लेगसी) के लिए, इस मैसेज का मतलब है कि अनुरोध के ऑरिजिन, डेस्टिनेशन या वेपॉइंट में बताई गई कम से कम एक जगह को जियोकोड नहीं किया जा सका. Places API के लिए, इस मैसेज का मतलब है कि रेफ़र की गई जगह (place_id) Places डेटाबेस में नहीं मिली. यह बिल किया जाने वाला अनुरोध है और इससे कोटा का इस्तेमाल होगा.
INVALID_REQUEST (अमान्य पैरामीटर वैल्यू), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED, और अन्य.	4xx	पैरामीटर की अमान्य वैल्यू की वजह से गड़बड़ी हुई. ज़्यादा जानकारी के लिए, एपीआई रिस्पॉन्स देखें. यह एक ऐसा अनुरोध है जिसके लिए शुल्क लिया जाता है. इससे कोटा का इस्तेमाल होगा.
REQUEST_DENIED	4xx	क्लाइंट की गड़बड़ी, पुष्टि करने में हुई गड़बड़ी, ऐक्सेस करने में हुई गड़बड़ी वगैरह की वजह से होती है. ज़्यादा जानकारी के लिए, एपीआई से मिली जानकारी देखें.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded	4xx	क्लाइंट की गड़बड़ी. यह गड़बड़ी, तय समयावधि में बहुत ज़्यादा अनुरोध करने की वजह से हुई है. अनुरोध को कुछ समय बाद फिर से भेजें. ज़्यादा जानकारी के लिए, एपीआई से मिली जानकारी देखें.
INVALID_REQUEST (अमान्य या छूटा हुआ पैरामीटर, अनुरोध पार्स करने या पुष्टि करने से जुड़ी गड़बड़ी)	4xx	अमान्य अनुरोध की वजह से क्लाइंट की गड़बड़ी. ज़्यादा जानकारी के लिए, एपीआई से मिली जानकारी देखें.
NOT_FOUND (404)	4xx	For the Directions API (लेगसी), इस मैसेज से पता चलता है कि अनुरोध के ऑरिजिन, डेस्टिनेशन या वेपॉइंट में बताई गई कम से कम एक जगह को जियोकोड नहीं किया जा सका. Geolocation API के लिए, इस मैसेज का मतलब है कि जगह का अनुमान लगाने के लिए, इनपुट काफ़ी नहीं थे. Roads API के लिए, इस मैसेज का मतलब है कि इनपुट को सड़कों पर ठीक से स्नैप नहीं किया जा सका. यह एक बिल किया जा सकने वाला अनुरोध है. इसके लिए, कोटे का इस्तेमाल किया जाएगा.
UNKNOWN_ERROR	5xx	सर्वर की गड़बड़ी से पता चलता है कि अनुरोध को पूरा नहीं किया जा सकता: सर्वर में गड़बड़ी, सेवा ओवरलोड है, उपलब्ध नहीं है, समय खत्म हो गया है, और अन्य.

¹ गड़बड़ी के कोड की रिपोर्टिंग को बेहतर बनाने के लिए, Google Maps Platform API माइग्रेट हो रहे हैं: 1) Maps API के स्टेटस के लिए, एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx पर: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status, 2) Maps API के स्टेटस के लिए, एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx पर: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) Maps API के स्टेटस के लिए, एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 5xx पर: UNKNOWN_ERROR. ट्रांज़िशन की अवधि के दौरान, दोनों रिस्पॉन्स कोड देखे जा सकते हैं. Maps API से मिले जवाबों में मौजूद रिस्पॉन्स कोड नहीं बदल रहे हैं. पुष्टि करें कि Google Maps Platform मेट्रिक में 4xx और/या 5xx में हुई बढ़ोतरी, इस माइग्रेशन से जुड़ी है. इसके लिए, यह देखें कि मेट्रिक एक्सप्लोरर में कौनसे रिस्पॉन्स कोड में बढ़ोतरी हुई है. ज़्यादा जानें पर क्लिक करके, Google Maps Platform के लिए Google Cloud Monitoring इस्तेमाल करने के बारे में जानें.

स्टेटस कोड और गड़बड़ी के मैसेज के बारे में ज़्यादा जानने के लिए, उस एपीआई के रिस्पॉन्स से जुड़ा दस्तावेज़ देखें जिसमें आपकी दिलचस्पी है. उदाहरण के लिए, जियोकोडिंग के रिस्पॉन्स या रास्ता बताने वाले रिस्पॉन्स.

Google Maps Platform के इस्तेमाल का एट्रिब्यूशन पैरामीटर

Google Maps Platform, कई तरह के सैंपल कोड उपलब्ध कराता है. इससे आपको तेज़ी से काम शुरू करने में मदद मिलती है. उदाहरण के लिए, Cloud Console में क्विक बिल्डर का इस्तेमाल किया जा सकता है. साथ ही, इंडस्ट्री के लिए उपलब्ध समाधानों को लागू करने के बारे में जानकारी देने वाली गाइड का पालन किया जा सकता है. इसके अलावा, कोड लैब से भी सीखा जा सकता है.

Google, एपीआई कॉल में internal_usage_attribution_ids पैरामीटर शामिल करता है. इससे उसे यह समझने में मदद मिलती है कि हमारे समाधानों का इस्तेमाल कैसे किया जा रहा है और उन्हें बेहतर कैसे बनाया जा सकता है. साथ ही, इससे उसे सैंपल कोड के इस्तेमाल के बारे में जानकारी इकट्ठा करने में मदद मिलती है:

• internal_usage_attribution_ids पैरामीटर, समाधान के सैंपल कोड में डिफ़ॉल्ट रूप से शामिल हो सकता है.
• यह पैरामीटर, समाधान को अपनाने से जुड़ी Analytics का डेटा Google को भेजता है, ताकि आने वाले समय में समाधान की क्वालिटी को बेहतर बनाया जा सके.
• सैंपल कोड से internal_usage_attribution_ids पैरामीटर और उसकी वैल्यू को मिटाकर, ऑप्ट आउट किया जा सकता है.
• इस पैरामीटर को बनाए रखने की कोई ज़रूरत नहीं है. पैरामीटर हटाने से परफ़ॉर्मेंस पर कोई असर नहीं पड़ता.
• इस पैरामीटर का इस्तेमाल सिर्फ़ सैंपल कोड के इस्तेमाल की रिपोर्टिंग के लिए किया जाता है.
• यह पैरामीटर, एपीआई के हिसाब से तैयार की गई किसी भी Analytics और रिपोर्टिंग से अलग होता है. इसका मतलब है कि समाधान के सैंपल कोड से पैरामीटर हटाने पर, Maps JavaScript API की इंटरनल रिपोर्टिंग बंद नहीं होती.

ध्यान दें: solution_channel पैरामीटर अब भी मान्य है और इसे मौजूदा सेटअप में देखा जा सकता है. हालांकि, अब इसका इस्तेमाल करने का सुझाव नहीं दिया जाता. इसके बजाय, internal_usage_attribution_ids का इस्तेमाल करें.

कोटा रिपोर्ट

कोटे से यह तय होता है कि आपका प्रोजेक्ट, Google Maps Platform API को कितने अनुरोध भेज सकता है. अनुरोधों को तीन तरीकों से सीमित किया जा सकता है: हर दिन, हर मिनट, और हर उपयोगकर्ता के लिए हर मिनट. सिर्फ़ उन अनुरोधों को कोटा में गिना जाता है जो पूरे हो चुके हैं और जिनकी वजह से सर्वर की गड़बड़ी हुई है. पुष्टि न होने पर, अनुरोधों को कोटे में नहीं गिना जाता.

कोटा के इस्तेमाल की जानकारी, Cloud Console में कोटा पेज पर मौजूद ग्राफ़ में दिखती है. इसे हर मिनट के अनुरोधों के हिसाब से ग्रुप किया जा सकता है. चुने गए एपीआई के लिए, मौजूदा कोटा सीमाएं, कोटा इस्तेमाल के ग्राफ़ के नीचे दी गई टेबल में दिखाई जाती हैं.

GMP API के किसी भी प्रॉडक्ट के लिए, हर मिनट के कोटा की वैल्यू पाने के लिए, इस कैलकुलेटर का इस्तेमाल करें.

Google Maps का कोटा पेज

Google Maps कोटा पेज पर, आपके चुने गए एपीआई के लिए कोटा सीमाएं और कोटा इस्तेमाल करने की जानकारी दिखती है.

Google Cloud Console पर मौजूद कोटा इस्तेमाल करने वाले चार्ट में, आपके एपीआई पासकोड और क्लाइंट आईडी के लिए कुल ट्रैफ़िक दिखता है. क्लाइंट आईडी का ट्रैफ़िक, Cloud Console पर मौजूद मेट्रिक चार्ट में भी उपलब्ध होता है.

इस पेज पर सिर्फ़ वे अनुरोध दिखते हैं जो कोटे का इस्तेमाल करते हैं: पूरे हो चुके अनुरोध (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) और वे अनुरोध जिनकी वजह से सर्वर की गड़बड़ियां होती हैं (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (अमान्य पैरामीटर वैल्यू), और UNKNOWN_ERROR).

क्लाइंट की वजह से होने वाली गड़बड़ियों वाले अनुरोधों से कोटा इस्तेमाल नहीं होता. साथ ही, ये अनुरोध नहीं दिखते. जैसे, पुष्टि करने, अनुमति देने, और अमान्य आर्ग्युमेंट की गड़बड़ियों (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (अमान्य पैरामीटर, अनुरोध पार्स करने की गड़बड़ी)) वाले अनुरोध.

कोटा यूनिट, Google Maps Platform के ज़्यादातर एपीआई के लिए एक अनुरोध है. जैसे, Maps Static API, Street View Static API, Geocoding API, Directions API (लेगसी), Places API, Time Zone API, Geolocation API, और Elevation API. हालांकि, कुछ अपवाद भी हैं:

• Distance Matrix API (लेगसी) के लिए, कोटा यूनिट एक एलिमेंट होती है. यह ओरिजिन-डेस्टिनेशन पेयर होता है.
• Maps JavaScript API के लिए, कोटा यूनिट एक मैप लोड है.
• Android के लिए Maps SDK और iOS के लिए Maps SDK के लिए, कोटा यूनिट, Street View का अनुरोध या पैनोरमा लोड होता है. मैप लोड करने की सुविधा बिना किसी शुल्क के उपलब्ध है. साथ ही, इससे कोटा का इस्तेमाल नहीं होता.

Google Maps Platform के कोटा पेज को ऐक्सेस करने के लिए:

1. Cloud Console में Google Maps Platform पेज खोलें:

   Google Maps Platform के पेज पर जाएं

2. बाईं ओर दिए गए मेन्यू में, कोटा को चुनें.
3. एपीआई की ड्रॉप-डाउन सूची से कोई एपीआई चुनें.

कोटा इकाईयाँ

इस टेबल में, Google Maps Platform API के लिए कोटा यूनिट दिखाई गई है.

Google Maps Platform API	कोटा यूनिट
Maps
Android के लिए Maps SDK टूल	एक पैनोरामा
iOS के लिए Maps SDK टूल	एक पैनोरमा
Map Tiles API	1 अनुरोध
Maps Aerial View API	1 अनुरोध
Maps स्टैटिक एपीआई	1 अनुरोध
Maps JavaScript एपीआई	1 मैप लोड
Street View Static API	1 अनुरोध
Maps एंबेड एपीआई	1 मैप लोड
रूट
Routes API (Compute Routes)	1 अनुरोध
Routes API (Compute Route Matrix)	एक एलिमेंट (शुरुआती जगह और मंज़िल का जोड़ा)
Directions API (लेगसी)	एक अनुरोध
Distance Matrix API (लेगसी)	एक एलिमेंट (मूल जगह और मंज़िल का जोड़ा)
रास्तों की जानकारी देने से जुड़ा एपीआई	एक अनुरोध
Route Optimization API	1 अनुरोध
Android के लिए नेविगेशन एसडीके टूल	एक डेस्टिनेशन
iOS के लिए नेविगेशन एसडीके टूल	1 डेस्टिनेशन
जगहें
Places API	1 अनुरोध
Places Aggregate API	1 अनुरोध
Address Validation API	एक अनुरोध
जियोकोडिंग एपीआई	एक अनुरोध
जियोलोकेशन एपीआई	एक अनुरोध
समय क्षेत्र एपीआई	1 अनुरोध
Maps Grounding Lite	1 अनुरोध
परिवेश
Air Quality API (CurrentConditions और HeatmapTile)	1 अनुरोध
Air Quality API (इतिहास)	1 पेज
Pollen API	एक अनुरोध
Solar API	एक अनुरोध
Weather API	एक अनुरोध

बिलिंग रिपोर्ट

अपनी बिलिंग रिपोर्ट देखना

Google Maps Platform के प्रॉडक्ट के इस्तेमाल से जुड़ी बिलिंग रिपोर्ट, Google Cloud Console में उपलब्ध होती हैं. ज़्यादा जानकारी के लिए, बिलिंग लेख पढ़ें.

बिलिंग रिपोर्ट ऐक्सेस करने के लिए:

1. Cloud Console में प्रोजेक्ट चुनने वाला पेज खोलें:

   प्रोजेक्ट चुनने वाला पेज

2. कोई प्रोजेक्ट चुनें.
3. मेन्यू बटन को चुनें. इसके बाद, बिलिंग को चुनें.
4. अगर आपके पास एक से ज़्यादा बिलिंग खाते हैं, तो लिंक किए गए बिलिंग खाते के होम पेज को खोलने के लिए, लिंक किए गए बिलिंग खाते पर जाएं को चुनें.
5. लिंक किए गए बिलिंग खाते के लिए, बिलिंग रिपोर्ट पेज खोलने के लिए, बाईं ओर मौजूद मेन्यू में जाकर रिपोर्ट को चुनें.

बिलिंग रिपोर्ट चार्ट को पढ़ने का तरीका

बिलिंग रिपोर्ट में, समय के साथ खर्च को स्टैक किए गए लाइन चार्ट के तौर पर दिखाया जाता है. डिफ़ॉल्ट व्यू में, मौजूदा महीने के लिए हर दिन के इस्तेमाल के हिसाब से लागत दिखती है. यह लागत, प्रोजेक्ट के हिसाब से ग्रुप की जाती है. इसमें सभी प्रॉडक्ट शामिल होते हैं. साथ ही, इसमें इस्तेमाल के हिसाब से लागू किए गए क्रेडिट और मौजूदा महीने के लिए अनुमानित कुल लागत भी शामिल होती है. चार्ट में मौजूद हर लाइन (और खास जानकारी वाली टेबल में मौजूद हर लाइन) किसी प्रोजेक्ट से मेल खाती है. इन्हें लागत के हिसाब से सबसे ज़्यादा से सबसे कम के क्रम में रखा जाता है. बिलिंग रिपोर्ट चार्ट को समझने के बारे में ज़्यादा जानें.

इमेज 1: बिलिंग रिपोर्ट में, डिफ़ॉल्ट प्रीसेट व्यू का इस्तेमाल करके चार्ट और टेबल को दिखाया गया है.

सलाह: हर SKU के इस्तेमाल और लागत का विश्लेषण करना

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

दूसरी इमेज: बिलिंग टेबल में, एसकेयू के हिसाब से इस्तेमाल और लागत के लाइन आइटम दिखाए गए हैं.

तीसरी इमेज: बिलिंग रिपोर्ट के फ़िल्टर.

रिपोर्ट व्यू को बदलकर, एसकेयू के हिसाब से लाइन आइटम दिखाने के लिए:

1. चार्ट के दाईं ओर मौजूद पैनल में, इसके हिसाब से ग्रुप बनाएं फ़िल्टर को बड़ा करें.
2. SKU चुनें.

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

प्रॉडक्ट के साथ-साथ, इस्तेमाल के सोर्स को कैटगरी में बांटने के लिए, बिलिंग की रिपोर्ट को यहां दी गई किसी वैल्यू के हिसाब से ग्रुप करें. Google Maps Platform API से जुड़े तीन कुकी नाम ये हैं: goog-maps-api-key-suffix (एपीआई पासकोड के आखिरी चार वर्ण), goog-maps-platform-type (प्लैटफ़ॉर्म: Android, iOS, JavaScript या webservice), और goog-maps-channel (एपीआई क्वेरी से मिली, संख्या वाली चैनल वैल्यू का सेट). फ़िल्टर करने और ग्रुप बनाने के बारे में ज़्यादा जानकारी.

चार्ट व्यू को बदला जा सकता है, ताकि इस्तेमाल के हिसाब से मिलने वाले क्रेडिट को शामिल न किया जाए. इसके लिए, दाईं ओर मौजूद पैनल में लागत में क्रेडिट शामिल करें चेकबॉक्स से सही का निशान हटाएं.

इस्तेमाल पर नज़र रखना और उसे सीमित करना

बजट प्लान करने और लागतों को कंट्रोल करने के लिए, ये काम किए जा सकते हैं:

• बजट तय करें

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

• एपीआई के लिए रोज़ाना की सीमा तय करना

  usage, ताकि बिल किए जाने वाले एपीआई के इस्तेमाल की लागत को मैनेज किया जा सके. हर दिन के अनुरोधों पर कैप सेट करके, खर्च को सीमित किया जा सकता है. आपको कितना खर्च करना है, इसके आधार पर रोज़ का कैप तय करने के लिए, किसी समीकरण का इस्तेमाल करें. उदाहरण के लिए: (महीने का खर्च / हर एसकेयू की कीमत) / 30 = हर दिन के अनुरोधों की सीमा (एक एपीआई के लिए).

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

हर चैनल के हिसाब से इस्तेमाल को ट्रैक करना

संख्या वाले चैनलों का इस्तेमाल करके, अपने इस्तेमाल को ट्रैक करने के लिए, आपको अपने एपीआई अनुरोधों में 'channel' पैरामीटर जोड़ना होगा. चैनल की वैल्यू के तौर पर, सिर्फ़ 0 से 999 तक की संख्याएं इस्तेमाल की जा सकती हैं. यहां कुछ उदाहरण दिए गए हैं:

• Geocoding Web Service API

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• Maps JavaScript एपीआई

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

बिलिंग रिपोर्ट में जाकर, चैनल के इस्तेमाल पर नज़र रखें. चैनल के इस्तेमाल की जानकारी, लेबल में goog-maps-channel कुंजी के तौर पर मौजूद होती है.

ध्यान दें: चैनल का डेटा, Android के लिए Maps SDK, iOS के लिए Maps SDK, Places API (नया), Android के लिए Places SDK, iOS के लिए Places SDK, Android के लिए Navigation SDK, iOS के लिए Navigation SDK, Places Aggregate API, Address Validation API, Aerial View API, Air Quality API, Map Tiles API, Maps Datasets API, Roads API, Routes API, Pollen API, Solar API, Route Optimization API, और Weather API के लिए उपलब्ध नहीं है.

चौथी इमेज: एसकेयू और चैनलों के हिसाब से फ़िल्टर करना

एसकेयू और चैनल के हिसाब से बिलिंग रिपोर्ट को फ़िल्टर करने के लिए

1. SKU फ़िल्टर में इसके हिसाब से ग्रुप बनाएं का इस्तेमाल करें.
2. लेबल कैरट को चुनें.
3. Key ड्रॉप-डाउन से, goog-maps-channel चुनें.
4. वैल्यू ड्रॉप-डाउन से, वे संख्यात्मक चैनल चुनें जिन्हें आपको फ़िल्टर करना है.

हर चैनल से जनरेट हुई लागत देखने के लिए, लेबल कुंजी goog-maps-channel के हिसाब से ग्रुप बनाएं.

अपने अनुरोधों में चैनल के इस्तेमाल का डेटा लागू करने के बाद, बिलिंग रिपोर्ट में डेटा दिखने में कुछ समय (24 घंटे तक) लग सकता है.

BigQuery की मदद से बिलिंग डेटा एक्सपोर्ट करना

आपके पास बिलिंग डेटा को BigQuery में एक्सपोर्ट करने का विकल्प भी होता है.

BigQuery Export का इस्तेमाल करके, क्लाउड बिलिंग से जुड़े ज़्यादा डेटा (जैसे, इस्तेमाल और खर्च के अनुमान का डेटा) को अपने-आप एक्सपोर्ट किया जा सकता है. यह डेटा, आपके बताए गए BigQuery डेटासेट में हर दिन अपने-आप एक्सपोर्ट होता है. इसके बाद, बारीकी से विश्लेषण करने के लिए, बिलिंग डेटा को BigQuery से ऐक्सेस किया जा सकता है. इससे आपको Google Maps Platform के इस्तेमाल के सोर्स के बारे में ज़्यादा जानकारी मिलती है.

अगर आपको BigQuery Export का इस्तेमाल शुरू करना है और डेटा की क्वेरी करनी है, तो यहां दी गई सैंपल क्वेरी को आज़माएं. इस क्वेरी को चलाने से पहले, आपको ये काम करने होंगे:

• अपने खाते में बिलिंग और BigQuery में बिलिंग का डेटा एक्सपोर्ट करने की सुविधा चालू करें.
• टेबल का फ़ॉर्मैट PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID है. इसमें:
• PROJECT_ID आपका असली प्रोजेक्ट आईडी है. जैसे, "my-project-123456".
• DATASET_NAME, आपके बनाए गए डेटासेट का नाम है (उदाहरण के लिए, "SampleDataSet").
• BILLING_ACCOUNT_ID आपके बिलिंग खाते के आईडी का रेफ़रंस है. इसके पहले "gcp_billing_exportv1" जोड़ा जाता है और डैश (-) को अंडरस्कोर (_) में बदल दिया जाता है. उदाहरण के लिए, बिलिंग खाता आईडी 123456-7890AB-CDEF01, gcp_billing_export_v1_123456_789AB_CDEF01 हो जाएगा.

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

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

इसी विषय से जुड़े लिंक

Cloud Billing:

• अपना Cloud Billing खाता बनाना, उसमें बदलाव करना या उसे बंद करना
• किसी प्रोजेक्ट की बिलिंग सेटिंग में बदलाव करना
• अपनी बिलिंग रिपोर्ट और लागत के रुझान देखना
• बजट और बजट से जुड़ी सूचनाएं सेट करना
• एपीआई के इस्तेमाल को सीमित करना

Google Maps Platform:

• Google Maps Platform की बिलिंग
• ऑप्टिमाइज़ेशन गाइड
• एपीआई पासकोड इस्तेमाल करने के सबसे सही तरीके

जवाब की स्थिति और रिपोर्ट

यहां दी गई टेबल में, Maps API के स्टेटस, Maps API के रिस्पॉन्स में मिले एचटीटीपी रिस्पॉन्स कोड, और इस्तेमाल की रिपोर्ट में मौजूद एचटीटीपी रिस्पॉन्स कोड क्लास के बीच मैपिंग दिखाई गई है. साथ ही, यह भी बताया गया है कि संबंधित अनुरोध, इस्तेमाल, कोटा, और बिलिंग की रिपोर्ट में दिखता है या नहीं.

ध्यान दें: कुछ समय पहले, Google Maps Platform API के अनुरोधों के जवाब में मिले एचटीटीपी रिस्पॉन्स कोड, इस्तेमाल की रिपोर्ट (Google Maps Platform की मेट्रिक) में मौजूद एचटीटीपी रिस्पॉन्स कोड से अलग हो सकते हैं. इस्तेमाल की रिपोर्ट की मेट्रिक, रिस्पॉन्स कोड की वैल्यू के ऐसे सेट का इस्तेमाल करती हैं जो नए एपीआई में इस्तेमाल की गई वैल्यू के मुताबिक होती हैं. इससे Google Maps Platform की मेट्रिक और Google Maps Platform की मॉनिटरिंग में, एपीआई के इस्तेमाल की जानकारी को बेहतर तरीके से देखा जा सकता है.

Google Maps Platform की मेट्रिक में इस्तेमाल की रिपोर्ट

HTTP response code class के हिसाब से जानकारी का लेवल उपलब्ध कराएं. अगर आपको ज़्यादा जानकारी चाहिए, तो जवाब के स्टेटस कोड देखें

Google Maps Platform के इस्तेमाल की निगरानी में उपलब्ध है.

Maps API से मिले जवाबों में उपलब्ध रिस्पॉन्स कोड		इस्तेमाल की रिपोर्ट में उपलब्ध है	इन्हें रिपोर्ट किया गया
Maps API का स्टेटस	एचटीटीपी रिस्पॉन्स कोड	एचटीटीपी रिस्पॉन्स कोड क्लास	इस्तेमाल	कोटा	बिलिंग
ठीक है	200, 204, 302	2xx, 3xx	हां	हां	हां
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS	200, 404	4xx^1	हां	हां	हां
INVALID_REQUEST (अमान्य पैरामीटर वैल्यू), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, वगैरह.	200, 400	4xx	हां	हां	हां
INVALID_REQUEST (अमान्य/मौजूद नहीं है पैरामीटर, अनुरोध पार्स करने में गड़बड़ी)	200, 400	4xx	हां	नहीं	नहीं
REQUEST_DENIED	200, 400, 403	4xx^1	हां	नहीं	नहीं
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200, 403, 429	4xx^1	हां	नहीं	नहीं
UNKNOWN_ERROR	200, 500, 503	5xx^1	हां	हां	नहीं
^1 गड़बड़ी के कोड की रिपोर्टिंग को बेहतर बनाने के लिए, Google Maps Platform API माइग्रेट हो रहे हैं: 1) Maps API के स्टेटस के लिए, एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx पर: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status, 2) Maps API के स्टेटस के लिए, एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx पर: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) Maps API के स्टेटस के लिए, एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 5xx पर: UNKNOWN_ERROR. ट्रांज़िशन की अवधि के दौरान, दोनों रिस्पॉन्स कोड देखे जा सकते हैं. Maps API के जवाबों में दिखाए गए रिस्पॉन्स कोड नहीं बदल रहे हैं. पुष्टि करें कि Google Maps Platform मेट्रिक में 4xx और/या 5xx में हुई बढ़ोतरी, इस माइग्रेशन से जुड़ी है. इसके लिए, यह देखें कि मेट्रिक एक्सप्लोरर में कौनसे रिस्पॉन्स कोड में बढ़ोतरी हुई है. ज़्यादा जानें पर क्लिक करके, Google Maps Platform के लिए Google Cloud Monitoring इस्तेमाल करने के बारे में जानें.