Google Maps Platform की जानकारी देना

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

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

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

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

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

लाइसेंस वाले संगीत के इस्तेमाल से जुड़ी रिपोर्ट

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

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

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

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

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

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

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

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

निगरानी करने वाले एपीआई

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

  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) निर्देश एपीआई के लिए यह बताता है कि अनुरोध की शुरुआत की जगह, मंज़िल या वेपॉइंट में बताई गई जगहों में से कम से कम एक जगह भौगोलिक नहीं हो सकती.

जगहों के एपीआई के लिए इससे पता चलता है कि रेफ़र की गई जगह (place_id), Places डेटाबेस में नहीं मिली थी.

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

यह एक ऐसा अनुरोध है जिसके लिए बिलिंग की जाती है. इसमें स्टोरेज का इस्तेमाल किया जाएगा.
अनुरोध का जवाब दिया जा चुका है 4xx पुष्टि करने में हुई गड़बड़ी, ऐक्सेस की गड़बड़ी वगैरह की वजह से क्लाइंट गड़बड़ी हुई. ज़्यादा जानकारी के लिए एपीआई रिस्पॉन्स देखें.
OVER_TODAY_LIMIT_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
transactionLIMITExeded,
DailyLimitExceeded,
userRateLIMITExeded,
4xx तय समय में बहुत ज़्यादा अनुरोधों की वजह से क्लाइंट गड़बड़ी हुई. कुछ देर बाद कोशिश करें. ज़्यादा जानकारी के लिए, एपीआई से मिला रिस्पॉन्स देखें.
INVALID_REQUEST (अमान्य/मान पैरामीटर नहीं, पार्सिंग/वैलिडेशन गड़बड़ी का अनुरोध करें) 4xx अमान्य अनुरोध की वजह से क्लाइंट की गड़बड़ी. ज़्यादा जानकारी के लिए, एपीआई से मिला रिस्पॉन्स देखें.
NOT_FOUND (404) 4xx Geolocation API के लिए, इससे यह पता चलता है कि इनपुट, जगह का अनुमान लगाने के लिए काफ़ी नहीं थे.

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

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

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

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

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

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

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

कोटा की रिपोर्ट

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

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

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

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

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

Google Maps Platform:

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

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

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

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

व्यवसाय जानकारी

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

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

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

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

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

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

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

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

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

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

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

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

लोकेटर प्लस

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

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

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