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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • बजट से जुड़ी सूचना सेट करें, ताकि यह ट्रैक किया जा सके कि आपका खर्च किसी तय रकम तक कैसे बढ़ रहा है. बजट सेट करने से, API के इस्तेमाल पर कोई सीमा नहीं आती. यह सिर्फ़ तभी सूचना देता है, जब आपका खर्च तय की गई रकम के आस-पास पहुंच जाता है.
  • एपीआई के रोज़ के इस्तेमाल की सीमा तय करें, ताकि शुल्क वाले एपीआई के इस्तेमाल की लागत को मैनेज किया जा सके. हर दिन के अनुरोधों की सीमा सेट करके, खर्च को सीमित किया जा सकता है. आपको कितना खर्च करना है, इसके आधार पर अपने रोज़ के कैप को तय करने के लिए, एक आसान समीकरण का इस्तेमाल करें. उदाहरण के लिए: (हर महीने का खर्च /हर 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 एपीआई
    <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 गड़बड़ी के कोड की रिपोर्टिंग को बेहतर बनाने के लिए, Google Maps Platform के एपीआई माइग्रेट किए जा रहे हैं: 1) Maps API के स्टेटस: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status के लिए, एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx पर, 2) Maps API के स्टेटस: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded के लिए, एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 4xx पर, 3) Maps API के स्टेटस: UNKNOWN_ERROR के लिए, एचटीटीपी रिस्पॉन्स कोड क्लास 2xx से 5xx पर. ट्रांज़िशन की अवधि के दौरान, आपको दोनों रिस्पॉन्स कोड दिख सकते हैं. 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 प्रोजेक्ट के लिए कारोबार की अहम जानकारी का ऐक्सेस कंट्रोल किया जा सकता है. प्रोजेक्ट के मालिकों को यह अनुमति डिफ़ॉल्ट रूप से मिलती है. साथ ही, वे ज़रूरत के हिसाब से अन्य उपयोगकर्ताओं को ऐक्सेस दे सकते हैं.

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