گزارش پلت فرم نقشه های گوگل

گزارش‌دهی در پلتفرم نقشه‌های Google مجموعه‌ای از گزارش‌های بصری از پیش تعریف‌شده از استفاده پایه، سهمیه و اطلاعات صورت‌حساب در Google Cloud Console را ارائه می‌دهد. از این گزارش‌ها برای تعیین تعداد تماس‌های API که برقرار کرده‌اید، میزان نزدیکی شما به رسیدن به سهمیه استفاده از API و نظارت بر میزان استفاده از صورت‌حساب خود در طول زمان استفاده کنید.

انواع گزارش عبارتند از:

  • گزارش‌های استفاده : تعداد درخواست‌هایی را که پروژه شما به APIهای پلتفرم Google Maps با استفاده از اعتبارنامه‌های مرتبط با پروژه شما می‌کند، گزارش می‌کند.
  • گزارش‌های سهمیه : میزان استفاده از سهمیه را در نمودارها گزارش می‌کند که می‌توانند در درخواست‌ها در دقیقه گروه‌بندی شوند. محدودیت های فعلی سهمیه برای API های انتخاب شده در جداول زیر نمودارهای استفاده از سهمیه نمایش داده می شود.
  • گزارش‌های صورت‌حساب : هزینه‌ها را در طول زمان به صورت نمودار خطی پشته‌ای گزارش می‌کند. میزان استفاده از سهمیه ماه جاری را مشاهده کنید، شامل هر گونه اعتبار خاص استفاده اعمال شده، و همچنین کل هزینه پیش بینی شده برای کل ماه جاری.
  • گزارش‌های مشارکت : بینش‌های تجاری درباره نحوه تعامل کاربران با برنامه‌های نقشه شما ارائه دهید.

برای فهرست کاملی از وضعیت‌های پاسخ و کدهای پاسخ که مشخص می‌کنند درخواست در گزارش‌های استفاده ، سهمیه و/یا صورت‌حساب ظاهر می‌شود، به وضعیت پاسخ و گزارش‌ها مراجعه کنید.

گزارش‌های استفاده، سهمیه و صورت‌حساب پلتفرم Google Maps را با استفاده از Cloud Console مشاهده کنید.

گزارش های استفاده

استفاده بر اساس تعداد درخواست‌هایی است که پروژه شما با استفاده از اعتبارنامه‌های مرتبط با پروژه شما به APIهای پلتفرم Google Maps ارائه می‌کند. درخواست‌ها شامل درخواست‌های موفق، درخواست‌هایی که منجر به خطای سرور می‌شوند و درخواست‌هایی که منجر به خطاهای مشتری می‌شوند، می‌شوند. اعتبارنامه‌ها شامل کلیدهای API و شناسه‌های مشتری (برای طرح‌های Premium و پروژه‌های مهاجرت‌شده Premium Plan) است. برای جزئیات، به نمای کلی طرح Premium و اطلاعات مربوط به استفاده از شناسه مشتری مراجعه کنید.

معیارهای استفاده در جداول (درخواست‌ها، خطاها و تأخیر) و نمودارها (ترافیک، خطاها و تأخیر) نمایش داده می‌شوند. برای اهداف ردیابی:

  • همه API ها : می توانید معیارهای استفاده را برای همه API ها به این روش فیلتر و گروه بندی کنید:

    • بر اساس دوره زمانی و API فیلتر کنید.
    • ترافیک، خطا و تأخیر را گروه‌بندی شده بر اساس کد پاسخ، API و اعتبارنامه ببینید.
  • یک API خاص : می‌توانید معیارهای استفاده را برای یک API خاص به این روش‌ها فیلتر و گروه‌بندی کنید:

    • بر اساس دوره زمانی، نسخه‌های API، اعتبارنامه‌ها و روش‌ها فیلتر کنید.
    • ترافیک، خطا و تأخیر را بر اساس کد پاسخ، روش و نسخه API، و اعتبار گروه بندی کنید.

صفحه داشبورد APIs & Services

داشبورد APIs & Services یک نمای کلی از معیارهای استفاده برای همه APIهای فعال شده برای پروژه شما ارائه می دهد: APIهای پلتفرم Google Maps و همچنین سایر APIها و خدمات.

  • صفحه داشبورد دارای سه نمودار و یک جدول است. می توانید با انتخاب بازه زمانی از 1 ساعت تا 30 روز گذشته، میزان مصرف نمایش داده شده در نمودارها و جداول را فیلتر کنید.

  • نمودار ترافیک استفاده از پرس و جو در ثانیه (QPS) را در هر API نشان می دهد.

  • نمودار خطاها درصد درخواست هایی را نشان می دهد که منجر به خطا در هر API شده است.

  • نمودار تأخیر ، تأخیر متوسط ​​درخواست‌ها در هر API را نشان می‌دهد.

در زیر نمودارها، جدولی API ها و سرویس های فعال را فهرست می کند. درخواست ها تعداد درخواست ها (برای دوره زمانی انتخاب شده) است. خطاها تعداد این درخواست ها هستند که منجر به خطا می شوند. تأخیر (تأخیر متوسط ​​و صدک) تأخیر برای این درخواست ها است.

نظارت بر apis

برای دسترسی به صفحه داشبورد API ها و خدمات:

  1. صفحه انتخابگر پروژه را در Cloud Console باز کنید:

    صفحه انتخاب پروژه

  2. پروژه خود را انتخاب کنید صفحه داشبورد APIs & Services ظاهر می شود.

    اگر صفحه ظاهر نشد، دکمه منو را انتخاب کنیدمنو و سپس APIs & Services را انتخاب کنید.

برای اطلاعات بیشتر، به نظارت بر استفاده از API مراجعه کنید.

صفحه نمای کلی نقشه های گوگل

صفحه نمای کلی Google Maps شامل جدولی است که APIهای فعال و درخواست‌های استفاده در 30 روز گذشته را فهرست می‌کند. درخواست های API نیز به صورت نمودار نشان داده شده است. نمودار صورتحساب صورتحساب فعلی و کل استفاده شما را در 3 ماه گذشته نشان می دهد.

تصویری از نمودار نمای کلی که جدولی را نشان می دهد که API های فعال و درخواست های API را برای 30 روز گذشته فهرست می کند.

برای دسترسی به صفحه نمای کلی پلتفرم نقشه های گوگل:

  1. صفحه پلتفرم Google Maps را در کنسول Cloud باز کنید:

    به صفحه پلتفرم نقشه های گوگل بروید

  2. در منوی سمت چپ، نمای کلی را انتخاب کنید.

صفحه APIهای پلتفرم Google Maps

صفحه Google Maps APIs شامل دو جدول است. جدول Enabled APIs تعداد درخواست‌ها، تعداد خطاها و میانگین تأخیر را برای هر API فعال در 30 روز گذشته نشان می‌دهد. جدول Additional APIs API هایی را فهرست می کند که فعال نشده اند.

apis

برای دسترسی به صفحه API های پلتفرم Google Maps:

  1. صفحه پلتفرم Google Maps را در کنسول Cloud باز کنید:

    به صفحه پلتفرم نقشه های گوگل بروید

  2. در منوی سمت چپ، APIs را انتخاب کنید.

صفحه متریک نقشه های گوگل

صفحه Google Maps Metrics سه نمودار را نمایش می دهد: ترافیک، خطاها و تأخیر میانه. داده های استفاده در نمودارها را می توان بر اساس کلاس کد پاسخ، API، روش API، اعتبار، پلتفرم و دامنه گروه بندی کرد.

در زیر نمودارها، صفحه Metrics شامل یک جدول API است که درخواست‌ها، خطاها و تأخیر APIهایی را که انتخاب کرده‌اید نشان می‌دهد.

با استفاده از منوی کرکره‌ای API در بالا، و گزینه‌های گروه‌بندی و فیلتر در قسمت سمت راست، می‌توانید معیارهای استفاده نمایش‌داده‌شده را با انتخاب APIهای خاص یا چندگانه، اعتبارنامه‌ها، کلاس‌های کد پاسخ، نوع پلتفرم و/یا دامنه، گروه‌بندی و فیلتر کنید. همچنین می توانید یک دوره زمانی (از یک ساعت تا 30 روز گذشته) و جزئیات (در هر ثانیه یا روز) را برای معیارهای استفاده نمایش داده شده انتخاب کنید.

صفحه معیارها که سه نمودار را نمایش می دهد: ترافیک، خطاها و تأخیر میانه.

تصاویر زیر فیلترهای پلتفرم و دامنه را برای یک API نشان می‌دهند که گروه‌بندی بر اساس پلتفرم و دامنه در لیست کشویی گروه‌بندی شده بر اساس انتخاب شده است:

فیلتر پلت فرم فقط زمانی ظاهر می شود که یک API منفرد انتخاب شده باشد.فیلتر پلت فرم فقط زمانی ظاهر می شود که یک API منفرد انتخاب شده باشد.

برای دسترسی به صفحه معیارهای API پلتفرم Google Maps:

  1. صفحه پلتفرم Google Maps را در کنسول Cloud باز کنید:

    به صفحه پلتفرم نقشه های گوگل بروید

  2. در منوی سمت چپ، Metrics را انتخاب کنید.

گزارش اعتبار

می توانید معیارها را بر اساس اعتباری که برای بارگیری API استفاده شده است فیلتر و گروه بندی کنید.

فرمت اعتبارنامه معنی
نام کلید
به عنوان مثال، "کلید برنامه تلفن همراه"
یک کلید API برای بارگیری API با استفاده از ?key=... استفاده شد: می‌توانید نام کلیدها را در کنسول پلتفرم Maps در زیر کلیدها و اعتبارنامه‌ها پیدا کنید.
شماره پروژه
به عنوان مثال، "project_number:123456"، که در آن 123456 شماره پروژه شما است.
اگر این اعتبار را ببینید دو احتمال وجود دارد:
  1. برای APIهایی که شناسه های سرویس گیرنده Maps Platform را می پذیرند : شناسه سرویس گیرنده Maps Platform برای بارگیری API استفاده شده است. به عنوان مثال، با استفاده از &client=gme-_mycompany_ .

    این APIها شناسه های مشتری را می پذیرند: Maps JavaScript API، Maps Static API، Street View Static API، Elevation API، Directions API، Distance Matrix API، Geocoding API، Time Zone API. برای اطلاعات بیشتر، به مدیریت شناسه مشتری طرح Premium مراجعه کنید.

  2. برای APIهایی که OAuth را می پذیرند : API با استفاده از OAuth بدون کلید API بارگیری شده است.

نمودارهای کد پاسخ

نمودارهای ترافیک بر اساس کد پاسخ و خطای کد پاسخ، استفاده را بر اساس کلاس کد پاسخ HTTP تقسیم می کنند. این جدول نگاشت بین وضعیت پاسخ API پلتفرم Google Maps و کلاس کد پاسخ HTTP را نشان می دهد:

وضعیت Maps API کلاس کد پاسخ HTTP - گزارش استفاده
(2xx، 3xx، 4xx، 5xx)
یادداشت
خوب 2xx پاسخ موفقیت آمیز

این یک درخواست قابل پرداخت است و سهمیه مصرف می کند.
خوب 3xx پاسخ موفقیت آمیز

این یک درخواست قابل پرداخت است و سهمیه را مصرف می کند.

به عنوان مثال، درخواست های موفق Place Photo، 302 را به تصویر ارجاع داده شده تغییر مسیر می دهد.
DATA_NOT_AVAILABLE 4xx ( 1 ) پاسخ موفقیت آمیز نشان می دهد که هیچ داده ای برای مکان های ورودی وجود ندارد.

این یک درخواست قابل پرداخت است و سهمیه را مصرف می کند.
ZERO_RESULTS 4xx ( 1 ) پاسخ موفقیت آمیز نتیجه ای نداشت.

این یک درخواست قابل پرداخت است و سهمیه را مصرف می کند.
پیدا نشد 4xx ( 1 ) برای Directions API ، این پیام نشان می‌دهد که حداقل یکی از مکان‌های مشخص‌شده در مبدأ، مقصد، یا ایستگاه‌های بین درخواست نمی‌تواند کد جغرافیایی شود.

برای Places API این پیام نشان می دهد که مکان ارجاع شده (place_id) در پایگاه داده Places یافت نشد.

این یک درخواست قابل پرداخت است و سهمیه را مصرف می کند.
INVALID_REQUEST (مقدار پارامتر نامعتبر)،
MAX_WAYPOINTS_EXCEEDED،
MAX_ROUTE_LENGTH_EXCEEDED و دیگران.
4xx خطای ناشی از مقدار پارامتر نامعتبر. برای جزئیات بیشتر، پاسخ API را بررسی کنید.

این یک درخواست قابل پرداخت است و سهمیه را مصرف می کند.
REQUEST_DENIED 4xx خطای مشتری ناشی از خطای احراز هویت، خطای دسترسی و موارد دیگر. برای جزئیات بیشتر، پاسخ API را بررسی کنید.
OVER_DAILY_LIMIT،
OVER_QUERY_LIMIT،
RESOURCE_EXHAUSTED،
حد نرخ بیش از،
روزانه محدودیت بیش از حد،
userRateLimitExceeded
4xx خطای مشتری ناشی از درخواست های بسیار زیاد در بازه زمانی مجاز است. درخواست را در فرصتی دیگر دوباره امتحان کنید. برای جزئیات بیشتر، پاسخ API را بررسی کنید.
INVALID_REQUEST (پارامتر نامعتبر یا مفقود، تجزیه درخواست یا خطای اعتبارسنجی) 4xx خطای مشتری ناشی از درخواست نامعتبر است. برای جزئیات بیشتر، پاسخ API را بررسی کنید.
NOT_FOUND (404) 4xx برای API مکان جغرافیایی ، این پیام نشان می‌دهد که ورودی‌ها برای تولید تخمین مکان کافی نبودند.

برای Roads API ، این پیام نشان می‌دهد که ورودی‌ها نمی‌توانند به طور منطقی به جاده‌ها متصل شوند.

این یک درخواست قابل پرداخت است و سهمیه را مصرف می کند.
خطای ناشناخته 5xx خطای سرور که نشان می‌دهد نمی‌توان به درخواست ادامه داد: خطای داخلی، بارگیری بیش از حد سرویس، در دسترس نبودن، پایان زمان و موارد دیگر.
1 برای بهبود سازگاری گزارش کد خطا، APIهای پلتفرم Google Maps در حال انتقال هستند: 1) از کد پاسخ HTTP کلاس 2xx به 4xx برای وضعیت‌های API Maps: DATA_NOT_AVAILABLE ، NOT_FOUND ، ZERO_RESULTS - status ، 2) از کد پاسخ HTTP به کلاس 4xx پاسخ HTTP 2xx برای وضعیت‌های Maps API: REQUEST_DENIED ، OVER_DAILY_LIMIT ، OVER_QUERY_LIMIT ، dailyLimitExceeded ، rateLimitExceeded ، userRateLimitExceeded ، 3) از وضعیت کد پاسخ HTTP کلاس 2xx تا 5xx UNKNOWN_ERROR برای Maps. شما می توانید هر دو کد پاسخ را در طول دوره انتقال ببینید. کدهای پاسخی که در پاسخ‌های Maps API برگردانده شده‌اند تغییر نمی‌کنند . با بررسی اینکه کدام کد پاسخ دقیق در Metrics Explorer افزایش می‌یابد (در مورد استفاده از Google Cloud Monitoring برای Google Maps Platform بیشتر بیاموزید ) تأیید کنید که افزایش 4xx و/یا 5xx در متریک‌های پلتفرم Google Maps مربوط به این انتقال است.

برای اطلاعات بیشتر در مورد کدهای وضعیت و پیام‌های خطا، به مستندات پاسخ برای API مورد علاقه خود (به عنوان مثال، پاسخ‌های کدگذاری جغرافیایی یا پاسخ‌های مسیرها ) مراجعه کنید.

پارامتر راه حل های پلتفرم نقشه های گوگل

پلتفرم نقشه‌های گوگل انواع مختلفی از کدهای نمونه را برای کمک به شما در راه‌اندازی و اجرای سریع ارائه می‌کند. برای مثال، می‌توانید از Quick Builder در Cloud Console استفاده کنید، دستورالعمل‌های پیاده‌سازی راه‌حل‌های صنعتی را دنبال کنید و از لبه‌های کد یاد بگیرید.

برای درک نحوه استفاده و راه‌های بهبود راه‌حل‌های ما، Google پارامتر query solution_channel را در فراخوانی‌های API برای جمع‌آوری اطلاعات در مورد استفاده از کد نمونه شامل می‌شود:

  • پارامتر query solution_channel به طور پیش فرض در کد نمونه راه حل گنجانده شده است.
  • پارامتر پرس و جو تجزیه و تحلیل را در هنگام اتخاذ راه حل به Google برمی گرداند تا کیفیت راه حل را در تکرارهای آینده بهبود بخشد.
  • می‌توانید با حذف پارامتر query solution_channel و مقدار آن از کد نمونه، انصراف دهید.
  • هیچ الزامی برای حفظ پارامتر وجود ندارد. حذف پارامتر پرس و جو تأثیری بر عملکرد ندارد.
  • پارامتر query فقط برای گزارش استفاده از کد نمونه استفاده می شود.
  • پارامتر پرس و جو جدا از هر گونه تجزیه و تحلیل و گزارش خاص API است. این بدان معناست که حذف پارامتر از کد نمونه راه حل، گزارش داخلی Maps JavaScript API را غیرفعال نمی کند.

گزارش های سهمیه ای

سهمیه‌ها محدودیت‌هایی را برای تعداد درخواست‌هایی که پروژه شما می‌تواند به APIهای پلتفرم Google Maps ارائه دهد تعیین می‌کند. درخواست ها را می توان به سه طریق محدود کرد: در روز، در دقیقه و هر کاربر در دقیقه. فقط درخواست‌های موفق و درخواست‌هایی که باعث خطای سرور می‌شوند در سهمیه حساب می‌شوند. درخواست‌هایی که احراز هویت ناموفق هستند در سهمیه حساب نمی‌شوند.

میزان استفاده از سهمیه در نمودارهای صفحه سهمیه در کنسول Cloud نمایش داده می شود و می توان آن را در درخواست ها در دقیقه گروه بندی کرد. محدودیت های فعلی سهمیه برای API های انتخاب شده در جداول زیر نمودارهای استفاده از سهمیه نمایش داده می شود.

برای دریافت مقدار سهمیه در دقیقه برای هر محصول GMP API، از این ماشین حساب استفاده کنید.

صفحه سهمیه نقشه های گوگل

صفحه Google Maps Quotas محدودیت‌های سهمیه و مصرف سهمیه را برای API خاصی که انتخاب کرده‌اید نشان می‌دهد.

نمودار استفاده از سهمیه در Google Cloud Console کل ترافیک کلیدهای API و شناسه مشتری شما را نشان می دهد. ترافیک شناسه مشتری نیز در نمودار Metrics در Cloud Console موجود است.

این صفحه فقط درخواست‌هایی را نشان می‌دهد که سهمیه مصرف می‌کنند: درخواست‌های موفق ( OK ، ZERO_RESULTS ، DATA_NOT_AVAILABLE ) و درخواست‌هایی که باعث خطای سرور می‌شوند ( NOT_FOUND ، INVALID_REQUEST/INVALID_VALUE (مقدار پارامتر نامعتبر)، UNKNOWN_ERROR ).

درخواست‌هایی که باعث خطاهای مشتری می‌شوند - احراز هویت، مجوز، و خطاهای آرگومان نامعتبر ( REQUEST_DENIED ، OVER_QUERY_LIMIT ، INVALID_REQUEST (پارامتر نامعتبر، خطای تجزیه درخواست)) - سهمیه را مصرف نمی‌کنند و نمایش داده نمی‌شوند.

واحد سهمیه درخواستی برای اکثر APIهای پلتفرم Google Maps (Maps Static API، Street View Static API، Geocoding API، Directions API، Places API، Time Zone API، Geolocation API، و Elevation API) است، اما چند استثنا وجود دارد. :

  • برای Distance Matrix API، واحد سهمیه عنصری است که یک جفت مبدا-مقصد است.
  • برای Maps JavaScript API، واحد سهمیه یک بارگذاری نقشه است.
  • برای Maps SDK برای Android و Maps SDK برای iOS، واحد سهمیه یک درخواست نمای خیابان یا بارگیری پانوراما است. بارهای نقشه بدون هزینه در دسترس هستند و سهمیه مصرف نمی کنند.

نماگرفت صفحه سهمیه Maps در Google Cloud Console. با استفاده از یک انتخابگر، سهمیه ها را بر اساس API نشان می دهد، سپس بارهای نقشه را نسبت به سهمیه های تعیین شده برای API مورد نظر نشان می دهد.

برای دسترسی به صفحه سهمیه های پلتفرم نقشه های گوگل:

  1. صفحه پلتفرم Google Maps را در کنسول Cloud باز کنید:

    به صفحه پلتفرم نقشه های گوگل بروید

  2. در منوی سمت چپ، Quotas را انتخاب کنید.
  3. یک API را از لیست کشویی API انتخاب کنید.

واحدهای سهمیه ای

این جدول واحد سهمیه برای APIهای پلتفرم Google Maps را نشان می دهد.

Google Maps Platform API واحد سهمیه
نقشه ها
Maps SDK برای اندروید 1 پانوراما
Maps SDK برای iOS 1 پانوراما
Map Tiles API 1 درخواست
Maps Aerial View API 1 درخواست
Maps Static API 1 درخواست
Maps JavaScript API 1 بارگذاری نقشه
API استاتیک نمای خیابان 1 درخواست
Maps Embed API 1 بارگذاری نقشه
مسیرها
Routes API (مسیرهای محاسبه) 1 درخواست
Routes API (متریس مسیر محاسبه) 1 عنصر (جفت مبدا-مقصد)
Directions API 1 درخواست
Distance Matrix API 1 عنصر (جفت مبدا-مقصد)
Roads API 1 درخواست
مکان ها
Places API 1 درخواست
Address Validation API 1 درخواست
API کدگذاری جغرافیایی 1 درخواست
API مکان جغرافیایی 1 درخواست
API منطقه زمانی 1 درخواست
محیط
API کیفیت هوا (شرایط کنونی و HeatmapTile) 1 درخواست
API کیفیت هوا (تاریخچه) 1 صفحه
Pollen API 1 درخواست
API خورشیدی 1 درخواست

گزارش های صورتحساب

گزارش صورتحساب خود را مشاهده کنید

گزارش‌های صورت‌حساب برای استفاده شما از محصولات پلتفرم Google Maps در Google Cloud Console موجود است. برای اطلاعات بیشتر، صورتحساب را ببینید.

برای دسترسی به گزارش های صورتحساب:

  1. صفحه انتخابگر پروژه را در Cloud Console باز کنید:

    صفحه انتخاب پروژه

  2. یک پروژه را انتخاب کنید.
  3. دکمه منو را انتخاب کنیدمنو و سپس Billing را انتخاب کنید.
  4. اگر چند حساب صورت‌حساب دارید، برو به حساب صورت‌حساب پیوندی را انتخاب کنید تا صفحه نمای کلی حساب صورت‌حساب مرتبط باز شود.
  5. در منوی سمت چپ، گزارش‌ها را انتخاب کنید تا صفحه گزارش‌های صورت‌حساب برای حساب صورت‌حساب مرتبط باز شود.

نحوه خواندن نمودار گزارش صورتحساب

گزارش صورت‌حساب، هزینه را در طول زمان به صورت نمودار خطی انباشته نشان می‌دهد. نمای پیش‌فرض هزینه‌های مصرف روزانه ماه جاری را به‌صورت گروه‌بندی شده بر اساس پروژه (برای همه محصولات)، شامل اعتبارات خاص استفاده، و همچنین کل هزینه‌های پیش‌بینی‌شده برای کل ماه جاری نمایش می‌دهد. هر خط در نمودار (و ردیف در جدول خلاصه) مربوط به پروژه است که از نظر هزینه از بزرگ ترین تا کوچکترین رتبه بندی شده است. درباره تفسیر نمودار گزارش صورتحساب بیشتر بیاموزید .

تصویری از گزارش صورت‌حساب که نمودار و جدول را با استفاده از نمای پیش‌تنظیمی نمایش می‌دهد
شکل 1: گزارش صورت‌حساب نمودار و جدول را با استفاده از نمای پیش‌تنظیمی نمایش می‌دهد.

نکته: استفاده و هزینه هر SKU را تجزیه و تحلیل کنید

برای درک دقیق‌تر جزئیات مدل قیمت‌گذاری پرداختی و نحوه تأثیر آن بر پیاده‌سازی شما، به استفاده و هزینه خود بر اساس SKU نگاه کنید.

گزارش صورت‌حساب گروه‌بندی شده توسط SKU
شکل 2: جدول صورتحساب که موارد استفاده و هزینه را بر اساس SKU نشان می دهد.
تصویری از فیلترهای گزارش صورتحساب
شکل 3: گزارش صورتحساب فیلتر می شود.
برای تغییر نمای گزارش برای نمایش موارد خط بر اساس SKU:
  1. در پانل سمت راست نمودار، گروه با فیلتر را گسترش دهید.
  2. SKU را انتخاب کنید.

سایر فیلترهای گزارش صورت‌حساب موجود عبارتند از محدوده زمانی ، پروژه‌ها ، محصولات ، SKUها و مکان‌ها که به شما امکان می‌دهد بر اساس جایی که درخواست‌های API از آنجا ارائه می‌شوند فیلتر کنید.

برای دسته بندی منبع استفاده خود علاوه بر محصول، گزارش صورتحساب را بر اساس یکی از مقادیر فهرست شده گروه بندی کنید. سه کلید مربوط به API های پلتفرم نقشه های گوگل عبارتند از goog-maps-api-key-fiffix (چهار کاراکتر آخر یک کلید API)، goog-maps-platform-type (پلتفرم: Android، iOS، JavaScript یا webservice) و goog-maps-channel (یک مقدار کانال عددی تنظیم شده از یک جستار API). اطلاعات بیشتر در مورد فیلتر کردن و گروه بندی .

می‌توانید نمای نمودار را تغییر دهید تا اعتبارات مربوط به استفاده را حذف کنید.

نظارت و محدود کردن مصرف

برای کمک به برنامه ریزی بودجه و کنترل هزینه ها، می توانید موارد زیر را انجام دهید:

  • یک هشدار بودجه تنظیم کنید تا نحوه افزایش هزینه‌هایتان را به سمت یک مقدار خاص پیگیری کنید. تنظیم بودجه استفاده از API را محدود نمی‌کند، تنها زمانی به شما هشدار می‌دهد که میزان هزینه‌تان به مقدار مشخص‌شده نزدیک شود.
  • استفاده روزانه API خود را محدود کنید تا هزینه استفاده از APIهای قابل پرداخت را مدیریت کنید. با تعیین سقف برای درخواست ها در روز ، می توانید هزینه های خود را محدود کنید. از یک معادله ساده برای تعیین سقف روزانه خود بسته به مقداری که می خواهید خرج کنید استفاده کنید. به عنوان مثال: (هزینه ماهانه / قیمت برای هر SKU) / 30 = سقف درخواست در روز (برای یک API).

ردیابی استفاده در هر کانال

برای پیگیری استفاده خود از طریق کانال های عددی، باید پارامتر "channel" را به درخواست های API خود اضافه کنید. تنها مقادیر قابل قبول کانال اعداد 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- کلید منعکس می‌شوند.

فیلتر بر اساس برچسب ها
شکل 4: فیلتر بر اساس SKU و کانال ها
برای فیلتر کردن گزارش صورتحساب بر اساس SKU و کانال
  1. از فیلتر Group by SKU استفاده کنید.
  2. Caret Labels را انتخاب کنید.
  3. منوی کشویی Key را انتخاب کنید و goog-maps-channel را انتخاب کنید.
  4. منوی کشویی Value را انتخاب کنید و کانال های عددی را که می خواهید فیلتر کنید انتخاب کنید.

برای مشاهده هزینه‌های ایجاد شده توسط هر کانال، کلید goog-maps-channel را بر اساس برچسب گروه‌بندی کنید.

هنگامی که داده‌های استفاده از کانال را در درخواست‌های خود اعمال کردید، ممکن است تاخیر کوتاهی (تا 24 ساعت) قبل از منعکس شدن داده‌ها در گزارش صورت‌حساب شما وجود داشته باشد.

داده های صورتحساب خود را با BigQuery صادر کنید

همچنین می‌توانید داده‌های صورت‌حساب خود را به BigQuery صادر کنید .

BigQuery Export به شما امکان می‌دهد تا داده‌های Cloud Billing (مانند داده‌های استفاده و برآورد هزینه) را به‌طور خودکار در طول روز به مجموعه داده BigQuery که مشخص می‌کنید صادر کنید. سپس می توانید برای تجزیه و تحلیل دقیق به داده های صورتحساب خود از BigQuery دسترسی داشته باشید. این یک لایه جزئیات اضافی در درک منبع استفاده از پلتفرم Google Maps شما می دهد.

اگر می‌خواهید صادرات BigQuery و جست‌وجو درباره داده‌ها را شروع کنید، می‌توانید پرس و جوی نمونه زیر را امتحان کنید. قبل از اجرای این پرس و جو، باید:

  • صدور صورت‌حساب و BigQuery را در حساب خود فعال کنید.
  • قالب جدول PROJECT_ID است. DATASET_NAME .gcp_billing_export نسخه 1 BILLING_ACCOUNT_ID که در آن:
    • PROJECT_ID شناسه واقعی پروژه شما است (به عنوان مثال "my-project-123456").
    • DATASET_NAME نام مجموعه داده ای است که ایجاد کرده اید (به عنوان مثال "SampleDataSet").
    • BILLING_ACCOUNT_ID مرجع شناسه حساب صورت‌حساب شما است که با پیشوند "gcp_billing_export v1 " و تغییر خط تیره (-) به زیرخط (_) است. برای مثال، شناسه حساب صورت‌حساب 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
  

صورت‌حساب ابری:

پلتفرم نقشه های گوگل:

وضعیت پاسخ و گزارش

جدول زیر نگاشت بین وضعیت Maps API، کد پاسخ HTTP بازگشتی در پاسخ‌های Maps API و کلاس کد پاسخ HTTP در گزارش استفاده را نشان می‌دهد و نشان می‌دهد که آیا درخواست مربوطه در گزارش‌های استفاده، سهمیه و صورت‌حساب ظاهر می‌شود یا خیر.

گزارش استفاده در متریک های پلتفرم نقشه های گوگل، جزئیات HTTP response code class را ارائه می دهد. اگر به سطح بالاتری از جزئیات نیاز دارید، کدهای وضعیت پاسخ موجود در نظارت بر استفاده از پلتفرم Google Maps را ببینید.

کدهای پاسخ موجود در پاسخ‌های Maps API در گزارش استفاده موجود است گزارش شده به
وضعیت Maps API کد پاسخ HTTP کلاس کد پاسخ HTTP استفاده سهمیه، سهم صورتحساب
خوب 200،
204،
302
2xx،
3xx
آره آره آره
DATA_NOT_AVAILABLE،
پیدا نشد،
ZERO_RESULTS
200،
404
4xx 1 آره آره آره
INVALID_REQUEST (مقدار پارامتر نامعتبر)،
MAX_ROUTE_LENGTH_EXCEEDED،
MAX_WAYPOINTS_EXCEEDED،
و غیره.
200،
400
4xx آره آره آره
INVALID_REQUEST (پارامتر نامعتبر/فقدان، خطای تجزیه درخواست) 200،
400
4xx آره خیر خیر
REQUEST_DENIED 200،
400،
403
4xx 1 آره خیر خیر
OVER_DAILY_LIMIT،
OVER_QUERY_LIMIT،
RESOURCE_EXHAUSTED،
روزانه محدودیت بیش از حد،
حد نرخ بیش از،
userRateLimitExceeded
200،
403،
429
4xx 1 آره خیر خیر
خطای ناشناخته 200،
500،
503
5xx 1 آره آره خیر
1 برای بهبود سازگاری گزارش کد خطا، APIهای پلتفرم Google Maps در حال انتقال هستند: 1) از کد پاسخ HTTP کلاس 2xx به 4xx برای وضعیت‌های API Maps: DATA_NOT_AVAILABLE ، NOT_FOUND ، ZERO_RESULTS - status ، 2) از کد پاسخ HTTP به کلاس 4xx پاسخ HTTP 2xx برای وضعیت‌های Maps API: REQUEST_DENIED ، OVER_DAILY_LIMIT ، OVER_QUERY_LIMIT ، dailyLimitExceeded ، rateLimitExceeded ، userRateLimitExceeded ، 3) از وضعیت کد پاسخ HTTP کلاس 2xx تا 5xx UNKNOWN_ERROR برای Maps. شما می توانید هر دو کد پاسخ را در طول دوره انتقال ببینید. کدهای پاسخی که در پاسخ‌های Maps API برگردانده شده‌اند تغییر نمی‌کنند . با بررسی اینکه کدام کد پاسخ دقیق در Metrics Explorer افزایش می‌یابد (در مورد استفاده از Google Cloud Monitoring برای Google Maps Platform بیشتر بیاموزید ) تأیید کنید که افزایش 4xx و/یا 5xx در متریک‌های پلتفرم Google Maps مربوط به این انتقال است.

گزارش های نامزدی

بینش کسب و کار

پلتفرم نقشه های گوگل به شما اطلاعاتی درباره نحوه تعامل کاربران با نقشه های شما می دهد. این بینش‌ها شامل معیارهای کلیدی تعامل مانند نماها روی نقشه یا تعامل با یک POI است. می‌توانید این بینش‌ها را برای کشف مکان‌های محبوب برای تبلیغات و بازاریابی یا بهینه‌سازی تجربه کاربری خود تجزیه و تحلیل کنید.

قابلیت‌های گزارش بینش تجاری عبارتند از:

  • مشاهده یک عکس فوری از اطلاعات کسب و کار در سطح بالا برای مشاهده روندهای کلیدی در بینش کسب و کار در یک نگاه
  • برای تجزیه و تحلیل یک معیار خاص در کنسول به منظور بررسی دقیق معیارها با جزئیات بیشتر تلاش کنید.
  • در حال صادر کردن معیارها به CSV تا بتوانید داده های بینش کسب و کار را در ابزار تجزیه و تحلیل کسب و کار مورد علاقه خود تجزیه و تحلیل کنید

معیارهای تعامل موجود عبارتند از:

  • نماهای نقشه: نماهای روی نقشه را که از حرکت، زوم یا کج شدن به دست می‌آیند، ردیابی کنید. نمای نقشه با کد پستی به صورت هفتگی (از یکشنبه تا شنبه به وقت اقیانوس آرام) محاسبه می شود. داده های جدید هر هفته در اولین چهارشنبه پس از دوره مشاهده منتشر می شود.

کاربران می توانند اطلاعات آماری کسب و کار را در صفحه متریک در کنسول Cloud مشاهده کنند. Map Views در حال حاضر فقط برای برخی از توسعه دهندگان Maps JS API برای آزمایش در دسترس است.

می‌توانید معیارهای تعامل را مستقیماً در کنسول با قابلیت‌های Filter و Group By تجزیه و تحلیل کنید تا با جزئیات بیشتر به معیارها بپردازید. به عنوان مثال، ممکن است انتخاب کنید که بر اساس یک منطقه خاص فیلتر کنید تا بدانید چگونه نماهای نقشه تنها برای کدهای پستی در آن منطقه روند رو به رشد دارند. از سوی دیگر، ممکن است بخواهید بر اساس یک منطقه خاص گروه بندی کنید تا تعاملات درون آن منطقه را جمع آوری کنید.

کاربران می توانند کل مجموعه داده یا یک نمای فیلتر شده را به CSV صادر کنند تا در ابزار تجزیه و تحلیل کسب و کار مورد علاقه شما تجزیه و تحلیل کنند. می‌توانید تا 90 روز در هر بار دانلود کنید و دانلودهای بیشتر از 60 هزار سلول کوتاه می‌شوند. بسته به محدوده زمانی انتخابی، صادر کردن داده‌های نماهای نقشه به CSV ممکن است چند دقیقه طول بکشد.

صادرات بینش تجاری

معیارهای بینش کسب و کار ناشناس هستند و بنابراین فقط روندهای کلی در تعامل با نقشه های شما را منعکس می کنند. ممکن است تعداد کم به صفر گرد شود و مشارکت‌های پرت ممکن است کاهش یابد.

با استفاده از مجوز Maps Analytics می‌توانید دسترسی به اطلاعات آماری کسب‌وکار را برای پروژه Cloud خود در Google Cloud Console کنترل کنید. به صاحبان پروژه به طور پیش فرض این مجوز اعطا می شود و می توانند در صورت نیاز دسترسی به سایر کاربران را فراهم کنند.

اطلاعات بینش تجاری نباید برای تخمین هزینه های استفاده شما استفاده شود. لطفاً برای اطلاعات بیشتر در مورد استفاده به گزارش های استفاده مراجعه کنید.

مکان یاب پلاس

برای کاربران Locator Plus، یک داشبورد تجزیه و تحلیل به شما کمک می کند تا اطلاعات خود را تجزیه و تحلیل کرده و بینش ایجاد کنید، و تصویر واضحی از تعامل خریداران شما با مکان یاب فروشگاه شما ارائه می دهد. می‌توانید عملکرد خود را در هفته اندازه‌گیری کنید، از جمله تعداد بازدیدها، تعداد تعاملات با جستجو و جزئیات مکان، و میزان مشارکت کلی. علاوه بر این، داشبورد معیارهای مهمی را در مورد نحوه مقایسه اجرای شما با سایر خرده فروشان ارائه می دهد.

  • در Google Cloud Console به Locator Plus بروید.
  • برای مشاهده داشبورد تجزیه و تحلیل، به بخش Engagement Reports در Google Cloud Console بروید.

گزارش معیار به شما امکان می دهد داده های خود را با داده های صنعت جمع آوری شده از سایر شرکت هایی که داده های خود را به اشتراک می گذارند مقایسه کنید. این مقایسه زمینه ارزشمندی را فراهم می‌کند و به شما کمک می‌کند تا اهداف معنی‌داری را تعیین کنید، بینشی در مورد روندهای صنعت به دست آورید و دریابید که در مقایسه با رقبایتان چگونه عمل می‌کنید.

برای مشاهده داده‌های معیار، داده‌های تعامل شما به‌طور ناشناس در معیارهای Google گنجانده می‌شود. برای انصراف از مشاهده و گنجاندن داده‌های مشارکت خود به‌صورت ناشناس در گزارش‌های معیار، یک بلیط پشتیبانی ارسال کنید. تیکت پشتیبانی به طور کلی ظرف 3 روز حل می شود.