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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

هناك احتمالان إذا رأيت بيانات الاعتماد هذه:

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

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

يُقسِّم الرسم البياني عدد الزيارات حسب رمز الاستجابة والخطأ حسب رمز الاستجابة الاستخدام حسب فئة رمز استجابة HTTP. يعرض هذا الجدول التخطيط بين حالة الاستجابة لواجهة برمجة التطبيقات في Google Maps Platform وفئة رمز استجابة 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) لم يتم العثور عليه في قاعدة بيانات الأماكن. هذا طلب قابل للفوترة وسيستهلك حصة.
CREDIT_REQUEST (قيمة مَعلمة غير صالحة)، MAX_WAYPOINTS_EXCEEDED MAX_ROUTE_LENGTH_EXCEEDED وغير ذلك	4xx	حدث خطأ ناتج عن قيمة معلَمة غير صالحة. لمزيد من التفاصيل، يمكنك الاطّلاع على استجابة واجهة برمجة التطبيقات. هذا طلب قابل للفوترة وسيستهلك حصة.
REQUEST_DENIED	4xx	خطأ في العميل تسبّب في حدوث خطأ في المصادقة وخطأ في الوصول وغير ذلك. لمزيد من التفاصيل، يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات.
OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، LOCATION_EXHAUSTED، rateLimitExceeded، dailyLimitExceeded، userRatelimitedExceeded	4xx	حدث خطأ في العميل نتيجة وجود عدد كبير جدًا من الطلبات خلال فترة زمنية مسموح بها. يُرجى إعادة محاولة الطلب في وقت لاحق. لمزيد من التفاصيل، يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات.
Value_REQUEST (معلمة غير صالحة أو مفقودة، طلب في تحليل أو خطأ في التحقق من الصحة)	4xx	حدث خطأ في العميل نتيجة طلب غير صالح. يمكنك الاطّلاع على رد واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
NOT_FOUND (404)	4xx	بالنسبة إلى Geolocation API، تشير هذه الرسالة إلى أنّ البيانات التي تمّ إدخالها لم تكن كافية لتقديم تقدير للموقع الجغرافي. بالنسبة إلى واجهة برمجة التطبيقات للطرق، تشير هذه الرسالة إلى تعذّر توصيل المدخلات بشكل معقول إلى الطرق. هذا طلب قابل للفوترة وسيستهلك حصة.
UNKNOWN_ERROR	5xx	خطأ في الخادم يشير إلى تعذّر متابعة الطلب: خطأ داخلي أو تحميل الخدمة بشكل زائد أو عدم توفّره أو انتهاء المهلة وغير ذلك.
¹ لتحسين اتساق إعداد تقارير رموز الخطأ، يتم نقل واجهات برمجة التطبيقات في "منصة خرائط Google": 1) من فئة رمز استجابة HTTP `2xx` إلى `4xx` للحالات الخاصة بواجهة برمجة تطبيقات الخرائط: `DATA_NOT_AVAILABLE` و`NOT_FOUND` `ZERO_RESULTS` - الحالة، 2) من فئة رمز استجابة HTTP `2xx` إلى `4xx` لحالات واجهة برمجة التطبيقات في "خرائط Google": `REQUEST_DENIED`، `OVER_DAILY_LIMIT`، `OVER_QUERY_LIMIT`، `dailyLimitExceeded`، رمز الاستجابة `rateLimitExceeded` من `rateLimitExceeded` و`rateLimitExceeded` للخرائط `rateLimitExceeded`، {3)`2xxuserRateLimitExceeded5xxUNKNOWN_ERROR` يمكنك الاطلاع على رمزي الاستجابة كلاهما أثناء الفترة الانتقالية. لن تتغير رموز الاستجابة التي يتم عرضها في الردود من واجهة برمجة التطبيقات للخرائط. تأكّد من أنّ الزيادة في `4xx` و/أو `5xx` في مقاييس منصة "خرائط Google" مرتبطة بعملية النقل هذه، وذلك من خلال التحقّق من زيادة رمز الاستجابة بالضبط في أداة البحث عن المقاييس (مزيد من المعلومات حول استخدام "مراقبة السحابة الإلكترونية من Google" لمنصة "خرائط 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" (واجهة برمجة التطبيقات الثابتة لخرائط Google وواجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" وواجهة برمجة التطبيقات Geocoding API وDirections API وPlaces API وTime Zone API وGeolocation API وElevation API) ولكن هناك بعض الاستثناءات:

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

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

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

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

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

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

واجهة برمجة التطبيقات على "منصة خرائط Google"	وحدة الحصة
Maps
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android	بانوراما واحدة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS	بانوراما واحدة
Map Tiles API	طلب واحد
واجهة برمجة التطبيقات للعرض الجوي في "خرائط Google"	طلب واحد
Maps Static API	طلب واحد
Maps JavaScript API	تحميل خريطة واحد
Street View Static API	طلب واحد
Maps Embed API	تحميل خريطة واحد
المسارات
Routes API (حوسبة المسارات)	طلب واحد
Routes API (Compute Route Matrix)	عنصر واحد (زوج المصدر-الوجهة)
Directions API	طلب واحد
Distance Matrix API	عنصر واحد (زوج المصدر-الوجهة)
Roads API	طلب واحد
واجهة Route Optimization API	طلب واحد
أماكن
واجهة برمجة تطبيقات الأماكن	طلب واحد
Address Validation API	طلب واحد
Geocoding API	طلب واحد
Geolocation API	طلب واحد
Time Zone API	طلب واحد
البيئة
واجهة برمجة تطبيقات جودة الهواء (CurrentConditions وHeartmapTile)	طلب واحد
واجهة برمجة تطبيقات جودة الهواء (السجلّ)	صفحة واحدة
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 أو webservice) وgoog-maps-channel (قيمة قناة رقمية محدّدة من طلب بحث واجهة برمجة التطبيقات). مزيد من المعلومات حول التصفية والتجميع.

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

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

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

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

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

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

لتتبُّع استخدامك عبر القنوات الرقمية، يجب إضافة المَعلمة channel إلى طلبات البيانات من واجهة برمجة التطبيقات. يُرجى العلم أنّ قيم القناة الوحيدة المقبولة هي الأرقام من 0 إلى 999. وفي ما يلي بعض الأمثلة على ذلك:

واجهة برمجة تطبيقات Geocoding Web Service API

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

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

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

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

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

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

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

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

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

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

هذا المنتج أو هذه الميزة تجريبي (ما قبل التوفّر للجمهور العام). قد يتوفّر دعم محدود للمنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام، وقد لا تتوافق التغييرات في المنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام مع الإصدارات الأخرى المتاحة في مرحلة ما قبل التوفّر للجمهور العام. تخضع "عروض مرحلة ما قبل التوفّر للجمهور العام" للأحكام الخاصة بخدمة "منصة خرائط 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 أيام.