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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. في القائمة اليمنى، حدد المقاييس.

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

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

حالة API للخرائط	فئة رمز استجابة HTTP - تقرير الاستخدام (2xx و3xx و4xx و5xx)	ملاحظات
حسنًا	2xx	تم الرد بنجاح. هذا طلب قابل للفوترة وسيستهلك الحصة.
حسنًا	3xx	تم الرد بنجاح. هذا طلب قابل للفوترة وسيستهلك الحصة. على سبيل المثال، تؤدي الطلبات الناجحة المتعلّقة بصورة المكان إلى عرض عملية إعادة توجيه 302 إلى الصورة المشار إليها.
البيانات غير متوفرة	4xx(1)	رد ناجح يشير إلى عدم توفر بيانات عن مواقع الإدخال. هذا طلب قابل للفوترة وسيستهلك الحصة.
ZERO_RESULTS	4xx(1)	لم تؤدِ الاستجابة الناجحة إلى أي نتيجة. هذا طلب قابل للفوترة وسيستهلك الحصة.
لم يتم العثور عليها	4xx(1)	بالنسبة إلى واجهة برمجة التطبيقات للاتجاهات، يشير ذلك إلى تعذُّر ترميز موقع جغرافي واحد على الأقل من المواقع الجغرافية المحدّدة في أصل الطلب أو وجهته أو نقاط الطريق. بالنسبة إلى واجهة برمجة تطبيقات الأماكن، يدل ذلك على أنه لم يتم العثور على الموقع الجغرافي المرجعي (place_id) في قاعدة بيانات "الأماكن". هذا طلب قابل للفوترة وسيستهلك الحصة.
INVALID_REQUEST (قيمة معلمة غير صالحة)، MAX_WAYPOINTS_EXCEEDED، MAX_ROUTE_LENGTH_EXCEEDED، ما إلى ذلك.	4xx	حدث خطأ بسبب قيمة معلمة غير صالحة. يمكنك الاطّلاع على استجابة واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل. هذا طلب قابل للفوترة وسيستهلك الحصة.
تم رفض الطلب	4xx	حدث خطأ في البرنامج ناجم عن خطأ في المصادقة، أو خطأ في الوصول، أو غير ذلك. يمكنك الاطّلاع على استجابة واجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، RESOURCE_EXHAUSTED، تم تجاوز المعدل، تم تجاوز اليومي اليومي، تم تجاوز userRateLimit	4xx	حدث خطأ في البرنامج بسبب وجود عدد كبير جدًا من الطلبات خلال الفترة الزمنية المسموح بها. أعِد محاولة الطلب في وقت لاحق. تحقَّق من استجابة واجهة برمجة التطبيقات لمزيد من التفاصيل.
INVALID_REQUEST (معلمة غير صالحة/مفقودة، خطأ في التحليل/التحقق من صحة الطلب)	4xx	حدث خطأ في العميل بسبب طلب غير صالح. تحقَّق من استجابة واجهة برمجة التطبيقات لمزيد من التفاصيل.
NOT_FOUND (404)	4xx	وبالنسبة إلى واجهة برمجة التطبيقات للموقع الجغرافي، يشير هذا إلى أن الإدخالات لم تكن كافية لتقديم تقدير للموقع الجغرافي. بالنسبة إلى واجهة برمجة التطبيقات للطرق، يشير ذلك إلى أنه لا يمكن التقاط المدخلات بشكل معقول على الطرق. هذا طلب قابل للفوترة وسيستهلك الحصة.
خطأ غير معروف	5xx	حدث خطأ في الخادم يشير إلى عدم إمكانية متابعة الطلب: خطأ داخلي، أو زيادة تحميل الخدمة، أو عدم التوفر، أو انتهاء المهلة، أو غير ذلك.
يمكنك رؤية كلا رمزي الاستجابة أثناء الفترة الانتقالية. لن تتغير رموز الاستجابة التي يتم عرضها في استجابات واجهة برمجة تطبيقات الخرائط. تأكّد من أنّ الزيادة في 4xx و/أو 5xx في مقاييس النظام الأساسي لـ "خرائط Google" ترتبط بعملية نقل البيانات هذه من خلال التحقّق من رمز الاستجابة الدقيق الذي يزيد في مستكشف المقاييس (مزيد من المعلومات عن استخدام "أداة مراقبة Google Cloud" في "منصة خرائط Google").

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

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

توفر Google Maps Platform أنواعًا عديدة من نماذج الشفرة لمساعدتك في الاستعداد السريع. على سبيل المثال، يمكنك استخدام أداة الإنشاء السريع في 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" (واجهة برمجة تطبيقات الخرائط الثابتة وواجهة برمجة تطبيقات "التجوّل الافتراضي" و"واجهة برمجة تطبيقات الترميز الجغرافي" و"واجهة برمجة تطبيقات الاتجاهات" و"واجهة برمجة تطبيقات الأماكن" و"واجهة برمجة تطبيقات المنطقة الزمنية" و"واجهة برمجة تطبيقات تحديد الموقع الجغرافي" و"واجهة برمجة تطبيقات Elevation"). ولكن هناك بعض الاستثناءات:

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

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

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

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

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

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

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

واجهة برمجة التطبيقات في "منصة خرائط Google"	وحدة الحصة
الخرائط
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android	بانوراما واحدة
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع iOS	بانوراما واحدة
Maps Static API	طلب واحد
Maps JavaScript API	تحميل خريطة واحدة
Street View Static API	طلب واحد
Maps Embed API	تحميل خريطة واحدة
المسارات
Routes API (Compute Routes)	طلب واحد
Routes API (Compute Route Matrix)	عنصر واحد (زوج نقطة الانطلاق)
Directions API	طلب واحد
Distance Matrix API	عنصر واحد (زوج نقطة الانطلاق)
Roads API	طلب واحد
أماكن
واجهة برمجة تطبيقات الأماكن	طلب واحد
واجهة برمجة تطبيقات التحقق من العنوان	طلب واحد
Geocoding API	طلب واحد
Geolocation API	طلب واحد
Time Zone API	طلب واحد

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

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

تتوفر تقارير الفوترة لاستخدام منتجات منصة خرائط Google في Google Cloud Console (راجع الفوترة).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. استخدم فلتر تجميع حسب رمز التخزين التعريفي.
2. اختيار علامة الإقحام في التصنيفات.
3. اختَر القائمة المنسدلة Key (مفتاح) واختَر goog-maps-channel.
4. اختَر القائمة المنسدلة القيمة واختَر القنوات الرقمية التي تريد فلترتها.

يمكنك التصنيف بحسب مفتاح التصنيف goog-maps-channel لعرض التكلفة التي أنشأتها كل قناة.

بعد تنفيذ بيانات استخدام القناة في طلباتك، قد يكون هناك تأخير قصير (يصل إلى 24 ساعة) قبل أن تظهر البيانات في تقرير الفوترة.

تصدير بيانات الفوترة باستخدام BigQuery

يمكنك أيضًا تصدير بيانات الفوترة إلى BigQuery.

يمكّنك BigQuery Export من تصدير بيانات فوترة Cloud التفصيلية (مثل بيانات الاستخدام وتقدير التكلفة) تلقائيًا على مدار اليوم إلى مجموعة بيانات BigQuery التي تحددها. وبعد ذلك، يمكنك الوصول إلى بيانات الفوترة من BigQuery لإجراء تحليل تفصيلي. وهذا يمنحك طبقة إضافية من الدقة في فهم مصدر استخدامك لـ Google Maps Platform.

إذا كنت تريد البدء في استخدام BigQuery Export وطلب البيانات، يمكنك تجربة نموذج الطلب أدناه. قبل تشغيل طلب البحث هذا، يجب:

• فعِّل الفوترة وتصدير فوترة 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 أو تعديله أو إغلاقه
• تعديل إعدادات الفوترة لمشروع
• عرض تقارير الفوترة ومؤشرات التكلفة
• تحديد ميزانيات وتنبيهات الميزانية
• تقييد استخدام واجهة برمجة التطبيقات

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

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

حالة الاستجابة والتقارير

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

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

رموز الاستجابة المتاحة في ردود واجهة برمجة التطبيقات للخرائط		متوفرة في تقرير الاستخدام	تم الإبلاغ إلى
حالة API للخرائط	رمز استجابة HTTP	فئة رمز استجابة HTTP	الاستخدام	الحصة	الإذن بالوصول إلى الفوترة
حسنًا	200، 204، 302	2xx، 3xx	نعم	نعم	نعم
DATA_NOT_AVAILABLE، NOT_FOUND، ZERO_RESULTS	200	4xx1	نعم	نعم	نعم
NOT_FOUND (واجهات برمجة تطبيقات "التجوّل الافتراضي" و"الموقع الجغرافي" و"الطرق") ZERO_RESULTS (واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي")	404	4xx	نعم	نعم	نعم
INVALID_REQUEST (قيمة معلمة غير صالحة)، MAX_ROUTE_LENGTH_EXCEEDED، MAX_WAYPOINTS_EXCEEDED، إلخ.	200/400	4xx	نعم	نعم	نعم
INVALID_REQUEST (معلمة غير صالحة/مفقودة، خطأ في تحليل الطلب)	200/400	4xx	نعم	لا	لا
تم رفض الطلب	403/200/400	4xx1	نعم	لا	لا
OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، RESOURCE_EXHAUSTED، تم تجاوز الحد اليومي، تم تجاوز المعدل ، تم تجاوز userRateLimit	200/403، 429	4xx1	نعم	لا	لا
خطأ غير معروف	200/500، 503	5xx1	نعم	نعم	لا
يمكنك رؤية كلا رمزي الاستجابة أثناء الفترة الانتقالية. لن تتغير رموز الاستجابة التي يتم عرضها في استجابات واجهة برمجة تطبيقات الخرائط. تأكّد من أنّ الزيادة في 4xx و/أو 5xx في مقاييس النظام الأساسي لـ "خرائط Google" ترتبط بعملية نقل البيانات هذه من خلال التحقّق من رمز الاستجابة الدقيق الذي يزيد في مستكشف المقاييس (مزيد من المعلومات عن استخدام "أداة مراقبة Google Cloud" في "منصة خرائط Google").

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

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

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

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

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