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

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

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

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

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

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

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

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

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

• جميع واجهات برمجة التطبيقات: يمكنك فلترة مقاييس الاستخدام لجميع واجهات برمجة التطبيقات وتجميعها بالطُرق التالية:

  • الفلترة حسب الفترة الزمنية وواجهة برمجة التطبيقات
  • راجع حركة المرور والأخطاء ووقت الاستجابة مجمّعة حسب رمز الاستجابة وواجهة برمجة التطبيقات وبيانات الاعتماد.

• واجهة برمجة تطبيقات معيّنة: يمكنك فلترة مقاييس الاستخدام وتجميعها لواجهة برمجة تطبيقات معيّنة بالطرق التالية:

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

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

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

• تعرض صفحة لوحة البيانات ثلاثة رسوم بيانية وجدولًا. يمكنك فلترة معدّل الاستخدام المعروض في الرسوم البيانية والجداول من خلال اختيار فترة زمنية تتراوح بين ساعة واحدة وآخر 30 يومًا.

• يعرض الرسم البياني عدد الزيارات الاستخدام في طلبات البحث لكل دقيقة (QPM) لكل واجهة برمجة تطبيقات.

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

• يعرض الرسم البياني وقت الاستجابة متوسّط وقت استجابة الطلبات لكل واجهة برمجة تطبيقات.

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

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

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

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

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

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

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

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

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

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

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

2. انقر على نظرة عامة في القائمة اليمنى.

صفحة "واجهات برمجة التطبيقات والخدمات في Google Maps Platform"

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

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

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

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

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

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

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

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

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

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

للوصول إلى صفحة "مقاييس Google Maps Platform API":

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

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

2. في القائمة اليمنى، انقر على المقاييس.

إعداد تقارير بيانات الاعتماد

يمكنك فلترة المقاييس وتجميعها حسب بيانات الاعتماد التي تم استخدامها لتحميل واجهة برمجة التطبيقات.

تنسيق بيانات الاعتماد	المعنى
اسم المفتاح على سبيل المثال، "مفتاح تطبيق الجوّال"	تم استخدام مفتاح واجهة برمجة تطبيقات لتحميل واجهة برمجة التطبيقات باستخدام ?key=...: يمكنك العثور على أسماء المفاتيح على وحدة التحكّم في "منصة خرائط Google" ضمن المفاتيح وبيانات الاعتماد.
رقم المشروع على سبيل المثال، "project_number:123456"، حيث يكون 123456 هو رقم مشروعك.	هناك احتمالان إذا ظهرت لك بيانات الاعتماد هذه: بالنسبة إلى واجهات برمجة التطبيقات التي تقبل معرّفات العملاء في "منصة خرائط Google": تم استخدام معرّف عميل "منصة خرائط Google" لتحميل واجهة برمجة التطبيقات. على سبيل المثال، باستخدام &client=gme-_mycompany_. تقبل واجهات برمجة التطبيقات التالية معرّفات العملاء: Maps JavaScript API وMaps Static API وStreet View Static API وElevation API وDirections API وDistance Matrix API وGeocoding API وTime Zone API. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة معرِّف العميل للخطة المميّزة. لواجهات برمجة التطبيقات التي تقبل بروتوكول OAuth: تم تحميل واجهة برمجة التطبيقات باستخدام بروتوكول OAuth بدون مفتاح واجهة برمجة التطبيقات.

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

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

حالة واجهة برمجة التطبيقات للخرائط	فئة رمز استجابة HTTP - تقرير الاستخدام (2xx و3xx و4xx و5xx)	ملاحظات
حسنًا	2xx	تمت الاستجابة بنجاح. هذا طلب قابل للفوترة وسيستهلك حصة.
حسنًا	3xx	استجابة ناجحة. هذا طلب يخضع للفوترة وسيستهلك الحصة. على سبيل المثال، الصور في الأماكن إنّ الطلبات الناجحة تُرسِل رمز إعادة التوجيه 302 إلى الصورة المُشار إليها.
DATA_NOT_AVAILABLE	4xx(1)	استجابة ناجحة تشير إلى عدم توفّر بيانات لمواقع الإدخال هذا طلب يخضع للفوترة وسيستهلك الحصة.
ZERO_RESULTS	‎4xx(1)	لم ينتج عن الاستجابة الناجحة أي نتيجة. هذا طلب يخضع للفوترة وسيستهلك الحصة.
NOT_FOUND	‎4xx(1)	بالنسبة إلى Directions API، تشير هذه الرسالة إلى أنّه تعذّر ترميز موقع جغرافي واحد على الأقل من المواقع الجغرافية المحدّدة في نقطة الانطلاق أو الوجهة أو نقاط الطريق للطلب. بالنسبة إلى واجهة برمجة التطبيقات Places API ، تشير هذه الرسالة إلى أنّه لم يتم العثور على الموقع الجغرافي المُشار إليه (place_id) في قاعدة بيانات "الأماكن". هذا طلب يخضع للفوترة وسيستهلك الحصة.
nofollow_REQUEST (قيمة مَعلمة غير صالحة)، MAX_WAYPOINTS_EXCEEDED، MAX_ROUTE_LENGTH_EXCEEDED، وغير ذلك	4xx	حدث خطأ بسبب قيمة مَعلمة غير صالحة. راجِع ردّ واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل. هذا طلب قابل للفوترة وسيستهلك حصة.
REQUEST_DENIED	4xx	خطأ في البرنامج ناتج عن خطأ في المصادقة أو خطأ في الوصول أو غير ذلك راجِع استجابة واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded	4xx	خطأ في البرنامج بسبب عدد كبير جدًا من الطلبات خلال الفترة الزمنية المسموح بها يُرجى إعادة المحاولة في وقت لاحق. لمزيد من التفاصيل، يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات.
INVALID_REQUEST (مَعلمة غير صالحة أو غير متوفّرة، خطأ في تحليل الطلب أو التحقّق منه)	4xx	حدث خطأ في العميل بسبب طلب غير صالح. يمكنك الاطّلاع على رد واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
NOT_FOUND (404)	4xx	بالنسبة إلى Geolocation API، تشير هذه الرسالة إلى أنّ الإدخالات لم تكن كافية لتقديم تقدير للموقع الجغرافي. بالنسبة إلى Roads API، تشير هذه الرسالة إلى أنّه تعذّر ربط الإدخالات بشكل معقول بالطرق. هذا طلب يخضع للفوترة وسيستهلك الحصة.
UNKNOWN_ERROR	5xx	خطأ في الخادم يشير إلى أنّه لا يمكن متابعة الطلب: خطأ في الخادم الداخلي، أو الخدمة غير متاحة أو متوقّفة مؤقتًا أو انتهت مهلة الطلب أو غير ذلك
1 لتحسين اتساق الإبلاغ عن رموز الأخطاء، تتم نقل واجهة برمجة التطبيقات في Google Maps Platform: 1) من فئة رمز استجابة HTTP‏ 2xx إلى 4xx لحالة واجهة برمجة تطبيقات خرائط Google: DATA_NOT_AVAILABLE وNOT_FOUND ZERO_RESULTS - الحالة، 2) من فئة رمز استجابة HTTP‏ 2xx إلى 4xx لحالة واجهة برمجة تطبيقات خرائط Google: REQUEST_DENIED وOVER_DAILY_LIMIT OVER_QUERY_LIMIT وdailyLimitExceeded rateLimitExceeded وuserRateLimitExceeded، 3) من فئة رمز استجابة HTTP‏ 2xx إلى 5xx لحالة واجهة برمجة تطبيقات خرائط Google: UNKNOWN_ERROR. يمكنك الاطّلاع على رمزَي الاستجابة خلال فترة التحويل. لن يتم تغيير رموز الاستجابة التي يتم عرضها في ردود Maps API. تأكَّد من أنّ الزيادة في 4xx و/أو 5xx في مقاييس "منصّة خرائط Google" ترتبط بعملية نقل البيانات هذه من خلال التحقّق من رمز الاستجابة الدقيق الذي يزداد في مستكشف المقاييس (مزيد من المعلومات حول استخدام مراقبة Google Cloud في "منصّة خرائط Google").

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

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

توفر منصة خرائط Google العديد من أنواع نماذج التعليمات البرمجية لمساعدتك في الإعداد والتشغيل بسرعة. على سبيل المثال، يمكنك استخدام أداة الإنشاء السريع في Cloud Console، واتّباع أدلة تنفيذ الحلول في المجال، والاستفادة من codelabs.

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

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

تقارير الحصص

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

يتم عرض استخدام الحصة في الرسوم البيانية في صفحة الحصص في 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 وStreet View Static API وGeocoding API وDirections API وPlaces API وTime Zone API وGeolocation API وElevation API)، ولكن هناك بعض الاستثناءات:

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

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

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

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

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

وحدات الحصة

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

Google Maps Platform API	وحدة الحصة
Maps
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android	بانوراما واحدة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS	بانوراما واحدة
Map Tiles API	طلب واحد
Maps Aerial View API	طلب واحد
Maps Static API	طلب واحد
Maps JavaScript API	تحميل خريطة واحد
Street View Static API	طلب واحد
Maps Embed API	تحميل خريطة واحدة
المسارات
Routes API (Compute Routes)	طلب واحد
Routes API (Compute Route Matrix)	عنصر واحد (زوج المصدر-الوجهة)
Directions API	طلب واحد
Distance Matrix API	عنصر واحد (زوج نقطة الانطلاق والوجهة)
Roads API	طلب واحد
Route Optimization API	طلب واحد
حزمة تطوير البرامج للتنقّل على أجهزة Android	وجهة واحدة
حزمة تطوير البرامج للتنقّل على أجهزة iOS	وجهة واحدة
أماكن
واجهة برمجة تطبيقات الأماكن	طلب واحد
Address Validation API	طلب واحد
Geocoding API	طلب واحد
Geolocation API	طلب واحد
Time Zone API	طلب واحد
البيئة
Air Quality API (CurrentConditions وHeatmapTile)	طلب واحد
واجهة برمجة تطبيقات جودة الهواء (السجلّ)	صفحة واحدة
Pollen API	طلب واحد
Solar API	طلب واحد

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

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

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

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

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

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

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

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

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

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

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

لتغيير طريقة عرض التقرير لعرض عناصر السلع حسب رمز التخزين التعريفي:

1. في اللوحة على يسار الرسم البياني، وسِّع فلتر التجميع حسب.
2. اختَر رمز التخزين التعريفي.

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

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

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

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

لمساعدتك في تخطيط ميزانيتك والتحكّم في التكاليف، يمكنك إجراء ما يلي:

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

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

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

لتتبُّع استخدامك من خلال القنوات الرقمية، يجب إضافة المَعلمة 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.

لفلترة تقرير الفوترة حسب رمز التخزين التعريفي والقناة

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
  

مراجع ذات صلة

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

• إنشاء حساب على Cloud Billing أو تعديله أو إغلاقه
• تعديل إعدادات الفوترة لمشروع
• عرض تقارير الفوترة ومؤشرات التكلفة
• ضبط الميزانيات وتنبيهات الميزانية
• وضع حدود لاستخدام واجهة برمجة التطبيقات

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

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

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

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

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

رموز الاستجابة المتاحة في الردود من واجهة برمجة التطبيقات للخرائط		متوفر في تقرير الاستخدام	تم الإبلاغ إلى
حالة واجهة برمجة تطبيقات الخرائط	رمز استجابة HTTP	فئة رمز استجابة HTTP	الاستخدام	الحصة	الفوترة
حسنًا	200, 204, 302	‎2xx، ‎3xx	نعم	نعم	نعم
DATA_NOT_availability، NOT_FOUND، ZERO_RESULTS	200، 404	4xx1	نعم	نعم	نعم
INVALID_REQUEST (قيمة مَعلمة غير صالحة)، MAX_ROUTE_LENGTH_EXCEEDED، MAX_WAYPOINTS_EXCEEDED، وما إلى ذلك	200, 400	4xx	نعم	نعم	نعم
INVALID_REQUEST (مَعلمة غير صالحة/غير متوفّرة، خطأ في تحليل الطلب)	200, 400	4xx	نعم	لا	لا
REQUEST_DENIED	200، 400، 403	4xx1	نعم	لا	لا
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200، 403، 429	4xx1	نعم	لا	لا
UNKNOWN_ERROR	200، 500، 503	5xx1	نعم	نعم	لا
1 لتحسين اتساق الإبلاغ عن رموز الأخطاء، تتم نقل واجهة برمجة التطبيقات في Google Maps Platform: 1) من فئة رمز استجابة HTTP‏ 2xx إلى 4xx لحالة واجهة برمجة تطبيقات خرائط Google: DATA_NOT_AVAILABLE وNOT_FOUND ZERO_RESULTS - الحالة، 2) من فئة رمز استجابة HTTP‏ 2xx إلى 4xx لحالة واجهة برمجة تطبيقات خرائط Google: REQUEST_DENIED وOVER_DAILY_LIMIT OVER_QUERY_LIMIT وdailyLimitExceeded rateLimitExceeded وuserRateLimitExceeded، 3) من فئة رمز استجابة HTTP‏ 2xx إلى 5xx لحالة واجهة برمجة تطبيقات خرائط Google: UNKNOWN_ERROR. يمكنك الاطّلاع على رمزَي الاستجابة خلال فترة التحويل. لن يتم تغيير رموز الاستجابة التي يتم عرضها في ردود Maps API. تأكّد من أنّ الزيادة في 4xx و/أو 5xx في مقاييس منصة "خرائط Google" مرتبطة بعملية النقل هذه، وذلك من خلال التحقّق من زيادة رمز الاستجابة بالضبط في أداة البحث عن المقاييس (مزيد من المعلومات حول استخدام "مراقبة السحابة الإلكترونية من Google" لمنصة "خرائط Google").

تقارير التفاعل

إحصاءات النشاط التجاري

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

تشمل إمكانات إعداد تقارير إحصاءات النشاط التجاري ما يلي:

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

تشمل مقاييس التفاعل المتاحة ما يلي:

• مرّات المشاهدة على الخريطة: يمكنك تتبُّع المشاهدات على الخريطة الناتجة عن عمليات التدوير أو التكبير أو التصغير. يتم احتساب عدد مشاهدات الخريطة حسب الرمز البريدي أسبوعيًا (من الأحد إلى السبت بتوقيت المحيط الهادئ). يتم إصدار البيانات الجديدة أسبوعيًا في أول يوم أربعاء بعد فترة المراقبة.

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

يمكنك تحليل مقاييس التفاعل مباشرةً في وحدة التحكّم باستخدام ميزتَي "الفلترة" و"التجميع حسب" للتوغّل في المقاييس بمزيد من التفاصيل. على سبيل المثال، يمكنك اختيار الفلترة حسب منطقة معيّنة لمعرفة مدى رواج مشاهدات الخريطة للرموز البريدية في تلك المنطقة فقط. من ناحية أخرى، قد تريد التجميع حسب منطقة معيّنة لتجميع التفاعلات داخل تلك المنطقة.

يمكن للمستخدمين تصدير مجموعة البيانات بالكامل أو طريقة عرض مفلتَرة إلى ملف CSV لإجراء مزيد من التحليل في أداة تحليل الأعمال المفضلة لديك. يمكنك تنزيل بيانات تصل إلى 90 يومًا في المرة الواحدة، وسيتم اقتطاع عمليات التنزيل التي تزيد عن 60 ألف خلية. قد يستغرق تصدير بيانات مشاهدات الخريطة إلى ملف CSV بضع دقائق استنادًا إلى النطاق الزمني المحدّد.

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

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

يجب عدم استخدام إحصاءات النشاط التجاري لتقدير تكاليف الاستخدام. يُرجى الرجوع إلى تقارير الاستخدام للحصول على مزيد من المعلومات حول الاستخدام.