اشترك لتوفير المال! لمزيد من المعلومات، يُرجى الاطّلاع على الاشتراكات.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بالنسبة إلى واجهات برمجة التطبيقات التي تقبل معرّفات عملاء "منصة خرائط Google": تم استخدام معرّف عميل "منصة خرائط Google" لتحميل واجهة برمجة التطبيقات. على سبيل المثال، باستخدام &client=gme-_mycompany_.
تقبل واجهات برمجة التطبيقات التالية معرّفات العملاء: Maps JavaScript API وMaps Static API وStreet View Static API وElevation API وDirections API (القديمة) وDistance Matrix API (القديمة) وGeocoding API وTime Zone API. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة معرّف العميل في خطة Premium.
بالنسبة إلى واجهات برمجة التطبيقات التي تقبل OAuth: تم تحميل واجهة برمجة التطبيقات باستخدام OAuth بدون مفتاح واجهة برمجة التطبيقات.

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

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

حالة Maps API	فئة رمز استجابة HTTP - تقرير الاستخدام (2xx و3xx و4xx و5xx)	ملاحظات
حسنًا	2xx	استجابة ناجحة. هذا الطلب قابل للفوترة وسيستهلك من الحصة.
حسنًا	3xx	استجابة ناجحة. هذا الطلب قابل للفوترة وسيستهلك من الحصة. على سبيل المثال، تعرض الطلبات الناجحة في صورة المكان إعادة توجيه 302 إلى الصورة المرجعية.
DATA_NOT_AVAILABLE	‫4xx⁽¹⁾	ردّ ناجح يشير إلى عدم توفّر بيانات للمواقع الجغرافية التي تم إدخالها هذا الطلب قابل للفوترة وسيستهلك من الحصة.
ZERO_RESULTS	‫4xx⁽¹⁾	لم يعرض الردّ الناجح أي نتيجة. هذا الطلب قابل للفوترة وسيستهلك من الحصة.
NOT_FOUND	‫4xx⁽¹⁾	بالنسبة إلى Directions API (الإصدار القديم)، تشير هذه الرسالة إلى أنّه تعذّر ترميز موقع جغرافي واحد على الأقل من المواقع المحدّدة في نقطة الانطلاق أو الوجهة أو النقاط على المسار في الطلب. بالنسبة إلى Places API، تشير هذه الرسالة إلى أنّه لم يتم العثور على الموقع الجغرافي المُشار إليه (place_id) في قاعدة بيانات "الأماكن". هذا الطلب قابل للفوترة وسيستهلك من الحصة.
‫INVALID_REQUEST (قيمة مَعلمة غير صالحة)، ‫MAX_WAYPOINTS_EXCEEDED، ‫MAX_ROUTE_LENGTH_EXCEEDED، وغيرها.	4xx	حدث خطأ بسبب قيمة مَعلمة غير صالحة. يُرجى الاطّلاع على ردّ واجهة برمجة التطبيقات لمزيد من التفاصيل. هذا الطلب قابل للفوترة وسيستهلك من الحصة.
REQUEST_DENIED	4xx	خطأ لجهة العميل ناتج عن خطأ في المصادقة وخطأ في الوصول وغير ذلك يُرجى الاطّلاع على الردّ من واجهة برمجة التطبيقات لمزيد من التفاصيل.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded	4xx	خطأ في العميل ناتج عن عدد كبير جدًا من الطلبات لكل فترة زمنية مسموح بها. يُرجى إعادة المحاولة لاحقًا. يُرجى الاطّلاع على ردّ من واجهة برمجة التطبيقات لمزيد من التفاصيل.
‫INVALID_REQUEST (مَعلمة غير صالحة أو غير متوفّرة، أو خطأ في تحليل الطلب أو التحقّق من صحته)	4xx	خطأ في العميل ناتج عن طلب غير صالح يُرجى الاطّلاع على الردّ من واجهة برمجة التطبيقات لمزيد من التفاصيل.
NOT_FOUND (404)	4xx	بالنسبة إلى Directions API (القديمة): تشير هذه الرسالة إلى أنّه تعذّر ترميز موقع جغرافي واحد على الأقل من المواقع المحدّدة في نقطة الانطلاق أو الوجهة أو النقاط على المسار في الطلب. بالنسبة إلى Geolocation API، تشير هذه الرسالة إلى أنّ البيانات التي تم إدخالها لم تكن كافية لتقديم تقدير للموقع الجغرافي. بالنسبة إلى 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 وdailyLimitExceeded وrateLimitExceeded وuserRateLimitExceeded، 3) من فئة رمز استجابة HTTP ‏2xx إلى 5xx لحالة Maps API: ‏UNKNOWN_ERROR. يمكنك الاطّلاع على رمزَي الاستجابة خلال الفترة الانتقالية. لن تتغيّر رموز الاستجابة التي يتم عرضها في ردود Maps API. تأكَّد من أنّ الزيادة في 4xx و/أو 5xx في مقاييس "منصة خرائط Google" مرتبطة بعملية النقل هذه من خلال التحقّق من رمز الاستجابة الذي يزداد في مستكشف المقاييس (مزيد من المعلومات حول استخدام Google Cloud Monitoring في "منصة خرائط Google").

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

مَعلمة تحديد مصدر استخدام "منصة خرائط Google"

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

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

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

ملاحظة: لا تزال المَعلمة solution_channel صالحة وقد تظهر في عمليات التنفيذ الحالية، ولكن لم يعد يُنصح باستخدامها. يمكنك استخدام internal_usage_attribution_ids كبديل.

تقارير الحصص

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

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

للحصول على قيمة الحصة في الدقيقة لأي منتج من منتجات GMP API، استخدِم هذه الأداة الحسابية.

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

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

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

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

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

وحدة الحصة هي طلب لمعظم واجهات برمجة التطبيقات في "منصة خرائط Google" ( Maps Static API وStreet View Static API و Geocoding API وDirections API (القديمة) و Places API وTime Zone API و Geolocation API وElevation API)، ولكن هناك بعض الاستثناءات:

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

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

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

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

وحدات الحصة

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

واجهة برمجة تطبيقات "منصة خرائط Google"	وحدة الحصة
خرائط Google
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android	بطاقة إعلان بانورامية واحدة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS	صورة بانورامية واحدة
Map Tiles API	طلب واحد
Maps Aerial View API	طلب واحد
Maps Static API	طلب واحد
Maps JavaScript API	تحميل خريطة واحدة
Street View Static API	طلب واحد
Maps Embed API	تحميل خريطة واحدة
المسارات
‫Routes API (احتساب المسارات)	طلب واحد
‫Routes API (Compute Route Matrix)	عنصر واحد (زوج من نقطة الانطلاق والوجهة)
‫Directions API (القديمة)	طلب واحد
‫Distance Matrix API (الإصدار القديم)	عنصر واحد (زوج من نقطة الانطلاق والوجهة)
Roads API	طلب واحد
Route Optimization API	طلب واحد
حزمة تطوير البرامج للتنقّل على أجهزة Android	وجهة واحدة
حزمة تطوير البرامج للتنقّل على أجهزة iOS	وجهة واحدة
أماكن
واجهة برمجة تطبيقات الأماكن	طلب واحد
Places Aggregate API	طلب واحد
Address Validation API	طلب واحد
Geocoding API	طلب واحد
Geolocation API	طلب واحد
Time Zone API	طلب واحد
أدوات وكيل تجربة "خرائط Google"	طلب واحد
البيئة
‫Air Quality API (CurrentConditions وHeatmapTile)	طلب واحد
‫Air Quality API (السجلّ)	صفحة واحدة
Pollen API	طلب واحد
Solar API	طلب واحد
Weather API	طلب واحد

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لتصنيف مصدر الاستخدام بالإضافة إلى المنتج، يمكنك تجميع تقارير الفوترة حسب إحدى القيم المدرَجة. المفاتيح الثلاثة المرتبطة بواجهات برمجة التطبيقات في "منصة خرائط Google" هي goog-maps-api-key-suffix (الأحرف الأربعة الأخيرة من مفتاح واجهة برمجة التطبيقات) وgoog-maps-platform-type (المنصة: Android أو iOS أو JavaScript أو خدمة الويب) وgoog-maps-channel (قيمة قناة رقمية محدّدة من طلب بحث في واجهة برمجة التطبيقات). مزيد من المعلومات حول الفلترة والتجميع

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

مراقبة الاستهلاك وتقييده

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

وضع ميزانية

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

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

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

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

لتتبُّع استخدامك من خلال القنوات الرقمية، عليك إضافة المَعلمة "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

Maps JavaScript API

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

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

كيفية الفلترة باستخدام التصنيفات — **الشكل 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

‫Cloud Billing:

منصة خرائط Google:

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

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

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

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

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

المتاحة في مراقبة استخدام "منصة خرائط Google"

رموز الاستجابة المتاحة في ردود Maps API		متوفّر في تقرير الاستخدام	تم الإبلاغ إلى
حالة Maps API	رمز استجابة HTTP	فئة رمز استجابة HTTP	الاستخدام	الحصة	الفوترة
حسنًا	‫200, 204, 302	‫2xx، 3xx	نعم	نعم	نعم
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS	‫200، 404	4xx¹	نعم	نعم	نعم
‫INVALID_REQUEST (قيمة المَعلمة غير صالحة)، ‫MAX_ROUTE_LENGTH_EXCEEDED، ‫MAX_WAYPOINTS_EXCEEDED، وما إلى ذلك	‫200، 400	4xx	نعم	نعم	نعم
‫INVALID_REQUEST (مَعلمة غير صالحة أو غير متوفّرة، خطأ في تحليل الطلب)	‫200، 400	4xx	نعم	لا	لا
REQUEST_DENIED	‫200 و و400 و و403	4xx¹	نعم	لا	لا
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	‫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` و`rateLimitExceeded` و`userRateLimitExceeded`، 3) من فئة رمز استجابة HTTP ‏`2xx` إلى `5xx` لحالة Maps API: ‏`UNKNOWN_ERROR`. يمكنك الاطّلاع على رمزَي الاستجابة خلال الفترة الانتقالية. لن تتغيّر رموز الاستجابة التي يتم عرضها في ردود Maps API. تأكَّد من أنّ الزيادة في `4xx` و/أو `5xx` في مقاييس "منصة خرائط Google" مرتبطة بعملية النقل هذه من خلال التحقّق من رمز الاستجابة الذي يزداد في مستكشف المقاييس (مزيد من المعلومات حول استخدام Google Cloud Monitoring في "منصة خرائط Google").