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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

للوصول إلى صفحة "نظرة عامة على "منصة خرائط 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 هو رقم مشروعك.	هناك احتمالان إذا ظهرت لك بيانات الاعتماد هذه: بالنسبة إلى واجهات برمجة التطبيقات التي تقبل أرقام تعريف عملاء من Maps Platform: تم استخدام معرّف عميل من Maps Platform لتحميل واجهة برمجة التطبيقات. على سبيل المثال، باستخدام &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 بدون مفتاح واجهة برمجة التطبيقات.

ملاحظة: لا تتوفّر واجهات برمجة تطبيقات Maps Platform متوافقة مع معرّفات عملاء Maps Platform وOAuth، لذا يمكنك معرفة ما إذا تم تحميل واجهة برمجة التطبيقات باستخدام معرّف عميل أو OAuth استنادًا إلى واجهة برمجة التطبيقات المستخدَمة.

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

يقسّم الرسمان البيانيان عدد الزيارات حسب رمز الاستجابة وعدد الأخطاء حسب رمز الاستجابة استخدام الموقع الإلكتروني حسب فئة رمز استجابة HTTP. يعرض هذا الجدول التعيين بين حالة استجابة واجهة برمجة التطبيقات في "منصّة خرائط Google" وفئة رمز استجابة 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) في قاعدة بيانات "الأماكن". هذا طلب يخضع للفوترة وسيستهلك الحصة.
INVALID_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 Maps Platform API. يمكن الحد من الطلبات بثلاث طرق: في اليوم، وفي الدقيقة، وفي الدقيقة لكل مستخدم. لا يتم احتساب سوى الطلبات الناجحة والطلبات التي تؤدي إلى أخطاء في الخادم ضمن الحصة. لا يتم احتساب الطلبات التي تتعذّر فيها المصادقة ضمن الحصة.

يتم عرض استخدام الحصة في الرسوم البيانية في صفحة الحصص في 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، تكون وحدة الحصة هي طلب "التجوّل الافتراضي" أو تحميل panorama. تتوفّر عمليات تحميل الخرائط بدون أي رسوم ولا تستهلك الحصة.

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

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

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

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

وحدات الحصة

يعرض هذا الجدول وحدة الحصة لواجهات برمجة تطبيقات Google Maps Platform.

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)	طلب واحد
Air Quality API (السجلّ)	صفحة واحدة
Pollen API	طلب واحد
Solar API	طلب واحد

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

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

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

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

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

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

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

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

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

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

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

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

الشكل 2: جدول الفوترة الذي يعرض عناصر الاستخدام والتكلفة حسب رمز التخزين التعريفي

الشكل 3: فلاتر تقرير الفوترة

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

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

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

لتصنيف مصدر استخدامك بالإضافة إلى المنتج، يمكنك تجميع تقارير الفوترة حسب إحدى القيم المدرَجة. المفاتيح الثلاثة المرتبطة بواجهات برمجة تطبيقات Google Maps Platform هي goog-maps-api-key-suffix (الأحرف الأربعة الأخيرة من مفتاح واجهة برمجة التطبيقات) وgoog-maps-platform-type (النظام الأساسي: Android أو iOS أو JavaScript أو خدمة ويب) و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

• Maps JavaScript API

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

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

ملاحظة: لا تتوفّر بيانات القنوات لحزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل Android، وحزمة تطوير البرامج (SDK) للخرائط لنظام التشغيل iOS، وواجهة برمجة التطبيقات Places API (الإصدار الجديد)، وAddress Validation API، وAerial View API، وAir Quality API، وMap Tiles API، وMaps Datasets API، وRoads API، وRoutes API، وPollen API، وSolar API، وRoute Optimization API.

الشكل 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.

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

  #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 في تقرير "الاستخدام"، ويشير إلى ما إذا كان الطلب المقابل يظهر في تقارير "الاستخدام" و"الحصة" و"الفوترة".

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

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

رموز الاستجابة المتاحة في ردود Maps API		متوفّرة في تقرير "الاستخدام"	تم الإبلاغ إلى
حالة واجهة برمجة التطبيقات للخرائط	رمز استجابة HTTP	فئة رمز استجابة HTTP	الاستخدام	الحصة	الفوترة
حسنًا	200, 204, 302	‎2xx، ‎3xx	نعم	نعم	نعم
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS	200، 404	4xx^1	نعم	نعم	نعم
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, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200، 403، 429	4xx^1	نعم	لا	لا
UNKNOWN_ERROR	200, 500, 503	5xx^1	نعم	نعم	لا
^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" إحصاءات عن كيفية تفاعل المستخدمين مع خرائطك. وتشمل هذه الإحصاءات مقاييس التفاعل الرئيسية، مثل عدد المشاهدات على الخريطة أو التفاعلات مع نقطة الاهتمام. يمكنك تحليل هذه الإحصاءات للتعرّف على المواقع الجغرافية الرائجة للإعلان والتسويق أو لتحسين تجربة المستخدِم.

تشمل إمكانات إعداد تقارير "معلومات مفيدة للنشاط التجاري" ما يلي:

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

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

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

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

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

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

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

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

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