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

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

अलग-अलग तरह की रिपोर्ट में ये शामिल हैं:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

मॉनिटरिंग एपीआई

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

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

    प्रोजेक्ट सिलेक्टर पेज

  2. अपना प्रोजेक्ट चुनें. ऐसा करने पर, एपीआई और सेवाओं का डैशबोर्ड पेज दिखेगा.

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

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

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

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

खास जानकारी वाले चार्ट का स्क्रीनशॉट, जिसमें चालू किए गए एपीआई और पिछले 30 दिनों के एपीआई अनुरोधों की सूची वाली टेबल दिख रही है.

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

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

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

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

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

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

एपीआई

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

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

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

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

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

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

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

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

मेट्रिक पेज पर तीन ग्राफ़ दिखाए गए हैं: ट्रैफ़िक, गड़बड़ियां, और मीडियन इंतज़ार का समय.

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

प्लैटफ़ॉर्म फ़िल्टर सिर्फ़ तब दिखता है, जब एक एपीआई चुना जाता है. प्लैटफ़ॉर्म फ़िल्टर सिर्फ़ तब दिखता है, जब एक एपीआई चुना जाता है.

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

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

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

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

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

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

क्रेडेंशियल का फ़ॉर्मैट मतलब
मुख्य नाम
उदाहरण के लिए, "मोबाइल ऐप्लिकेशन कुंजी"		 ?key=... का इस्तेमाल करके, एपीआई को लोड करने के लिए एपीआई पासकोड का इस्तेमाल किया गया था: Maps Platform Console पर, पासकोड और क्रेडेंशियल में जाकर, पासकोड के नाम देखे जा सकते हैं.
प्रोजेक्ट नंबर
उदाहरण के लिए, "project_number:123456", जहां 123456 आपका प्रोजेक्ट नंबर है.		 अगर आपको यह क्रेडेंशियल दिखता है, तो दो बातें हो सकती हैं:
  1. 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, Time Zone API. ज़्यादा जानकारी के लिए, Premium प्लान के क्लाइंट आईडी को मैनेज करना लेख पढ़ें.

  2. OAuth स्वीकार करने वाले एपीआई के लिए: एपीआई को एपीआई पासकोड के बिना, OAuth का इस्तेमाल करके लोड किया गया था.

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

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

Maps API की स्थिति एचटीटीपी रिस्पॉन्स कोड क्लास - इस्तेमाल की रिपोर्ट
(2xx, 3xx, 4xx, 5xx)		 नोट
ठीक है 2xx जवाब मिल गया.

यह अनुरोध, बिलिंग के दायरे में आता है. साथ ही, इससे कोटा भी खर्च होगा.
ठीक है 3xx जवाब मिल गया.

यह अनुरोध, बिलिंग के दायरे में आता है. साथ ही, इससे कोटा भी खर्च होगा.

उदाहरण के लिए, जगह की फ़ोटो के जिस अनुरोध पर कार्रवाई की गई है उसके आधार पर, रेफ़रंस के तौर पर दी गई इमेज पर 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 4एक्सएक्स पुष्टि करने में गड़बड़ी, ऐक्सेस करने में गड़बड़ी वगैरह की वजह से क्लाइंट गड़बड़ी. ज़्यादा जानकारी के लिए, एपीआई का रिस्पॉन्स देखें.
OVER_ALL_LIMIT,
OVER_QUERY_LIMIT,
डेटा_EXHAUSTED,
RateLimitExceeded,
DailyLimitExceeded,
userRateLimitExceeded		 4एक्सएक्स तय समयावधि में बहुत ज़्यादा अनुरोध करने की वजह से क्लाइंट की गड़बड़ी. बाद में, अनुरोध फिर से करें. ज़्यादा जानकारी के लिए, एपीआई से मिला रिस्पॉन्स देखें.
INVALID_REQUEST (अमान्य या मौजूद न होने वाला पैरामीटर, अनुरोध को पार्स करने या पुष्टि करने से जुड़ी गड़बड़ी) 4xx अमान्य अनुरोध की वजह से क्लाइंट की गड़बड़ी. ज़्यादा जानकारी के लिए, एपीआई रिस्पॉन्स देखें.
NOT_FOUND (404) 4xx Geolocation API के लिए, इस मैसेज का मतलब है कि जगह की जानकारी का अनुमान लगाने के लिए, डाले गए इनपुट काफ़ी नहीं थे.

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

यह अनुरोध, बिलिंग के दायरे में आता है. साथ ही, इससे कोटा भी खर्च होगा.
UNKNOWN_ERROR 5xx सर्वर में गड़बड़ी, जिससे पता चलता है कि अनुरोध को प्रोसेस नहीं किया जा सकता: इंटरनल गड़बड़ी, सेवा ओवरलोड है, उपलब्ध नहीं है, टाइम आउट वगैरह.
1 Maps API की स्थितियों के लिए, गड़बड़ी कोड की रिपोर्टिंग को बेहतर बनाने के लिए, Google Maps Platform एपीआई: 1) एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx में माइग्रेट कर रहे हैं: Maps API की स्थितियों के लिए: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - स्टेटस, 2) एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx में Maps API की स्थितियों के लिए: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, {13: class1, {/} 36 API कोड, {13:}userRateLimitExceeded के रिस्पॉन्स कोड2xxrateLimitExceeded5xxUNKNOWN_ERROR ट्रांज़िशन की अवधि के दौरान, आपको दोनों रिस्पॉन्स कोड दिख सकते हैं. Maps API के रिस्पॉन्स से मिले रिस्पॉन्स कोड में बदलाव नहीं हो रहा है. पक्का करें कि Google Maps Platform मेट्रिक में 4xx और/या 5xx की बढ़ोतरी, इस माइग्रेशन से जुड़ी है. इसके लिए, मेट्रिक एक्सप्लोरर में देखें कि कौनसे सटीक रिस्पॉन्स कोड में बढ़ोतरी होती है (Google Maps Platform पर, Google Cloud Monitoring का इस्तेमाल करने के बारे में ज़्यादा जानें).

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

Google Maps Platform के सलूशन पैरामीटर

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

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

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

कोटा रिपोर्ट

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

कोटा के इस्तेमाल की जानकारी, 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 स्टैटिक एपीआई, Street View स्टैटिक एपीआई, जियोकोडिंग एपीआई, निर्देशों के लिए एपीआई, जगहें एपीआई, टाइम ज़ोन एपीआई, जियोलोकेशन एपीआई, और एलिवेशन एपीआई. हालांकि, कुछ अपवाद हैं:

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

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

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 एक अनुरोध
Maps Aerial View API एक अनुरोध
Maps स्टैटिक एपीआई एक अनुरोध
Maps JavaScript एपीआई 1 मैप लोड
Street View Static API एक अनुरोध
Maps एंबेड एपीआई मैप लोड करने में लगने वाला समय
रास्ते
Routes API (Compute Routes) 1 अनुरोध
Routes API (Compute Route Matrix) एक एलिमेंट (ऑरिजिन-डेस्टिनेशन पेयर)
निर्देश से जुड़ा एपीआई 1 अनुरोध
दूरी के मैट्रिक्स का एपीआई एक एलिमेंट (ऑरिजिन-डेस्टिनेशन पेयर)
रास्तों की जानकारी देने से जुड़ा एपीआई एक अनुरोध
Route Optimization API 1 अनुरोध
Android के लिए नेविगेशन एसडीके टूल एक डेस्टिनेशन
iOS के लिए नेविगेशन एसडीके टूल एक डेस्टिनेशन
जगहें
Places API 1 अनुरोध
Address Validation API एक अनुरोध
जियोकोडिंग एपीआई एक अनुरोध
जियोलोकेशन एपीआई एक अनुरोध
समय क्षेत्र एपीआई एक अनुरोध
परिवेश
Air Quality API (CurrentConditions और HeatmapTile) एक अनुरोध
Air Quality API (इतिहास) 1 पेज
Pollen API एक अनुरोध
Solar API एक अनुरोध

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

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

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

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

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

    प्रोजेक्ट सिलेक्टर पेज

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

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

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

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

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

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

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

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

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

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

डेटा खर्च पर नज़र रखना और उस पर पाबंदी लगाना

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

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

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

हर चैनल के हिसाब से, इस्तेमाल की ट्रैकिंग

संख्या वाले चैनलों के ज़रिए अपने इस्तेमाल को ट्रैक करने के लिए, आपको अपने एपीआई अनुरोधों में 'चैनल' पैरामीटर जोड़ना होगा. चैनल की वैल्यू के तौर पर सिर्फ़ 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 API 
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
async defer></script>

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

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

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

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

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

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

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

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

  • अपने खाते में बिलिंग और 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 हो जाएगा.

  #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:

Google Maps Platform:

जवाब का स्टेटस और रिपोर्ट

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

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		 4xx1 हां हां हां
INVALID_REQUEST (अमान्य पैरामीटर वैल्यू),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
वगैरह.		 200,
400		 4xx हां हां हां
INVALID_REQUEST (अमान्य/मौजूद नहीं पैरामीटर, पार्स करने में गड़बड़ी का अनुरोध करें) 200,
400		 4xx हां नहीं नहीं
REQUEST_DENIED 200,
400,
403		 4xx1 हां नहीं नहीं
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded 		200,
403,
429		 4xx1 हां नहीं नहीं
UNKNOWN_ERROR 200,
500,
503		 5xx1 हां हां नहीं
1 Maps API की स्थितियों के लिए, गड़बड़ी कोड की रिपोर्टिंग को बेहतर बनाने के लिए, Google Maps Platform एपीआई: 1) एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx में माइग्रेट कर रहे हैं: Maps API की स्थितियों के लिए: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - स्टेटस, 2) एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx में Maps API की स्थितियों के लिए: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, {13: class1, {/} के लिए 36 रिस्पॉन्स कोड, {13:एपीआई कोड की स्थिति से 4xx)2xxrateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR ट्रांज़िशन की अवधि के दौरान, आपको दोनों रिस्पॉन्स कोड दिख सकते हैं. Maps API के जवाबों में दिखाए गए रिस्पॉन्स कोड नहीं बदल रहे हैं. पुष्टि करें कि Google Maps Platform की मेट्रिक में 4xx और/या 5xx में हुई बढ़ोतरी, इस माइग्रेशन से जुड़ी है. इसके लिए, देखें कि Metrics Explorer में कौनसा सटीक रिस्पॉन्स कोड बढ़ता है. Google Maps Platform के लिए, Google Cloud की मॉनिटरिंग का इस्तेमाल करने के बारे में ज़्यादा जानें.

दिलचस्पी की रिपोर्ट

व्‍यवसाय अंतर्दृष्टि

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

कारोबार की अहम जानकारी से जुड़ी रिपोर्टिंग की सुविधाओं में ये शामिल हैं:

  • कारोबार की अहम जानकारी का हाई-लेवल स्नैपशॉट देखना, ताकि कारोबार की अहम जानकारी में एक नज़र में मुख्य रुझान देखे जा सकें
  • मेट्रिक के बारे में ज़्यादा जानकारी के लिए, कंसोल में किसी खास मेट्रिक का विश्लेषण करने के लिए ड्रिल-डाउन करना
  • मेट्रिक को CSV फ़ॉर्मैट में एक्सपोर्ट करना, ताकि आप अपने पसंदीदा कारोबार विश्लेषण टूल में, कारोबार की अहम जानकारी के डेटा का विश्लेषण कर सकें

यूज़र ऐक्टिविटी की मेट्रिक में ये शामिल हैं:

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

प्रोजेक्ट के मालिक और Maps Analytics व्यूअर की भूमिका वाले उपयोगकर्ता, Cloud Console में मेट्रिक पेज पर कारोबार की अहम जानकारी देख सकते हैं. प्रोजेक्ट में Maps JavaScript API चालू होना चाहिए.

सीधे कंसोल में यूज़र ऐक्टिविटी वाली मेट्रिक का विश्लेषण किया जा सकता है. इसके लिए, 'फ़िल्टर करें' और 'ग्रुप के हिसाब से बनाएं' सुविधा की मदद से, मेट्रिक के बारे में ज़्यादा जानकारी पाएं. उदाहरण के लिए, किसी खास इलाके के हिसाब से फ़िल्टर करके यह पता लगाया जा सकता है कि उस इलाके के सिर्फ़ पिन कोड के लिए, मैप व्यू में किस तरह का रुझान है. दूसरी ओर, हो सकता है कि आप किसी खास इलाके में होने वाले इंटरैक्शन को इकट्ठा करने के लिए, उसे किसी ग्रुप में बांटना चाहें.

उपयोगकर्ता आपके पसंदीदा कारोबार विश्लेषण टूल का और ज़्यादा विश्लेषण करने के लिए, पूरे डेटा सेट या फ़िल्टर किए गए व्यू को CSV में एक्सपोर्ट कर सकते हैं. एक बार में 90 दिनों तक का डेटा डाउनलोड किया जा सकता है. साथ ही, 60 हज़ार से ज़्यादा सेल डाउनलोड करने पर, डेटा काट दिया जाएगा. चुनी गई समयसीमा के आधार पर, मैप व्यू का डेटा CSV में एक्सपोर्ट होने में कुछ मिनट लग सकते हैं.

कारोबार की अहम जानकारी एक्सपोर्ट करना

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

Maps Analytics की अनुमति का इस्तेमाल करके, Google Cloud Console में अपने Cloud प्रोजेक्ट के लिए कारोबार की अहम जानकारी का ऐक्सेस कंट्रोल किया जा सकता है. प्रोजेक्ट के मालिकों को यह अनुमति डिफ़ॉल्ट रूप से मिलती है. साथ ही, वे ज़रूरत के हिसाब से अन्य उपयोगकर्ताओं को ऐक्सेस दे सकते हैं.

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