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

با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

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

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

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

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

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

نظارت بر 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 را انتخاب کنید.

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

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

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

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

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

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

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

این یک درخواست قابل پرداخت است و سهمیه را مصرف می کند.
پیدا نشد 2xx/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 در حال انتقال ( وضعیت ) از کد پاسخ HTTP کلاس 2xx به 4xx برای وضعیت‌های Maps API هستند: DATA_NOT_AVAILABLE ، NOT_FOUND ، ZERO_RESULTS . شما می توانید هر دو کد پاسخ را در طول دوره انتقال ببینید. کدهای پاسخی که در پاسخ‌های Maps API برگردانده شده‌اند تغییر نمی‌کنند . با بررسی اینکه کدام کد پاسخ دقیق در Metrics Explorer افزایش می‌یابد (در مورد استفاده از Google Cloud Monitoring برای پلتفرم Google Maps بیشتر بیاموزید ) تأیید کنید که افزایش 4xx در متریک‌های پلتفرم 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 پانوراما
Maps Static API 1 درخواست
Maps JavaScript API 1 بارگذاری نقشه
API استاتیک نمای خیابان 1 درخواست
Maps Embed 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 نگاه کنید.

گزارش صورت‌حساب گروه‌بندی شده توسط 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- کلید منعکس می‌شوند.

فیلتر بر اساس برچسب ها
شکل 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 2xx/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/403 4xx آره خیر خیر
OVER_DAILY_LIMIT،
OVER_QUERY_LIMIT،
RESOURCE_EXHAUSTED،
روزانه محدودیت بیش از حد،
حد نرخ بیش از،
userRateLimitExceeded
200/403،
429
4xx آره خیر خیر
خطای نامشخص 200/500،
503
5xx آره آره خیر
1 برای بهبود سازگاری گزارش کد خطا، APIهای پلتفرم Google Maps در حال انتقال ( وضعیت ) از کد پاسخ HTTP کلاس 2xx به 4xx برای وضعیت‌های Maps API هستند: DATA_NOT_AVAILABLE ، NOT_FOUND ، ZERO_RESULTS . شما می توانید هر دو کد پاسخ را در طول دوره انتقال ببینید. کدهای پاسخی که در پاسخ‌های Maps API برگردانده شده‌اند تغییر نمی‌کنند . با بررسی اینکه کدام کد پاسخ دقیق در Metrics Explorer افزایش می‌یابد (در مورد استفاده از Google Cloud Monitoring برای پلتفرم Google Maps بیشتر بیاموزید ) تأیید کنید که افزایش 4xx در متریک‌های پلتفرم Google Maps مربوط به این انتقال است.

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

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

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

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

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