إعداد تقارير "منصة خرائط Google"

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يوفّر إعداد التقارير في "منصة خرائط Google" مجموعة من التقارير المرئية المحدّدة مسبقًا والتي تتيح لك الاطّلاع بسهولة على المعلومات الأساسية لاستخدام واجهة برمجة التطبيقات والحصص ومعلومات الفوترة في Google Cloud Console. يمكنك تحديد عدد طلبات البيانات من واجهة برمجة التطبيقات بسرعة، ومدى اقترابك من الوصول إلى حصص استخدام واجهة برمجة التطبيقات، ومراقبة استخدام الفوترة بمرور الوقت.

تشمل أنواع التقارير ما يلي:

  • تقارير الاستخدام: تقدّم هذه التقارير تقارير عن عدد الطلبات التي يجريها مشروعك إلى واجهات برمجة التطبيقات على "منصة خرائط Google" باستخدام بيانات الاعتماد المرتبطة بمشروعك.
  • تقارير الحصة: استخدام حصة التقارير في الرسوم البيانية التي يمكن تجميعها في طلبات في الدقيقة. يتم عرض حدود الحصة الحالية لواجهات برمجة التطبيقات المحدّدة في الجداول أسفل الرسوم البيانية لاستخدام الحصة.
  • تقارير الفوترة: لعرض التكاليف على مدار الوقت كرسم بياني خطي مكدّس. يمكنك استخدام حصة الحصة للشهر الحالي، بما في ذلك أي أرصدة مخصّصة للاستخدام، بالإضافة إلى إجمالي التكلفة المتوقّعة للشهر الحالي بأكمله.
  • تقارير التفاعل: تعرض عدد مرات المشاهدة والتفاعلات ونسبة التفاعل مع الموقع الجغرافي لمستخدمي Locator Plus.

اطّلِع على حالة الرد والتقارير أدناه للحصول على قائمة كاملة بحالات الاستجابة ورموز الاستجابة التي تحدِّد ما إذا كان الطلب سيظهر في تقارير الاستخدام و/أو الحصة و/أو الفوترة.

يمكنك عرض تقارير استخدام "منصة خرائط Google" وحصتها والفوترة باستخدام Cloud Console.

تقارير الاستخدام

يستند الاستخدام إلى عدد الطلبات التي يقدّمها مشروعك إلى واجهات برمجة التطبيقات في "منصة خرائط Google" باستخدام بيانات الاعتماد المرتبطة بمشروعك. وتتضمن الطلبات الطلبات الناجحة، والطلبات التي تؤدي إلى حدوث أخطاء في الخادم، والطلبات التي تؤدي إلى حدوث أخطاء في البرنامج. تشمل بيانات الاعتماد مفاتيح واجهة برمجة التطبيقات وأرقام تعريف العملاء (للخطط المميّزة ومشروعات الخطة المميّزة التي تم نقلها).

يتم عرض مقاييس الاستخدام في الجداول (الطلبات والأخطاء ووقت الاستجابة) والرسوم البيانية (الزيارات والأخطاء وزمن الاستجابة). لأغراض التتبّع:

  • يمكن فلترة مقاييس الاستخدام لكل واجهات برمجة التطبيقات حسب الفترة الزمنية وواجهة برمجة التطبيقات، ويمكنك أيضًا الاطّلاع على عدد الزيارات والخطأ ووقت الاستجابة مجمّعة حسب رمز الاستجابة وواجهة برمجة التطبيقات وبيانات الاعتماد.
  • يمكن فلترة مقاييس الاستخدام لواجهة برمجة تطبيقات معيَّنة حسب الفترة الزمنية وإصدارات واجهة برمجة التطبيقات وبيانات الاعتماد والطُرق، ويمكنك أيضًا الاطّلاع على عدد الزيارات والخطأ ووقت الاستجابة مجمّعة حسب رمز الاستجابة وطريقة واجهة برمجة التطبيقات وإصدارها وبيانات الاعتماد.

صفحة لوحة بيانات واجهات برمجة التطبيقات والخدمات

تقدّم صفحة لوحة البيانات الخاصة بواجهات برمجة التطبيقات والخدمات نظرة عامة على مقاييس الاستخدام لجميع واجهات برمجة التطبيقات التي تمّ تفعيلها لمشروعك (واجهات برمجة التطبيقات على "منصة خرائط Google" بالإضافة إلى واجهات برمجة التطبيقات والخدمات الأخرى).

تعرض صفحة لوحة البيانات ثلاثة رسوم بيانية وجدولًا. يمكنك فلترة الاستخدام المعروض في الرسوم البيانية والجداول عن طريق اختيار فترة زمنية (من ساعة واحدة حتى آخر 30 يومًا).

يعرض الرسم البياني لعدد الزيارات الاستخدام في طلبات البحث في الثانية (QPS) لكل واجهة برمجة تطبيقات. يعرض الرسم البياني للأخطاء النسبة المئوية للطلبات التي أدت إلى أخطاء في كل واجهة برمجة تطبيقات. يعرض الرسم البياني لأوقات الاستجابة متوسط وقت الاستجابة للطلبات لكل واجهة برمجة تطبيقات.

أسفل الرسوم البيانية، يعرض جدول واجهات برمجة التطبيقات التي تم تفعيلها والخدمات. الطلبات هي عدد الطلبات (للفترة الزمنية المحددة). الأخطاء هي عدد هذه الطلبات التي أدت إلى حدوث أخطاء. إنّ وقت الاستجابة (متوسط وقت الاستجابة والنسبة المئوية) هو وقت الاستجابة لهذه الطلبات.

واجهات برمجة التطبيقات للمراقبة

للوصول إلى صفحة لوحة بيانات واجهات برمجة التطبيقات والخدمات:

  1. افتح صفحة "أداة اختيار المشروع" في Cloud Console:

    صفحة أداة اختيار المشروع

  2. اختَر مشروعك. تظهر صفحة "لوحة بيانات واجهات برمجة التطبيقات والخدمات".

    إذا لم تظهر الصفحة، انقر على زر القائمة القائمة ثم انقر على واجهات برمجة التطبيقات والخدمات.

لمزيد من المعلومات، يُرجى الاطّلاع على مراقبة استخدام واجهة برمجة التطبيقات.

صفحة النظرة العامة على "خرائط Google"

تتضمّن صفحة النظرة العامة في "خرائط Google" واجهات برمجة تطبيقات تمّ فيها إدراج جدول وطلبات استخدام في آخر 30 يومًا. ويتم أيضًا عرض الطلبات من خلال واجهة برمجة التطبيقات على شكل رسم بياني. يعرض الرسم البياني للفوترة فاتورتك الحالية وإجمالي الاستخدام خلال آخر 3 أشهر.

لقطة شاشة لمخطّط نظرة عامة يعرض جدولاً تم تفعيل واجهات برمجة التطبيقات وطلبات واجهة برمجة التطبيقات في آخر 30 يومًا.

للوصول إلى صفحة النظرة العامة على "منصة خرائط Google":

  1. افتح صفحة "منصة خرائط Google" في Cloud Console:

    الانتقال إلى صفحة "منصة خرائط Google"

  2. في القائمة اليمنى، اختَر نظرة عامة.

صفحة واجهات برمجة التطبيقات في "منصة خرائط Google"

تتضمّن صفحة واجهات برمجة التطبيقات في "خرائط Google" جدولَين. يعرض جدول واجهات برمجة التطبيقات التي تم تفعيلها عدد الطلبات وعدد الأخطاء ومتوسط وقت الاستجابة لكل واجهة برمجة تطبيقات مفعّلة خلال آخر 30 يومًا. يعرض جدول واجهات برمجة التطبيقات الإضافية واجهات برمجة التطبيقات التي لم يتم تفعيلها.

واجهات برمجة التطبيقات

للوصول إلى صفحة واجهات برمجة التطبيقات على "منصة خرائط Google":

  1. افتح صفحة "منصة خرائط Google" في Cloud Console:

    الانتقال إلى صفحة "منصة خرائط Google"

  2. في القائمة اليمنى، اختَر واجهات برمجة التطبيقات.

صفحة المقاييس في "خرائط Google"

تعرض صفحة المقاييس في "خرائط Google" ثلاثة رسوم بيانية: عدد الزيارات والأخطاء ومتوسط وقت الاستجابة. ويمكن تجميع بيانات الاستخدام في الرسومات البيانية حسب فئة رمز الاستجابة وواجهة برمجة التطبيقات وطريقة واجهة برمجة التطبيقات وبيانات الاعتماد والنظام الأساسي والنطاق.

أسفل الرسوم البيانية، تتضمن صفحة المقاييس جدول واجهات برمجة تطبيقات يعرض الطلبات والأخطاء ووقت الاستجابة لواجهات برمجة التطبيقات التي اخترتها.

باستخدام القائمة المنسدلة لواجهة برمجة التطبيقات في أعلى الصفحة وخيارات التجميع والفلترة في الجزء الأيسر، يمكنك تجميع مقاييس الاستخدام المعروضة وفلترتها من خلال اختيار واجهات برمجة تطبيقات معيَّنة أو متعددة و/أو بيانات الاعتماد و/أو فئات رمز الاستجابة و/أو نوع النظام الأساسي و/أو النطاق. يمكنك أيضًا اختيار فترة زمنية (من ساعة إلى آخر 30 يومًا) ودقة (لكل ثانية أو يوم) لمقاييس الاستخدام المعروضة.

صفحة المقاييس التي تعرض ثلاثة رسوم بيانية: عدد الزيارات والأخطاء ومتوسط وقت الاستجابة

تعرض الصور التالية فلاتر النظام الأساسي والنطاق لواجهة برمجة تطبيقات واحدة عند التجميع حسب النظام الأساسي والنطاق في القائمة المنسدلة مُجمّعة حسب:

لا يظهر فلتر "المنصة" إلا عند اختيار واجهة برمجة تطبيقات واحدة. لا يظهر فلتر "المنصة" إلا عند اختيار واجهة برمجة تطبيقات واحدة.

للوصول إلى صفحة مقاييس واجهة برمجة التطبيقات في "منصة خرائط Google":

  1. افتح صفحة "منصة خرائط Google" في Cloud Console:

    الانتقال إلى صفحة "منصة خرائط Google"

  2. في القائمة اليمنى، اختَر المقاييس.

الرسومات البيانية لرمز الاستجابة

يُقسِّم الرسم البياني الزيارات حسب رمز الاستجابة والخطأ حسب رمز الاستجابة الاستخدام حسب فئة رمز استجابة HTTP. يعرض الجدول أدناه عملية الربط بين حالة استجابة واجهة برمجة التطبيقات على "منصة خرائط Google" وفئة رمز استجابة HTTP:

حالة Maps API فئة رمز استجابة HTTP - تقرير الاستخدام
(2xx و3xx و4xx و5xx)
ملاحظات
حسنًا 2xx تم الرد بنجاح.

هذا طلب قابل للفوترة وتستهلك الحصة.
حسنًا 3xx تم الرد بنجاح.

هذا طلب قابل للفوترة وتستهلك الحصة.

على سبيل المثال، تعرض صورة المكان الطلبات الناجحة إعادة التوجيه 302 إلى الصورة المشار إليها.
البيانات_غير متوفرة 2xx/4xx(1) استجابة ناجحة تشير إلى عدم توفّر بيانات لمواقع الإدخال.

هذا طلب قابل للفوترة وتستهلك الحصة.
ZERO_RESULTS 2xx/4xx(1) لم يتم عرض أي نتيجة ناجحة.

هذا طلب قابل للفوترة وتستهلك الحصة.
لم يتم العثور عليه 2xx/4xx(1) بالنسبة إلى واجهة برمجة تطبيقات الاتجاهات، يشير ذلك إلى أن واحدًا على الأقل من المواقع الجغرافية المحدّدة في أصل الطلب أو الوجهة أو نقاط الطريق لا يمكن ترميزه جغرافيًا.

بالنسبة إلى واجهة برمجة تطبيقات الأماكن، يشير ذلك إلى أنه لم يتم العثور على الموقع المشار إليه (Place_id) في قاعدة بيانات الأماكن.

هذا طلب قابل للفوترة وتستهلك الحصة.
INVALID_REQUEST (قيمة المعلمة غير صالحة)،
MAX_wayPOINTS_EXCEEDED،
MAX_ROUTE_LENGTH_EXCEEDED، وغير ذلك
4xx حدث خطأ بسبب قيمة المعلمة غير صالحة. للحصول على مزيد من التفاصيل، يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات.

هذا طلب قابل للفوترة وتستهلك الحصة.
تم رفض الطلب 4xx حدث خطأ في البرنامج بسبب خطأ في المصادقة وخطأ في الوصول وما إلى ذلك. راجع استجابة واجهة برمجة التطبيقات لمعرفة المزيد من التفاصيل.
OVER_TODAY_LIMIT،
OVER_QUERY_LIMIT،
RESOURCE_EXHAUSTED،
تم تجاوز المعدل،
تم تجاوز اليومي اليومي،
userRateLimitتجاوز
4xx حدث خطأ في البرنامج ناتج عن طلبات كثيرة جدًا لكل فترة زمنية مسموح بها. أعِد محاولة تقديم الطلب في وقت لاحق. تحقّق من استجابة واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
INVALID_REQUEST (معلمة غير صالحة/مفقودة، خطأ في التحليل/التحقّق من الصحة) 4xx حدث خطأ في البرنامج بسبب طلب غير صالح. تحقّق من استجابة واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
NOT_FOUND (404) 4xx بالنسبة إلى واجهة برمجة التطبيقات للموقع الجغرافي، يشير هذا إلى أن المدخلات لم تكن كافية لإنشاء تقدير للموقع الجغرافي.

بالنسبة إلى واجهة برمجة التطبيقات للطرق، يشير ذلك إلى أنه تعذّر الوصول إلى المدخلات بشكل معقول على الطرق.

هذا طلب قابل للفوترة وتستهلك الحصة.
خطأ غير معروف 5xx حدث خطأ في الخادم يشير إلى تعذّر متابعة الطلب: خطأ داخلي، حمل زائد على الخدمة، غير متاح، انتهت المهلة، إلخ.
1 لتحسين اتساق إعداد تقارير رموز الأخطاء، يتم نقل واجهات برمجة التطبيقات في "منصة خرائط Google" (الحالة) من فئة رمز استجابة HTTP 2xx إلى 4xx لحالات واجهة برمجة تطبيقات الخرائط: DATA_NOT_AVAILABLE وNOT_FOUND و ZERO_RESULTS. يمكنك الاطّلاع على رمزَي الاستجابة خلال فترة النقل. لن يتم تغيير رموز الاستجابة المعروضة في ردود واجهة برمجة تطبيقات الخرائط. تأكّد من أنّ الزيادة في 4xx في مقاييس "منصة خرائط Google" مرتبطة بعملية نقل البيانات هذه من خلال التحقّق من رمز الاستجابة الدقيق الذي يزيد في Metrics Explorer (اطّلِع على مزيد من المعلومات عن استخدام "خدمة مراقبة Google Cloud" في "منصة خرائط Google").

لمزيد من المعلومات عن رموز الحالة ورسائل الخطأ، اطلع على مستندات الاستجابة لواجهة برمجة التطبيقات التي تهتم بها (على سبيل المثال، استجابات الترميز الجغرافي أو استجابات الاتجاهات).

معلمة حلول "منصة خرائط Google"

يوفر "منصة خرائط Google" العديد من أنواع نماذج الرموز لمساعدتك على الاستعداد وبدء العمل بسرعة. على سبيل المثال، يمكنك استخدام Quick Builder في Cloud Console، واتّباع أدلة تنفيذ الحلول المخصّصة لمجال العمل، والاستفادة من دروس تطبيقية حول الترميز.

لفهم الاستخدام وطرق تحسين حلولنا، تُضمِّن Google معلَمة طلب البحث solution_channel في طلبات البيانات من واجهة برمجة التطبيقات لجمع معلومات عن استخدام نموذج الرمز:

  • يتم تضمين معلّمة طلب البحث solution_channel بشكلٍ تلقائي في نموذج الرمز الخاص بالحل.
  • تعرض معلَمة طلب البحث إحصاءات عن استخدام الحلّ على Google لتحسين جودة الحلّ في الإصدارات المستقبلية.
  • يمكنك الإيقاف من خلال حذف معلَمة طلب البحث solution_channel وقيمتها من نموذج الرمز.
  • ليست هناك حاجة إلى الاحتفاظ بالمَعلمة. ولن تؤثر إزالة معلّمة طلب البحث في الأداء.
  • لا تُستخدم معلّمة طلب البحث إلا في إعداد تقارير استخدام رمز النموذج.
  • معلَمة طلب البحث منفصلة عن أي إحصاءات وتقارير خاصة بواجهة برمجة التطبيقات. وهذا يعني أن إزالة المعلّمة من نموذج رمز الحل لن يؤدي إلى إيقاف الإبلاغ عن واجهة برمجة تطبيقات JavaScript للخرائط الداخلية.

تقارير الحصص

تحدد الحصص حدودًا لعدد الطلبات التي يمكن لمشروعك إجراؤها على واجهات برمجة تطبيقات Google Maps Platform. يمكن تقييد الطلبات بثلاث طرق: في اليوم، في الدقيقة، لكل مستخدم في الدقيقة. لا يتم احتساب سوى الطلبات والطلبات الناجحة التي تسبب أخطاء الخادم ضمن الحصة. لا يتم احتساب الطلبات التي تتعذّر مصادقتها ضمن الحصة.

يتم عرض استخدام الحصة في رسومات بيانية على صفحة الحصص في Cloud Console، ويمكن تجميعه في طلبات كل دقيقة. يتم عرض الحدود الحالية للحصة المحددة لواجهات برمجة التطبيقات المحددة في الجداول أسفل الرسومات البيانية لاستخدام الحصة.

يمكنك استخدام أداة الحاسبة هذه للحصول على قيمة الحصة لكل دقيقة لأي منتج من واجهات برمجة التطبيقات في "منصة Google للتسويق".

صفحة حصص خرائط Google

تعرض صفحة الحصص في "خرائط Google" حدود الحصة واستهلاك الحصة لواجهة برمجة التطبيقات المحددة التي اخترتها.

يعرض الرسم البياني لاستخدام الحصة في Google Cloud Console إجمالي عدد الزيارات لمفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء. تتوفّر أيضًا زيارات معرّف العميل في الرسم البياني للمقاييس على Cloud Console.

لا تعرض الصفحة سوى الطلبات التي تستهلك حصة محدّدة من الطلبات الناجحة (OK و ZERO_RESULTS وDATA_NOT_AVAILABLE) والطلبات التي تؤدي إلى حدوث أخطاء في الخادم (NOT_FOUND وINVALID_REQUEST/INVALID_VALUE (قيمة المعلَمة غير صالحة) وUNKNOWN_ERROR).

إنّ الطلبات التي تؤدي إلى حدوث أخطاء في البرنامج — أخطاء في المصادقة/التفويض/غير صالحة (REQUEST_DENIED وOVER_QUERY_LIMIT وINVALID_REQUEST (مَعلمة غير صالحة وخطأ في تحليل الطلب)) — لا تستهلك الحصة ولا يتم عرضها.

وحدة الحصة هي طلب لمعظم واجهات برمجة التطبيقات في "منصة خرائط Google" (Maps Static API والتجوّل الافتراضي لواجهة برمجة التطبيقات وواجهة برمجة التطبيقات للترميز الجغرافي وواجهة برمجة التطبيقات للاتجاهات وواجهة برمجة التطبيقات للأماكن وواجهة برمجة التطبيقات للمنطقة الزمنية وواجهة برمجة التطبيقات للموقع الجغرافي وواجهة برمجة التطبيقات للارتفاع). ولكن هناك بعض الاستثناءات:

  • بالنسبة إلى واجهة برمجة تطبيقات مصفوفة المصفوفة، تكون وحدة الحصة عنصرًا وهو زوج نقطة الانطلاق.
  • وبالنسبة إلى واجهة برمجة تطبيقات JavaScript للخرائط، تكون وحدة الحصة هي تحميل الخريطة.
  • وبالنسبة إلى حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android وحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل iOS، تكون وحدة الحصة عبارة عن طلب التجوّل الافتراضي/تحميل بانوراما (تتوفر عمليات تحميل الخرائط بدون أي رسوم ولا تستهلك الحصة).

لقطة شاشة لصفحة حصص "خرائط Google" في Google Cloud Console. وتعرِض الحصة حسب واجهة برمجة التطبيقات باستخدام أداة الاختيار، ثم تعرض عدد عمليات تحميل الخريطة بالنسبة إلى الحصص المحدَّدة لواجهة برمجة التطبيقات المعنيّة.

للوصول إلى صفحة حصص "منصة خرائط Google":

  1. افتح صفحة "منصة خرائط Google" في Cloud Console:

    الانتقال إلى صفحة "منصة خرائط Google"

  2. في القائمة اليمنى، اختَر الحصص.
  3. اختَر واجهة برمجة تطبيقات من القائمة المنسدلة لواجهة برمجة التطبيقات.

عدد وحدات الحصة

يعرض الجدول أدناه وحدة الحصة لواجهات برمجة تطبيقات "منصة خرائط Google".

واجهة برمجة تطبيقات النظام الأساسي في خرائط Google وحدة الحصة
الخرائط
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android بانوراما واحدة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS بانوراما واحدة
Maps Static API طلب واحد
Maps JavaScript API حِمل خريطة واحد
Street View Static API طلب واحد
Maps Embed API حِمل خريطة واحد
المسارات
Directions API طلب واحد
Distance Matrix API عنصر واحد (زوج الوجهة)
Roads API طلب واحد
أماكن
واجهة برمجة تطبيقات الأماكن طلب واحد
واجهة برمجة تطبيقات التحقق من العنوان طلب واحد
Geocoding API طلب واحد
Geolocation API طلب واحد
Time Zone API طلب واحد

تقارير الفوترة

الاطّلاع على تقرير الفوترة

تتوفّر تقارير الفوترة لاستخدامك لمنتجات "منصة خرائط Google" في Google Cloud Console (اطّلع على الفوترة).

للوصول إلى تقارير الفوترة:

  1. افتح صفحة "أداة اختيار المشروع" في Cloud Console:

    صفحة أداة اختيار المشروع

  2. اختَر مشروعًا.
  3. انقر على زر القائمة القائمة ثم اختَر الفوترة.
  4. إذا كانت لديك حسابات فوترة متعددة، انقر على الانتقال إلى حساب الفوترة المرتبط لفتح صفحة النظرة العامة لحساب الفوترة المرتبط.
  5. في القائمة اليمنى، انقر على التقارير لفتح صفحة التقارير الخاصة بحساب الفوترة المرتبط بحساب الفوترة.

كيفية قراءة الرسم البياني لتقرير الفوترة

تشير تقارير الفوترة إلى التكلفة على مدار الوقت كرسم بياني خطي مكدّس. تُظهِر طريقة العرض التلقائية التكاليف اليومية الخاصة بالاستخدام الحالي للشهر مجمّعة حسب المشروع (لجميع المنتجات)، بما في ذلك أي أرصدة خاصة بالاستخدام مُطبَّقة، بالإضافة إلى التكلفة الإجمالية المتوقعة للشهر الحالي بالكامل. يطابق كل سطر في الرسم البياني (وصف في جدول الملخّص) المشروع، حيث يتم ترتيبه من الأكبر إلى الأصغر حسب التكلفة. تعرّف على مزيد من المعلومات حول تفسير الرسم البياني لتقرير الفوترة.

لقطة شاشة لتقرير الفوترة يعرض الرسم البياني والجدول باستخدام طريقة العرض المُعَدّة التلقائية
الشكل 1: تقرير الفوترة الذي يعرض الرسم البياني والجدول باستخدام العرض التلقائي المعدّ مسبقًا.

نصيحة: تحليل الاستخدام والتكلفة لكل رمز تخزين تعريفي

لفهم تفاصيل نموذج الدفع حسب الاستخدام وتأثيره في عملية التنفيذ، اطّلِع على استخدامك والتكلفة حسب رمز التخزين التعريفي.

تقرير الفوترة مجمّع حسب رمز التخزين التعريفي
الشكل 2: جدول الفوترة الذي يعرض عناصر الاستخدام والتكلفة حسب رمز التخزين التعريفي
.
لقطة شاشة لفلاتر تقرير الفوترة
الشكل 3: تتم فلترة فلاتر تقرير الفوترة.
لتغيير طريقة عرض التقرير إلى العناصر المعروضة حسب رمز التخزين التعريفي:
  1. في اللوحة على يسار الرسم البياني، وسِّع الفلتر تجميع حسب.
  2. انقر على رمز التخزين التعريفي.

وتشمل فلاتر تقارير الفوترة الأخرى النطاق الزمني والمشاريع والمنتجات ورموز التخزين التعريفية والمواقع الجغرافية التي تتيح لك الفلترة حسب مكان عرض طلبات البيانات من واجهة برمجة التطبيقات.

لتصنيف مصدر استخدامك بالإضافة إلى المنتج، يمكنك تجميع تقارير الفوترة حسب إحدى القيم المدرَجة. المفاتيح الثلاثة التي ترتبط بواجهات برمجة التطبيقات في "منصة خرائط Google" هي goog-maps-api-key-suffix (الأحرف الأربعة الأخيرة من مفتاح واجهة برمجة التطبيقات)، وgoog-maps-platform-type (النظام الأساسي: Android أو iOS أو JavaScript أو webservice)، وgoog-maps-channel (قيمة قناة رقمية محددة من طلب بحث في واجهة برمجة التطبيقات). مزيد من المعلومات حول الفلترة والتجميع

يمكنك تغيير طريقة عرض الرسم البياني لاستبعاد الأرصدة الخاصة بالاستخدام من خلال إزالة العلامة من مربّع الاختيار تضمين الأرصدة في التكلفة في اللوحة اليسرى.

مراقبة الاستهلاك وتقييده

لمساعدتك على تخطيط ميزانيتك والتحكّم في التكاليف، يمكنك تنفيذ ما يلي:

  • ضبط تنبيه للميزانية، لتتبُّع كيفية زيادة إنفاقك نحو مبلغ محدّد. لا يؤدي ضبط ميزانية إلى تقييد استخدام واجهة برمجة التطبيقات، ولكنه ينبّهك فقط عندما يصل مبلغ الإنفاق إلى المبلغ المحدّد.
  • الحدّ من الاستخدام اليومي لواجهة برمجة التطبيقات لإدارة تكلفة استخدام واجهات برمجة التطبيقات القابلة للفوترة من خلال وضع حدود على الطلبات في اليوم، يمكنك وضع حد للإنفاق. استخدِم معادلة بسيطة لتحديد الحدّ الأقصى اليومي استنادًا إلى المبلغ الذي تريد إنفاقه. على سبيل المثال: (الإنفاق الشهري /السعر لكل رمز تخزين تعريفي)/30 = عدد الطلبات في اليوم الواحد (الحد الأقصى لواجهة برمجة التطبيقات). تجدر الإشارة إلى أن عملية التنفيذ قد تستخدم عدة واجهات برمجة تطبيقات قابلة للفوترة، لذا يُرجى تعديل المعادلة حسب الحاجة. تذكّر أنه يتوفّر رصيد بقيمة 200 دولار أمريكي (أو ما يعادل ذلك بالعملة المحلية) في "منصة خرائط Google" كل شهر، لذا تأكّد من مراعاة ذلك في عملية الحساب.

تتبّع الاستخدام لكل قناة

لتتبّع استخدامك عبر القنوات الرقمية، عليك إضافة المعلّمة "channel" إلى طلبات واجهة برمجة التطبيقات. وتكون القيم الوحيدة للقناة هي الأرقام من 0 إلى 999. إليك بعض الأمثلة:

  • واجهة برمجة تطبيقات خدمة الويب للترميز الجغرافي
    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • واجهة برمجة تطبيقات JavaScript للخرائط
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
    async defer></script>

يمكنك مراقبة استخدام قناتك مباشرةً في تقرير الفوترة. ستظهر القنوات ضمن التصنيفات باعتبارها السمة goog-maps-channel الأساسية.

فلترة حسب التصنيفات
الشكل 4: الفلترة حسب رمز التخزين التعريفي والقنوات
لفلترة تقرير الفوترة حسب رمز التخزين التعريفي والقناة
  1. استخدِم الفلتر تجميع حسب رمز التخزين التعريفي.
  2. اختَر علامة الإقحام التصنيفات.
  3. اختر القائمة المنسدلة المفتاح واختر goog-maps-channel.
  4. اختَر القائمة المنسدلة القيمة واختَر القنوات الرقمية التي تريد فلترتها.

يمكنك التصنيف حسب مفتاح التصنيف goog-maps-channel للاطّلاع على التكلفة الناتجة عن كل قناة.

بعد تنفيذ بيانات استخدام القناة في طلباتك، قد يحدث تأخير لفترة قصيرة (حتى 24 ساعة) قبل أن تظهر البيانات في تقرير الفوترة.

تصدير بيانات الفوترة باستخدام BigQuery

يمكنك أيضًا تصدير بيانات الفوترة إلى BigQuery.

تتيح لك ميزة BigQuery Export تصدير بيانات فوترة Cloud التفصيلية (مثل بيانات الاستخدام وتقدير التكلفة) تلقائيًا على مدار اليوم إلى مجموعة بيانات BigQuery التي تحددها. ويمكنك بعد ذلك الوصول إلى بيانات الفوترة من BigQuery لإجراء تحليل تفصيلي. ويوفّر ذلك طبقة إضافية من الدقة لفهم مصدر استخدامك لخدمة "منصة خرائط Google".

إذا كنت تريد البدء في عمليات تصدير BigQuery وإجراء طلبات بحث عن البيانات، يمكنك تجربة نموذج طلب البحث أدناه. قبل تنفيذ طلب البحث هذا، يجب:

  • فعِّل الفوترة وتصدير بيانات فوترة BigQuery على حسابك.
  • تنسيق الجدول هو PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID حيث:
    • PROJECT_ID هو رقم تعريف مشروعك الفعلي (مثل "my-project-123456").
    • DATASET_NAME هو اسم مجموعة البيانات التي أنشأتها (مثل "SampleDataSet").
    • BILLING_ACCOUNT_ID هو مرجع لرقم تعريف حساب الفوترة، تسبقه "gcp_billing_exportv1" ويغيّر الشرطات (-) إلى الشرطات السفلية (_). على سبيل المثال، رقم تعريف حساب الفوترة 123456-7890AB-CDEF01 سيصبح gcp_billing_export_v1_123456_789AB_CDEF01.

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

الفوترة في السحابة الإلكترونية:

منصّة "خرائط Google":

حالة الرد والتقارير

يعرض الجدول أدناه عملية الربط بين حالة Maps API ورمز رمز استجابة HTTP الذي تم عرضه في استجابات API API للخرائط وفئة رمز استجابة HTTP في تقرير الاستخدام ويشير إلى ما إذا كان الطلب المقابل يظهر في تقارير "الاستخدام" و"الحصة" و"الفوترة".

يقدّم تقرير الاستخدام في مقاييس "منصة خرائط Google" دقة HTTP response code class. إذا كنت بحاجة إلى مستوى عالٍ من الدقة، يُرجى الاطّلاع على رموز حالة الاستجابة المتوفرة في مراقبة استخدام "منصة خرائط Google".

رموز الاستجابة المتاحة في ردود واجهة برمجة تطبيقات الخرائط متاح في تقرير الاستخدام تم الإبلاغ إلى
حالة Maps API رمز استجابة HTTP فئة رمز استجابة HTTP الاستخدام الحصة الفوترة
حسنًا 200،
204،
302
2xx،
3xx
نعم نعم نعم
DATA_NOT_AVAILABLE،
NOT_FOUND،
ZERO_RESULTS
200 2xx/4xx1 نعم نعم نعم
NOT_FOUND (واجهات برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" ورصد الموقع الجغرافي والطرق)
ZERO_RESULTS (واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي")
404 4xx نعم نعم نعم
INVALID_REQUEST (قيمة المعلمة غير صالحة)،
MAX_ROUTE_LENGTH_EXCEEDED،
MAX_wayPOINTS_EXCEEDED،
وما إلى ذلك
200/400 4xx نعم نعم نعم
INVALID_REQUEST (معلمة غير صالحة/غير متوفرة، خطأ في تحليل الطلب) 200/400 4xx نعم لا لا
تم رفض الطلب 200/403 4xx نعم لا لا
OVER_TODAY_LIMIT،
OVER_QUERY_LIMIT،
RESOURCE_EXHAUSTED،
تم تجاوز الحد اليومي،
تم تجاوز المعدل،
userRateLimitتجاوز
200/403،
429
4xx نعم لا لا
خطأ غير معروف 200/500،
503
5xx نعم نعم لا
1 لتحسين اتساق إعداد تقارير رموز الأخطاء، يتم نقل واجهات برمجة التطبيقات في "منصة خرائط Google" (الحالة) من فئة رمز استجابة HTTP 2xx إلى 4xx لحالات واجهة برمجة تطبيقات الخرائط: DATA_NOT_AVAILABLE وNOT_FOUND و ZERO_RESULTS. يمكنك الاطّلاع على رمزَي الاستجابة خلال فترة النقل. لن يتم تغيير رموز الاستجابة المعروضة في ردود واجهة برمجة تطبيقات الخرائط. تأكّد من أنّ الزيادة في 4xx في مقاييس "منصة خرائط Google" مرتبطة بعملية نقل البيانات هذه من خلال التحقّق من رمز الاستجابة الدقيق الذي يزيد في Metrics Explorer (اطّلِع على مزيد من المعلومات عن استخدام "خدمة مراقبة Google Cloud" في "منصة خرائط Google").

تقارير الاشتراك

بالنسبة إلى مستخدمي Locator Plus، تساعدك لوحة بيانات "إحصاءات Google" في تحليل وإنشاء بيانات من بياناتك، ما يمنح فكرة واضحة عن مدى تفاعل المتسوّقين مع محدِّد مواقع المتاجر. يمكنك قياس أدائك أسبوعيًا، بما في ذلك عدد المشاهدات وعدد التفاعلات مع تفاصيل البحث والمكان، ونسبة التفاعل الإجمالي. إضافةً إلى ذلك، توفّر لوحة البيانات مقاييس أداء مهمّة حول مستوى أداء تطبيقك مقارنةً ببائعي التجزئة الآخرين.

  • انتقِل إلى Locator Plus في Google Cloud Console.
  • انتقِل إلى قسم تقارير التفاعل في Google Cloud Console للاطّلاع على لوحة بيانات الإحصاءات.

يسمح لك تقرير قياس الأداء بمقارنة بياناتك ببيانات مجال العمل المجمّعة من الشركات الأخرى التي تشارِك بياناتها. وتوفّر المقارنة سياقًا مهمًا، ما يساعدك على تحديد أهداف مفيدة، والحصول على إحصاءات عن مؤشرات المجال، ومعرفة مستوى أدائك مقارنةً بالمنافسين.

للاطّلاع على بيانات قياس الأداء، يتم تضمين بيانات تفاعلك مع إخفاء الهوية في مقاييس أداء Google. إذا أردت إيقاف الاطّلاع على بيانات التفاعل وتضمينها في تقارير قياس الأداء بدون الكشف عن هويتك، يمكنك تقديم طلب دعم. سيتم عادةً حلّ طلب الدعم خلال 3 أيام.