تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

افتح صفحة "منصة خرائط Google" في Cloud Console:
الانتقال إلى صفحة "منصة خرائط Google"
اختَر نظرة عامة في القائمة اليمنى.

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

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

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

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

افتح صفحة "منصة خرائط Google" في Cloud Console:
الانتقال إلى صفحة "منصة خرائط Google"
في القائمة اليمنى، اختَر واجهات برمجة التطبيقات (APIs).

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

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

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

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

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

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

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

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

افتح صفحة "منصة خرائط Google" في Cloud Console:
الانتقال إلى صفحة "منصة خرائط Google"
انقر على المقاييس في القائمة اليمنى.

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

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

تنسيق بيانات الاعتماد المعنى

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

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

رقم المشروع
على سبيل المثال، "project_number:123456"، حيث يكون 123456 هو رقم مشروعك.

هناك احتمالان لظهور بيانات الاعتماد هذه:

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

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

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

حالة واجهة برمجة التطبيقات للخرائط	فئة رمز استجابة HTTP - تقرير الاستخدام (2xx، 3xx، 4xx، 5xx)	Notes
حسنًا	2xx	استجابة ناجحة هذا طلب قابل للفوترة وسيستهلك مساحة تخزين.
حسنًا	3xx	استجابة ناجحة هذا طلب قابل للفوترة وسيستهلك مساحة تخزين. على سبيل المثال، يعرض طلب صورة المكان بنجاح عملية إعادة التوجيه 302 إلى الصورة المُشار إليها.
DATA_NOT_AVAILABLE	4xx⁽¹⁾	ردّ ناجح يشير إلى عدم توفّر بيانات للمواقع الجغرافية التي تم إدخال البيانات منها هذا طلب قابل للفوترة وسيستهلك مساحة تخزين.
ZERO_RESULTS	4xx⁽¹⁾	لم تعرض الاستجابة الناجحة أي نتائج. هذا طلب قابل للفوترة وسيستهلك مساحة تخزين.
NOT_FOUND	4xx⁽¹⁾	بالنسبة إلى Directions API، تشير هذه الرسالة إلى أنّه لا يمكن الترميز الجغرافي لموقع واحد على الأقل من المواقع الجغرافية المحدَّدة في أصل الطلب أو وجهته أو نقاط الطريق. بالنسبة إلى Places API، تشير هذه الرسالة إلى أنّه لم يتم العثور على الموقع المُشار إليه (place_id) في قاعدة بيانات الأماكن. هذا طلب قابل للفوترة وسيستهلك مساحة تخزين.
SELECTED_REQUEST (قيمة معلَمة غير صالحة) MAX_WAYPOINTS_EXCEEDED MAX_ROUTE_LENGTH_EXCEEDED وغير ذلك	4xx	حدث خطأ بسبب قيمة معلَمة غير صالحة. يمكنك الاطّلاع على رد واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل. هذا طلب قابل للفوترة وسيستهلك مساحة تخزين.
REQUEST_DENIED	4xx	خطأ في العميل ناتج عن خطأ في المصادقة أو خطأ في الوصول أو غير ذلك. يمكنك الاطّلاع على رد واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، Resource_EXHAUSTED، معدّل تم تجاوزه، dailylimitExceeded، userRatelimited	4xx	خطأ في العميل ناتج عن عدد كبير جدًا من الطلبات لكل فترة زمنية مسموح بها. يُرجى إعادة محاولة الطلب في وقت لاحق. يمكنك الاطّلاع على رد واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
POINTS_REQUEST (معلمة غير صالحة أو مفقودة، أو خطأ في تحليل الطلب أو خطأ في التحقق)	4xx	خطأ في العميل ناتج عن طلب غير صالح. يمكنك التحقّق من رد واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
NOT_FOUND (404)	4xx	بالنسبة إلى واجهة برمجة التطبيقات للمواقع الجغرافية، تشير هذه الرسالة إلى أنّ الإدخالات لم تكن كافية لتقديم تقدير للموقع الجغرافي. بالنسبة إلى Roads API، تشير هذه الرسالة إلى أنّه تعذّر نقل المدخلات بشكل معقول إلى الطرق. هذا طلب قابل للفوترة وسيستهلك مساحة تخزين.
UNKNOWN_ERROR	5xx	خطأ في الخادم يشير إلى تعذُّر متابعة الطلب: خطأ داخلي أو تحميل زائد على الخدمة أو غير متاح أو انتهاء المهلة أو غير ذلك.
¹ لتحسين اتساق تقارير رموز الخطأ، يتم نقل واجهات برمجة التطبيقات في "منصة خرائط Google" بما يلي: 1) من فئة رمز استجابة HTTP `2xx` إلى `4xx` لحالات واجهة برمجة التطبيقات Maps API: `DATA_NOT_AVAILABLE` أو `NOT_FOUND` أو `ZERO_RESULTS` - الحالة أو 2) من فئة رمز استجابة HTTP `2xx` إلى `4xx` لحالات واجهة برمجة التطبيقات Maps API: `REQUEST_DENIED` و`OVER_DAILY_LIMIT` `OVER_QUERY_LIMIT` و`OVER_QUERY_LIMIT` و`dailyLimitExceeded` و`dailyLimitExceeded` و `dailyLimitExceeded` و`dailyLimitExceeded` والفئة `rateLimitExceeded`, {3/رمز الاستجابة: `rateLimitExceeded`, `4xx`,`rateLimitExceeded`, `4xx2xxuserRateLimitExceeded5xxUNKNOWN_ERROR` يمكنك رؤية رمزي الاستجابة أثناء الفترة الانتقالية. لن تتغير رموز الاستجابة التي يتم عرضها في ردود Maps API. تأكَّد من أنّ الزيادة في مقياس "`4xx`" و/أو "`5xx`" في مقاييس "منصة خرائط Google" مرتبطة بعملية نقل البيانات هذه، وذلك من خلال التحقّق من رمز الاستجابة الدقيق الذي يزيد في مستكشف المقاييس (مزيد من المعلومات حول استخدام "مراقبة Google Cloud لمنصة خرائط Google").

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

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

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

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

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

تقارير الحصص

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

افتح صفحة أداة اختيار المشروع في Cloud Console:
صفحة أداة اختيار المشروع
اختَر مشروعًا.
اختَر زر القائمة ثم اختَر الفوترة.
إذا كانت لديك حسابات فوترة متعدّدة، اختَر الانتقال إلى حساب الفوترة المرتبط لفتح صفحة نظرة عامة لحساب الفوترة المرتبط.
في القائمة اليمنى، اختَر التقارير لفتح صفحة تقارير الفوترة لحساب الفوترة المرتبط.

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

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

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

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

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

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

لقطة شاشة لفلاتر تقرير الفوترة — **الشكل 3:** فلاتر تقرير الفوترة.

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

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

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

لتصنيف مصدر الاستخدام بالإضافة إلى المنتج، تجميع تقارير الفوترة حسب إحدى القيم المدرجة. المفاتيح الثلاثة المرتبطة بواجهات برمجة التطبيقات لمنصة خرائط 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.

الفلترة حسب التصنيفات — **الشكل 4:** الفلترة حسب رمز التخزين التعريفي والقنوات

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

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

يمكنك التجميع حسب مفتاح التصنيف 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 هو اسم مجموعة البيانات التي أنشأتها (مثل "عيّنة بيانات").
إنّ BILLING_ACCOUNT_ID هو مرجع لمعرّف حساب الفوترة، يبدأ بـ "gcp_billing_exportv1"، مع تغيير الشرطات (-) إلى شرطات سفلية (_). على سبيل المثال، سيصبح رقم تعريف حساب الفوترة 123456-7890AB-CDEF01 هو gcp_billing_export_v1_123456_789AB_CDEF01.

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

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

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

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

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

يوفّر تقرير الاستخدام في مقاييس "منصة خرائط 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¹	نعم	نعم	نعم
SELECTED_REQUEST (قيمة معلَمة غير صالحة)، MAX_ROUTE_LENGTH_EXCEEDED، MAX_WAYPOINTS_EXCEEDED، إلخ.	200، 400	4xx	نعم	نعم	نعم
SELECTED_REQUEST (معلمة غير صالحة/مفقودة، خطأ في تحليل الطلب)	200، 400	4xx	نعم	لا	لا
REQUEST_DENIED	200، 400، 403	4xx¹	نعم	لا	لا
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, Resource_EXHAUSTED, dailyboundExceeded, ratelimitedExceeded, userRatelimited	200، 403، 429	4xx¹	نعم	لا	لا
UNKNOWN_ERROR	200، 500، 503	5xx¹	نعم	نعم	لا
¹ لتحسين اتساق تقارير رموز الخطأ، يتم نقل واجهات برمجة التطبيقات في "منصة خرائط Google" بما يلي: 1) من فئة رمز استجابة HTTP `2xx` إلى `4xx` لحالات واجهة برمجة التطبيقات Maps API: `DATA_NOT_AVAILABLE` أو `NOT_FOUND` أو `ZERO_RESULTS` - الحالة أو 2) من فئة رمز استجابة HTTP `2xx` إلى `4xx` لحالات واجهة برمجة التطبيقات Maps API: `REQUEST_DENIED` و`OVER_DAILY_LIMIT` `OVER_QUERY_LIMIT` و`dailyLimitExceeded` و`dailyLimitExceeded` و`dailyLimitExceeded` و`dailyLimitExceeded` و`dailyLimitExceeded` والفئة `rateLimitExceeded`{1/رمز الاستجابة: `rateLimitExceeded`, `4xx`, `rateLimitExceeded`, `4xx`.`2xxuserRateLimitExceeded5xxUNKNOWN_ERROR` يمكنك رؤية رمزي الاستجابة أثناء الفترة الانتقالية. لن تتغير رموز الاستجابة التي يتم عرضها في ردود Maps API. تأكَّد من أنّ الزيادة في مقياس "`4xx`" و/أو "`5xx`" في مقاييس "منصة خرائط Google" مرتبطة بعملية نقل البيانات هذه، وذلك من خلال التحقّق من رمز الاستجابة الدقيق الذي يزيد في مستكشف المقاييس (مزيد من المعلومات حول استخدام "مراقبة Google Cloud لمنصة خرائط Google").

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

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

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

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

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

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

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

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

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

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

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

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

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

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

محدد مواقع الويب Plus

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

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

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

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