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 API के साथ-साथ, अन्य एपीआई और सेवाएं भी शामिल हैं.

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

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

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

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

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

  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 API का पेज

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

एपीआई

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

  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. बाएं मेन्यू में, मेट्रिक चुनें.

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

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

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

यह बिल किया जा सकता है और यह कोटा का इस्तेमाल करेगा.
ठीक है 3xx जवाब सफल रहा.

यह बिल किया जा सकता है और यह कोटा का इस्तेमाल करेगा.

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

यह बिल किया जा सकता है और यह कोटा का इस्तेमाल करेगा.
शून्य 4xx(1) सफल जवाब का कोई नतीजा नहीं मिला.

यह बिल किया जा सकता है और यह कोटा का इस्तेमाल करेगा.
नहीं मिला 4xx(1) निर्देश API के लिए, इससे पता चलता है कि अनुरोध के ऑरिजिन, डेस्टिनेशन या वेपॉइंट में बताई गई जगहों में से कम से कम एक को जियोकोड नहीं किया जा सका.

Locations API के लिए, इससे पता चलता है कि बताई गई जगह (place_id), Places के डेटाबेस में नहीं मिली.

यह बिल किया जा सकता है और यह कोटा का इस्तेमाल करेगा.
INVALID_REQUEST (अमान्य पैरामीटर वैल्यू),
MAX_WAYPOINTS_EXCEEDED,
MAX_AMOUNT_LENGTH_EXCEEDED वगैरह.
4xx पैरामीटर के अमान्य वैल्यू की वजह से गड़बड़ी हुई. ज़्यादा जानकारी के लिए, एपीआई से मिला रिस्पॉन्स देखें.

यह बिल किया जा सकता है और यह कोटा का इस्तेमाल करेगा.
अनुरोध अस्वीकार किया गया 4xx प्रमाणीकरण गड़बड़ी, ऐक्सेस गड़बड़ी वगैरह की वजह से क्लाइंट गड़बड़ी. ज़्यादा जानकारी के लिए एपीआई रिस्पॉन्स देखें.
over_रोज़_LIMIT,
OVER_QUERY_LIMIT,
Resource_EXHAUSTED,
rateLimitExceeded,
DailyLimitExceeded,
userRateLimitExceeded
4xx हर अनुमति दी गई समयावधि में, ज़्यादा अनुरोधों की वजह से क्लाइंट की गड़बड़ी हुई. अनुरोध बाद में करने की कोशिश करें. ज़्यादा जानकारी के लिए, एपीआई से मिला रिस्पॉन्स देखें.
INVALID_REQUEST (अमान्य/पैरामीटर मौजूद नहीं है, पार्स करने का अनुरोध/पुष्टि करने में गड़बड़ी) 4xx अमान्य अनुरोध की वजह से क्लाइंट की गड़बड़ी हुई. ज़्यादा जानकारी के लिए, एपीआई से मिला रिस्पॉन्स देखें.
NOT_FOUND (404) 4xx भौगोलिक स्थान एपीआई के लिए, इससे पता चलता है कि जगह का अनुमान लगाने के लिए इनपुट काफ़ी नहीं थे.

Roads API के लिए, इससे पता चलता है कि इनपुट को सड़कों पर ठीक नहीं किया जा सका.

यह बिल किया जा सकता है और यह कोटा का इस्तेमाल करेगा.
कोई जानकारी मौजूद नहीं है 5xx सर्वर की गड़बड़ी से पता चलता है कि अनुरोध पर कार्रवाई नहीं की जा सकती: अंदरूनी गड़बड़ी, सेवा ओवरलोड, उपलब्ध नहीं है, समय खत्म हो गया है वगैरह.
2xx2xx2xx4xx4xxDATA_NOT_AVAILABLENOT_FOUNDZERO_RESULTSREQUEST_DENIEDOVER_DAILY_LIMITOVER_QUERY_LIMITdailyLimitExceededrateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR आप ट्रांज़िशन की अवधि के दौरान दोनों रिस्पॉन्स कोड देख सकते हैं. Maps API के जवाबों में मिले रिस्पॉन्स कोड में कोई बदलाव नहीं हो रहा है. पक्का करें कि Google Maps Platform मेट्रिक में 4xx और/या 5xx की बढ़ोतरी इस माइग्रेशन से जुड़ी है. इसके लिए, मेट्रिक एक्सप्लोरर में पता लगाएं कि कौनसा रिस्पॉन्स कोड बढ़ता है. (Google Maps Platform के लिए, Google Cloud मॉनिटरिंग के बारे में ज़्यादा जानें).

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

Google Maps Platform से जुड़े समाधान का पैरामीटर

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

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

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

कोटा रिपोर्ट

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

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

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

Google Maps कोटा पेज

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

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

  • डिस्टेंस मैट्रिक्स एपीआई के लिए, कोटा यूनिट एक ऐसा एलिमेंट है जो ऑरिजिन-डेस्टिनेशन पेयर है.
  • Maps JavaScript API के लिए, कोटा यूनिट, मैप लोड है.
  • Android के लिए Maps SDK टूल और iOS के लिए Maps SDK टूल के लिए, 'स्ट्रीट व्यू' अनुरोध/पैनोरामा लोड ही कोटा यूनिट है (मैप लोड बिना किसी शुल्क के उपलब्ध होते हैं और कोटा का इस्तेमाल नहीं करते).

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

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

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

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 या webservice), और goog-maps-channel (एपीआई क्वेरी से आंकड़ों के लिए एक सेट न्यूमेरिक चैनल वैल्यू). फ़िल्टर करने और ग्रुप बनाने के बारे में ज़्यादा जानकारी.

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

इस्तेमाल पर नज़र रखना और उस पर पाबंदी लगाना

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

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

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

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

  • जियोकोडिंग वेब सर्विस एपीआई
    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>

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

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

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

अनुरोधों में, चैनल के इस्तेमाल का डेटा लागू करने के बाद, आपकी बिलिंग रिपोर्ट में डेटा दिखने में थोड़ा समय (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 हो जाएगा.

  #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
  

क्लाउड बिलिंग:

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 4xx1 हां हां हां
NOT_FOUND (Street View स्टैटिक, भौगोलिक स्थान, और सड़क एपीआई),
ZERO_RESULTS (Street View Static API)
404 4xx हां हां हां
INVALID_REQUEST (अमान्य पैरामीटर वैल्यू),
MAX_AMOUNT_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
वगैरह.
200/400 4xx हां हां हां
INVALID_REQUEST (अमान्य/पैरामीटर मौजूद नहीं है, पार्सिंग का अनुरोध करने में गड़बड़ी) 200/400 4xx हां नहीं नहीं
अनुरोध अस्वीकार किया गया 200/400/403 4xx1 हां नहीं नहीं
OVER_रोज़_LIMIT,
OVER_QUERY_LIMIT,
Resource_EXHAUSTED,
DailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
200/403,
429
4xx1 हां नहीं नहीं
कोई जानकारी मौजूद नहीं है 200/500,
503
5xx1 हां हां नहीं
2xx2xx2xx4xx4xxDATA_NOT_AVAILABLENOT_FOUNDZERO_RESULTSREQUEST_DENIEDOVER_DAILY_LIMITOVER_QUERY_LIMITdailyLimitExceededrateLimitExceededuserRateLimitExceeded5xxUNKNOWN_ERROR आप ट्रांज़िशन की अवधि के दौरान दोनों रिस्पॉन्स कोड देख सकते हैं. Maps API के जवाबों में मिले रिस्पॉन्स कोड में कोई बदलाव नहीं हो रहा है. पक्का करें कि Google Maps Platform मेट्रिक में 4xx और/या 5xx की बढ़ोतरी इस माइग्रेशन से जुड़ी है. इसके लिए, मेट्रिक एक्सप्लोरर में पता लगाएं कि कौनसा रिस्पॉन्स कोड बढ़ता है. (Google Maps Platform के लिए, Google Cloud मॉनिटरिंग के बारे में ज़्यादा जानें).

सहभागिता रिपोर्ट

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

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

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

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

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

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

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

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

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

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

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

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

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

लोकेटर प्लस

Locator Plus उपयोगकर्ताओं के लिए, ऐनलिटिक्स डैशबोर्ड की मदद से अपने डेटा का विश्लेषण किया जा सकता है और उसे जनरेट किया जा सकता है. इससे साफ़ तौर पर पता चलता है कि खरीदार आपके स्टोर लोकेटर से कितनी अच्छी तरह जुड़ रहे हैं. हफ़्ते-दर-हफ़्ते अपनी परफ़ॉर्मेंस का आकलन किया जा सकता है. इसमें व्यू की संख्या, सर्च और जगह की जानकारी के साथ इंटरैक्शन की संख्या, और दर्शकों के जुड़ाव की कुल दर शामिल है. साथ ही, डैशबोर्ड पर आपको इससे जुड़े अहम मानदंड मिलते हैं कि अन्य खुदरा दुकानदारों की तुलना में, आपने जो लागू किया है उसकी तुलना कैसे की जा सकती है.

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

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