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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

توجه: وقتی نام هر API فعالی را انتخاب می‌کنید، به صفحه Google Maps Metrics مربوط به آن API هدایت می‌شوید.

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

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

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

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

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

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

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

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

توجه: گزینه Platform and Domain در لیست کشویی Grouped by و فیلترهای Platform and Domain فقط زمانی ظاهر می شوند که یک API منفرد از لیست کشویی انتخاب API انتخاب شده باشد.

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

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

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

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

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

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

نمودارهای ترافیک بر اساس کد پاسخ و خطای کد پاسخ، استفاده را بر اساس کلاس کد پاسخ 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 4xx : DATA_NOT_AVAILABLE ، NOT_FOUND ، ZERO_RESULTS - status ، 2) از کد پاسخ 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، واحد سهمیه یک درخواست نمای خیابان/بارگیری پانوراما است (بارگیری‌های نقشه بدون هزینه در دسترس هستند و سهمیه مصرف نمی‌کنند).

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

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

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

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

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

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

Google Maps Platform API	واحد سهمیه
نقشه ها
Maps SDK برای اندروید	1 پانوراما
Maps SDK برای iOS	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 درخواست

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

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

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

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

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

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

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

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

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

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

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

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

شکل 2: جدول صورتحساب که موارد استفاده و هزینه را بر اساس SKU نشان می دهد.

شکل 3: گزارش صورتحساب فیلتر می شود.

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

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

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

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

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

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

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

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

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

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

توجه: در حال حاضر، داده‌های کانال برای جاده‌ها - SKU طی مسیر، جاده‌ها - SKU نزدیک‌ترین جاده، جاده‌ها - SKU محدودیت‌های سرعت، Maps SDK برای Android و Maps SDK برای iOS در دسترس نیست.

شکل 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 تبدیل می‌شود.

توجه: هنگامی که یک DataSet جدید ایجاد می کنید، بلافاصله در رابط ظاهر می شود، اما Table to query هنوز ظاهر نمی شود. جدول پس از چند ساعت به طور خودکار ایجاد می شود. سپس حدود 24 ساعت طول می کشد تا داده های شما را مشاهده کنید. مجموعه داده BigQuery شما فقط داده‌های استفاده و هزینه را نشان می‌دهد که از تاریخی که صدور صورت‌حساب را راه‌اندازی کرده‌اید و پس از آن ایجاد شده است. به عبارت دیگر، داده‌های صورت‌حساب به صورت ماسبق اضافه نمی‌شوند، بنابراین، قبل از فعال کردن صادرات BigQuery، داده‌های صورت‌حساب را نخواهید دید.

  #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 در گزارش استفاده را نشان می‌دهد و نشان می‌دهد که آیا درخواست مربوطه در گزارش‌های استفاده، سهمیه و صورت‌حساب ظاهر می‌شود یا خیر.

توجه: به دلایل تاریخی، کد پاسخ HTTP که در پاسخ به درخواست‌های API پلتفرم Google Maps بازگردانده می‌شود، می‌تواند با کد پاسخ HTTP در گزارش‌های استفاده متفاوت باشد ( سنجش‌های پلتفرم نقشه‌های Google ). معیارهای Usage Reports از مجموعه ای از مقادیر کد پاسخ استفاده می کنند که با مقادیر مورد استفاده در API های جدید سازگار است. این قابلیت مشاهده استفاده از APIها را در متریک های پلتفرم نقشه های گوگل و نظارت بر پلتفرم نقشه های گوگل بهبود می بخشد.

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

کدهای پاسخ موجود در پاسخ‌های Maps API		در گزارش استفاده موجود است	گزارش شده به
وضعیت Maps API	کد پاسخ HTTP	کلاس کد پاسخ HTTP	استفاده	سهمیه، سهم	صورتحساب
خوب	200، 204، 302	2xx، 3xx	آره	آره	آره
DATA_NOT_AVAILABLE، پیدا نشد، ZERO_RESULTS	200	4xx ^1	آره	آره	آره
NOT_FOUND (API های استاتیک نمای خیابان، موقعیت جغرافیایی و جاده ها)، ZERO_RESULTS (API استاتیک نمای خیابان)	404	4xx	آره	آره	آره
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 4xx : DATA_NOT_AVAILABLE ، NOT_FOUND ، ZERO_RESULTS - status ، 2) از کد پاسخ 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 با این انتقال مرتبط است.

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

این محصول یا ویژگی آزمایشی (قبل از GA) است. محصولات و ویژگی‌های Pre-GA ممکن است پشتیبانی محدودی داشته باشند، و تغییرات در محصولات و ویژگی‌های pre-GA ممکن است با سایر نسخه‌های pre-GA سازگار نباشد. پیشنهادات قبل از GA تحت پوشش شرایط خاص سرویس پلتفرم 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، یک داشبورد تجزیه و تحلیل به شما کمک می کند تا اطلاعات خود را تجزیه و تحلیل کرده و بینش ایجاد کنید، و تصویر واضحی از تعامل خریداران شما با مکان یاب فروشگاه شما ارائه می دهد. می‌توانید عملکرد خود را در هفته اندازه‌گیری کنید، از جمله تعداد بازدیدها، تعداد تعاملات با جستجو و جزئیات مکان، و میزان مشارکت کلی. علاوه بر این، داشبورد معیارهای مهمی را در مورد نحوه مقایسه اجرای شما با سایر خرده فروشان ارائه می دهد.

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

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

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