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

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

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

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

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

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

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

استفاده بر اساس تعداد درخواست‌هایی است که پروژه شما با استفاده از اعتبارنامه‌های مرتبط با پروژه شما به 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 روز گذشته، میزان مصرف نمایش داده شده در نمودارها و جداول را فیلتر کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

صفحه Google Maps Platform APIs & Services

صفحه Google Maps APIs & Services شامل شبکه‌ای از کاشی‌ها است که نمایانگر APIها، SDKها و سایر سرویس‌های موجود برای پروژه شما است. در هر کاشی، می‌توانید با انتخاب فعال یا غیرفعال کردن ، آن سرویس را فعال یا غیرفعال کنید و می‌توانید به اطلاعات اعتبار، معیارها و راهنمای کاربر برای APIهای فعال دسترسی داشته باشید. همچنین می‌توانید از فیلترهای صفحه برای مشاهده سرویس‌های فعال یا غیرفعال و سایر دسته‌های خدمات استفاده کنید.

برای دسترسی به صفحه Google Maps Platform APIs & Services:

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

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

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

صفحه اندازه گیری نقشه های گوگل

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

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

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

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

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

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

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

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

گزارش اعتبار

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

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

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

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

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

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

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

برای درک نحوه استفاده و راه‌های بهبود راه‌حل‌های ما، 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 کل ترافیک کلیدهای API و شناسه مشتری شما را نشان می دهد. ترافیک شناسه مشتری نیز در نمودار Metrics در کنسول Cloud موجود است.

این صفحه فقط درخواست‌هایی را نشان می‌دهد که سهمیه مصرف می‌کنند: درخواست‌های موفق ( 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 (Legacy)، Places API، Time Zone API، Geolocation API و Elevation API) است، اما چند استثنا وجود دارد:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

برای تغییر نمای گزارش برای نمایش موارد خط بر اساس SKU:

1. در پانل سمت راست نمودار، گروه با فیلتر را گسترش دهید.
2. SKU را انتخاب کنید.

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

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

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

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

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

• بودجه تعیین کنید

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

• API روزانه خود را درپوش بگذارید

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

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

برای ردیابی استفاده خود با استفاده از کانال های عددی، باید پارامتر "channel" را به درخواست های API خود اضافه کنید. تنها مقادیر قابل قبول کانال اعداد 0-999 هستند. در اینجا چند نمونه آورده شده است:

• API وب سرویس کدگذاری جغرافیایی

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• Maps JavaScript API

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

استفاده از کانال خود را مستقیماً در گزارش صورتحساب خود نظارت کنید. استفاده از کانال در زیر برچسب‌ها به عنوان goog-maps-channel کلیدی است.

برای فیلتر کردن گزارش صورتحساب بر اساس SKU و کانال

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
  

منابع مرتبط

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

• حساب Cloud Billing خود را ایجاد، تغییر دهید یا ببندید
• تنظیمات صورتحساب پروژه را تغییر دهید
• گزارش های صورتحساب و روند هزینه خود را مشاهده کنید
• بودجه و هشدارهای بودجه را تنظیم کنید
• درپوش استفاده از API

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

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

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

گزارش استفاده در معیارهای پلتفرم Google Maps

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

موجود در Google Maps Platform Usage monitoring .

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

بینش کسب و کار

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

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

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

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

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

صاحبان پروژه و کاربران با نقش Maps Analytics Viewer می‌توانند اطلاعات کسب‌وکار را در صفحه متریک در Cloud Console مشاهده کنند. پروژه باید دارای Maps JavaScript API فعال باشد.

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

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

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

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

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

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

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

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

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

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

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

استفاده بر اساس تعداد درخواست‌هایی است که پروژه شما با استفاده از اعتبارنامه‌های مرتبط با پروژه شما به 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 روز گذشته، میزان مصرف نمایش داده شده در نمودارها و جداول را فیلتر کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

صفحه Google Maps Platform API ها و خدمات

صفحه API & Services Google Maps شامل شبکه ای از کاشی ها است که به نمایندگی از API ها ، SDK ها و سایر خدمات موجود در پروژه شما است. در هر کاشی ، می توانید با انتخاب فعال یا غیرفعال ، آن سرویس را فعال یا غیرفعال کنید و می توانید به اطلاعات ، معیارها و راهنماهای کاربر برای API های فعال دسترسی پیدا کنید. همچنین می توانید از فیلترهای صفحه برای مشاهده خدمات فعال یا غیرفعال و سایر دسته های خدمات استفاده کنید.

برای دسترسی به صفحه API & Services Platform Google Maps:

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

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

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

صفحه معیارهای Google Maps

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

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

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

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

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

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

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

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

گزارش اعتبار

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

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

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

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

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

Google Maps Platform Parameter پارامتر

Google Maps Platform انواع مختلفی از کد نمونه را برای کمک به شما در خواب سریع و سریع کار می کند. به عنوان مثال ، می توانید از Builder Quick در کنسول ابری استفاده کنید ، راهنماهای اجرای راه حل های صنعت را دنبال کنید و از CodeLabs یاد بگیرید.

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

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

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

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

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

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

صفحه سهمیه نقشه های Google

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

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

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

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

واحد سهمیه درخواستی برای اکثر API های پلت فرم Google Maps (نقشه های API استاتیک ، API استاتیک خیابان ، API Geocoding ، API (میراث) ، API مکان ، API منطقه زمانی ، API جغرافیایی و API ارتفاع) است ، اما برخی استثنائات وجود دارد:

• برای API ماتریس مسافت (میراث) ، واحد سهمیه عنصری است که یک جفت تخلیه مبدا است.
• برای نقشه های JavaScript API ، واحد سهمیه بار نقشه است.
• برای نقشه های SDK برای Android و SDK برای iOS ، واحد سهمیه یک درخواست نمای خیابان یا بار پانوراما است. بارهای نقشه بدون هیچ هزینه ای در دسترس هستند و سهمیه مصرف نمی کنند.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

برای درک دقیق تر جزئیات مدل قیمت گذاری Pay-As-You-Go و چگونگی تأثیر آن بر اجرای شما ، به استفاده و هزینه خود توسط SKU نگاه کنید.

برای تغییر نمای گزارش برای نمایش موارد خط توسط SKU:

1. در پانل سمت راست نمودار ، گروه را با فیلتر گسترش دهید.
2. SKU را انتخاب کنید.

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

برای طبقه بندی منبع استفاده شما علاوه بر محصول ، گزارش های صورتحساب گروهی توسط یکی از مقادیر ذکر شده را گزارش می کند. سه کلید مربوط به API های Google Maps Platform API های Goog-Maps-API-Key-S-S-Soffix (چهار کاراکتر نهایی یک کلید API) ، Goog-Maps-Platform-Type (پلت فرم: Android ، iOS ، JavaScript یا WebService) و کانال Goog-Maps (یک مقدار کانال عددی مجموعه ای از یک پرس و جو API) است. اطلاعات بیشتر در مورد فیلتر و گروه بندی .

شما می توانید با پاک کردن اعتبار شامل اعتبار در کادر انتخاب هزینه در پانل سمت راست ، نمودار را تغییر دهید تا اعتبار خاص استفاده را حذف کنید.

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

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

• بودجه تعیین کنید

  هشدار ، برای پیگیری چگونگی رشد هزینه شما به سمت یک مقدار خاص. بودجه استفاده از API را ندارد ، فقط وقتی مبلغ هزینه شما به مبلغ مشخص شده نزدیک می شود ، به شما هشدار می دهد.

• API روزانه خود را درپوش کنید

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

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

برای ردیابی استفاده خود با استفاده از کانال های عددی ، باید پارامتر "کانال" را به درخواست های API خود اضافه کنید. تنها مقادیر قابل قبول کانال اعداد از 0-999 است. در اینجا چند نمونه آورده شده است:

• API سرویس وب GeoCoding

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• نقشه API JavaScript

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

مصرف کانال خود را مستقیماً در گزارش صورتحساب خود کنترل کنید. استفاده از کانال به عنوان کانال اصلی GOOG-MAPS تحت برچسب است.

برای فیلتر کردن گزارش صورتحساب خود توسط SKU و کانال

1. از گروه توسط SKU Filter استفاده کنید.
2. CARET LABELS را انتخاب کنید.
3. از پایین کشویی ، کانال Goog-Maps را انتخاب کنید.
4. از پایین کشویی ، کانال های عددی مورد نظر برای فیلتر کردن را انتخاب کنید.

برای دیدن هزینه های تولید شده توسط هر کانال ، گروه توسط Label Key Goo-Maps-Channel برای دیدن گروه.

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

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

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

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

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

• صادرات صورتحساب و BigQuery را در حساب خود فعال کنید.
• قالب جدول PROJECT_ID است. DATASET_NAME .gcp_billing_export v1 BILLING_ACCOUNT_ID کجا:
• PROJECT_ID شناسه پروژه واقعی شماست (به عنوان مثال "My-Project-123456").
• DATASET_NAME نام مجموعه داده ای است که شما ایجاد کرده اید (به عنوان مثال "نمونه برداری").
• 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
  

منابع مرتبط

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

• حساب صورتحساب ابر خود را ایجاد ، اصلاح یا بسته کنید
• تنظیمات صورتحساب یک پروژه را اصلاح کنید
• گزارش های صورتحساب و روند هزینه خود را مشاهده کنید
• بودجه و هشدارهای بودجه را تعیین کنید
• استفاده از API استفاده از API

• Google Maps صورتحساب پلتفرم
• راهنمای بهینه سازی
• بهترین روشهای اصلی API

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

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

گزارش استفاده در معیارهای پلت فرم Google Maps

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

موجود در نظارت بر استفاده از پلت فرم Google Maps .

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

بینش کسب و کار

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

قابلیت گزارش های بینش تجاری شامل موارد زیر است:

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

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

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

صاحبان پروژه و کاربران با نقش بیننده Maps Analytics می توانند بینش تجاری در صفحه معیارها در کنسول ابری را مشاهده کنند. این پروژه باید دارای نقشه های API JavaScript باشد.

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

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

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

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

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