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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تشتمل صفحة نظرة عامة في خرائط 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. انقر على المقاييس في القائمة اليمنى.

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

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

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

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

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

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

لفهم طريقة استخدام الحلول وطرق تحسين حلولنا، تتضمّن 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 JavaScript API، تكون وحدة الحصة هي تحميل خريطة.
• بالنسبة إلى حزمة تطوير البرامج (SDK) لـ "خرائط Google" لنظام التشغيل Android وحزمة تطوير البرامج "لخرائط 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 (مصفوفة الطرق الحوسبية)	عنصر واحد (زوج الأصل-الوجهة)
Directions API	طلب واحد
Distance Matrix API	عنصر واحد (زوج الأصل-الوجهة)
Roads API	طلب واحد
أماكن
واجهة برمجة تطبيقات الأماكن	طلب واحد
Address Validation API	طلب واحد
Geocoding API	طلب واحد
Geolocation API	طلب واحد
Time Zone API	طلب واحد
البيئة
واجهة برمجة التطبيقات لجودة الهواء (CurrentConditions وheatmapTile)	طلب واحد
Air Quality 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 الرئيسية.

ملاحظة: في الوقت الحالي، لا تتوفّر بيانات القناة للطرق - رمز التخزين التعريفي للمسار، والطرق - رمز التخزين التعريفي للطريق الأقرب، ورمز التخزين التعريفي للطرق - حدود السرعة، وحزمة تطوير البرامج لتطبيق "خرائط Google" لنظام التشغيل Android، وحزمة تطوير البرامج بالاستناد إلى "خرائط Google" لنظام التشغيل iOS.

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

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

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

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

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

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

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

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

رموز الاستجابة المتاحة في ردود API للخرائط		متاح في تقرير الاستخدام	تم الإبلاغ إلى
حالة API للخرائط	رمز استجابة HTTP	فئة رمز استجابة HTTP	الاستخدام	الحصة	الإذن بالوصول إلى الفوترة
حسنًا	200، 204، 302	2xx، 3xx	نعم	نعم	نعم
DATA_NOT_AVAILABLE، NOT_FOUND، ZERO_RESULTS	200	4xx^1	نعم	نعم	نعم
NOT_FOUND (واجهات برمجة تطبيقات صور التجوّل الافتراضي الثابتة والمواقع الجغرافية والطرق)، ZERO_RESULTS (واجهة برمجة تطبيقات صور التجوّل الافتراضي الثابتة)	404	4xx	نعم	نعم	نعم
INVALID_REQUEST (قيمة مَعلمة غير صالحة)، MAX_ROUTE_LENGTH_EXCEEDED، MAX_WAYPOINTS_EXCEEDED، إلخ.	200/400	4xx	نعم	نعم	نعم
INVALID_REQUEST (معلمة غير صالحة/مفقودة، خطأ في تحليل الطلب)	200/400	4xx	نعم	لا	لا
REQUEST_DENIED	403/400/200	4xx^1	نعم	لا	لا
OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، Resource_EXHAUSTED، dailylimitExceeded، ratelimitExceeded، userRatelimitتجاوز	200/403، 429	4xx^1	نعم	لا	لا
UNKNOWN_ERROR	200/500، 503	5xx^1	نعم	نعم	لا
^1 لتحسين اتساق إعداد تقارير رموز الخطأ، يتم نقل واجهات برمجة التطبيقات في "منصة خرائط Google": 1) من فئة رمز استجابة HTTP 2xx إلى 4xx لحالات API للخرائط: DATA_NOT_AVAILABLE أو NOT_FOUND أو ZERO_RESULTS - الحالة, 2) من فئة رمز استجابة HTTP 2xx إلى 4xx لحالات واجهة برمجة التطبيقات للخرائط: REQUEST_DENIED، OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، OVER_QUERY_LIMIT، dailyLimitExceeded، {1 الخرائط/الخرائط/}، {1 الخرائط/2xx/}، {1 /2xx/}، rateLimitExceeded،userRateLimitExceeded5xxUNKNOWN_ERROR يمكنك رؤية رمزي الاستجابة أثناء فترة الانتقال. لا يتم تغيير رموز الاستجابة التي يتم عرضها في ردود API للخرائط. تأكَّد من أنّ الزيادة في مقياس 4xx و/أو 5xx في مقاييس منصة خرائط Google مرتبطة بعملية النقل هذه، وذلك من خلال التحقّق من رمز الاستجابة الدقيق الذي يزيد في مستكشف المقاييس (مزيد من المعلومات حول استخدام Google Cloud Monitoring في "منصة خرائط Google").

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Locator Plus

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

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

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

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