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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تنسيق بيانات الاعتماد	المعنى
اسم المفتاح على سبيل المثال، "مفتاح التطبيق المتوافق مع الأجهزة الجوّالة"	تم استخدام مفتاح واجهة برمجة التطبيقات لتحميل واجهة برمجة التطبيقات باستخدام ?key=...: يمكنك العثور على أسماء المفاتيح في وحدة التحكّم في "منصة الخرائط" ضمن المفاتيح وبيانات الاعتماد.
رقم المشروع على سبيل المثال، "project_number:123456"، حيث يشير 123456 إلى رقم مشروعك.	هناك احتمالان لظهور بيانات الاعتماد هذه: بالنسبة إلى واجهات برمجة التطبيقات التي تقبل معرّفات عملاء "منصة الخرائط": تم استخدام معرّف عميل "منصة الخرائط" لتحميل واجهة برمجة التطبيقات. على سبيل المثال، باستخدام &client=gme-_mycompany_. وتقبل واجهات برمجة التطبيقات هذه معرِّفات العميل التالية: واجهة برمجة تطبيقات JavaScript للخرائط، وواجهة برمجة تطبيقات الخرائط الثابتة، وواجهة برمجة تطبيقات التجوّل الافتراضي الثابتة، وواجهة برمجة التطبيقات Elevation، وواجهة برمجة تطبيقات الاتجاهات، وواجهة برمجة تطبيقات مصفوفة المسافة، وواجهة برمجة تطبيقات الترميز الجغرافي، وواجهة برمجة تطبيقات المنطقة الزمنية. لمزيد من المعلومات، اطّلع على إدارة معرِّفات العميل للخطة المميّزة. بالنسبة إلى واجهات برمجة التطبيقات التي تقبل بروتوكول OAuth: تم تحميل واجهة برمجة التطبيقات باستخدام OAuth بدون مفتاح واجهة برمجة التطبيقات.

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

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

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

حالة API للخرائط	فئة رمز استجابة HTTP - تقرير الاستخدام (2xx، 3xx، 4xx، 5xx)	Notes
حسنًا	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، تم تجاوز الحد الأقصى للسعر، dailyLimitExceeded، userRateLimitExceeded	4xx	حدث خطأ في العميل بسبب كثرة الطلبات لكل فترة زمنية مسموح بها. أعِد محاولة الطلب في وقت لاحق. يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
INVALID_REQUEST (معلمة غير صالحة أو مفقودة، خطأ في تحليل الطلب أو التحقق من الصحة)	4xx	حدث خطأ في العميل بسبب طلب غير صالح. يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
NOT_FOUND (404)	4xx	بالنسبة إلى واجهة برمجة التطبيقات للمواقع الجغرافية، تشير هذه الرسالة إلى أنّ الإدخالات لم تكن كافية لتقديم تقدير للموقع الجغرافي. بالنسبة إلى Roads API، تشير هذه الرسالة إلى تعذّر محاذاة الإدخالات بشكل معقول إلى الطرق. هذا طلب قابل للفوترة وسوف يستهلك حصة من مساحة التخزين.
UNKNOWN_ERROR	5xx	خطأ في الخادم يشير إلى تعذُّر متابعة الطلب: خطأ داخلي أو زيادة تحميل على الخدمة أو غير متاحة أو انتهاء المهلة أو غير ذلك.
^1 لتحسين اتساق تقارير رموز الخطأ، يتم نقل واجهات برمجة التطبيقات في "منصة خرائط Google": 1) من فئة رمز استجابة HTTP 2xx إلى 4xx لحالات واجهة برمجة تطبيقات الخرائط: DATA_NOT_AVAILABLE، NOT_FOUND، ZERO_RESULTS - الحالة، 2) من فئة رمز استجابة HTTP 2xx إلى 4xx لحالات واجهة برمجة تطبيقات الخرائط: REQUEST_DENIED، OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، OVER_QUERY_LIMIT، dailyLimitExceeded، رمز الاستجابة لـ rateLimitExceeded، dailyLimitExceeded، rateLimitExceeded, rateLimitExceeded, rateLimitExceeded, rateLimitExceeded, dailyLimitExceededالاستجابة: rateLimitExceeded, rateLimitExceeded2xxuserRateLimitExceeded5xxUNKNOWN_ERROR يمكنك رؤية رمزي الاستجابة أثناء الفترة الانتقالية. لن تتغيّر رموز الاستجابة التي يتم عرضها في ردود Maps API. تأكّد من أنّ الزيادة في 4xx و/أو 5xx في مقاييس منصة خرائط Google مرتبطة بعملية نقل البيانات هذه من خلال التحقّق من رمز الاستجابة الدقيق الذي يزيد في مستكشف المقاييس (مزيد من المعلومات حول استخدام "مراقبة Google Cloud للمنصة" في "منصة خرائط Google").

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

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

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

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

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

تقارير الحصص

تضبط الحصص حدودًا لعدد الطلبات التي يمكن لمشروعك إرسالها إلى واجهات برمجة التطبيقات في "منصة خرائط 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 JavaScript API، تكون وحدة الحصة عبارة عن تحميل خريطة.
• بالنسبة إلى حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android وحزمة SDK الخاصة بخرائط Google لنظام التشغيل iOS، تكون وحدة الحصة عبارة عن طلب التجوّل الافتراضي أو تحميل بانوراما. تتوفّر أحمال الخريطة بدون أي رسوم ولا تستهلك حصة من مساحة التخزين.

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

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

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

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

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

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

واجهة برمجة التطبيقات على "منصة خرائط Google"	وحدة الحصة
الخرائط
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android	بانوراما واحدة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS	بانوراما واحدة
واجهة برمجة تطبيقات مربّعات الخرائط	طلب واحد
واجهة برمجة تطبيقات Maps Aerial View	طلب واحد
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	طلب واحد
أماكن
واجهة برمجة تطبيقات الأماكن	طلب واحد
Address Validation API	طلب واحد
Geocoding API	طلب واحد
Geolocation API	طلب واحد
Time Zone API	طلب واحد
البيئة
Air Quality API (CurrentConditions وHimapTile)	طلب واحد
Air Quality API (السجلّ)	صفحة واحدة
Pollen API	طلب واحد
Solar 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 أو خدمة الويب) و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 الرئيسية.

ملاحظة: لا تتوفّر بيانات القناة لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android، وحزمة تطوير البرامج لتطبيق "خرائط Google" على نظام التشغيل iOS، وواجهة برمجة تطبيقات الأماكن (جديدة)، وواجهة برمجة تطبيقات التحقّق من صحة العنوان، وواجهة برمجة تطبيقات Aerial View، وواجهة برمجة تطبيقات Air Quality، وواجهة برمجة تطبيقات Map Tiles، وواجهة برمجة تطبيقات الطرق، Routes API، وPollen API، وSolar 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 أو تعديله أو إغلاقه
• تعديل إعدادات الفوترة لمشروع
• عرض تقارير الفوترة ومؤشرات التكلفة
• ضبط تنبيهات الميزانيات والميزانيات
• الحد الأقصى لاستخدام واجهة برمجة التطبيقات

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

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

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

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

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

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

رموز الاستجابة المتاحة في ردود Maps API		متاح في تقرير الاستخدام	تم الإبلاغ إلى
حالة 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، dailyLimit الاستهدافed، ratelimit تم تجاوز الحد، userRateLimitExceeded	200، 403، 429	4xx^1	نعم	لا	لا
UNKNOWN_ERROR	200، 500، 503	5xx^1	نعم	نعم	لا
^1 لتحسين اتساق تقارير رموز الخطأ، يتم نقل واجهات برمجة التطبيقات في "منصة خرائط Google": 1) من فئة رمز استجابة HTTP 2xx إلى 4xx لحالات واجهة برمجة تطبيقات الخرائط: DATA_NOT_AVAILABLE، NOT_FOUND، ZERO_RESULTS - الحالة، 2) من فئة رمز استجابة HTTP 2xx إلى 4xx لحالات واجهة برمجة تطبيقات الخرائط: REQUEST_DENIED، OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، OVER_QUERY_LIMIT، dailyLimitExceeded، رمز الاستجابة لـ rateLimitExceeded، dailyLimitExceeded، rateLimitExceeded, rateLimitExceeded, rateLimitExceeded, rateLimitExceeded, dailyLimitExceededالاستجابة: rateLimitExceeded, rateLimitExceeded2xxuserRateLimitExceeded5xxUNKNOWN_ERROR يمكنك رؤية رمزي الاستجابة أثناء الفترة الانتقالية. لن تتغيّر رموز الاستجابة التي يتم عرضها في ردود Maps API. تأكّد من أنّ الزيادة في 4xx و/أو 5xx في مقاييس منصة خرائط Google مرتبطة بعملية نقل البيانات هذه من خلال التحقّق من رمز الاستجابة الدقيق الذي يزيد في مستكشف المقاييس (مزيد من المعلومات حول استخدام "مراقبة Google Cloud للمنصة" في "منصة خرائط Google").

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Locator Plus

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

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

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

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