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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• يعرض الرسم البياني لوقت الاستجابة متوسط وقت الاستجابة للطلبات لكل واجهة برمجة تطبيقات.

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

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

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

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

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

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

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

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

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

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

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

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

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

واجهات Google Maps Platform API صفحة الخدمات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. انقر على المقاييس في القائمة اليمنى.

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

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

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

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

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

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

حالة واجهة برمجة التطبيقات للخرائط	فئة رمز استجابة HTTP - تقرير الاستخدام (2xx، 3xx، 4xx، 5xx)	ملاحظات
حسنًا	2xx	تمت الاستجابة بنجاح. هذا طلب قابل للفوترة، وسيستهلك حصة.
حسنًا	3xx	تمت الاستجابة بنجاح. هذا طلب قابل للفوترة، وسيستهلك حصة. على سبيل المثال، صورة المكان الطلبات الناجحة بإرجاع إعادة التوجيه 302 إلى الصورة المشار إليها.
DATA_NOT_AVAILABLE	4xx^(1)	استجابة ناجحة تشير إلى عدم توفر بيانات مواقع الإدخال. هذا طلب قابل للفوترة، وسيستهلك حصة.
ZERO_RESULTS	4xx^(1)	لم تعرض الاستجابة الناجحة أي نتائج. هذا طلب قابل للفوترة، وسيستهلك حصة.
NOT_FOUND	4xx^(1)	بالنسبة إلى Directions API تشير هذه الرسالة إلى أن أحد المواقع المحددة على الأقل تعذّر ترميز مصدر الطلب أو وجهته أو نقاط المسار جغرافيًا. بالنسبة إلى واجهة برمجة تطبيقات الأماكن تشير هذه الرسالة إلى أن الموقع المشار إليه (place_id) لم يكن في قاعدة بيانات الأماكن. هذا طلب قابل للفوترة، وسيستهلك حصة.
nofollow_REQUEST (قيمة مَعلمة غير صالحة)، MAX_WAYPOINTS_EXCEEDED، MAX_ROUTE_LENGTH_EXCEEDED وغير ذلك.	4xx	حدث خطأ ناتج عن قيمة معلَمة غير صالحة. التحقّق من واجهة برمجة التطبيقات لمزيد من التفاصيل. هذا طلب قابل للفوترة، وسيستهلك حصة.
REQUEST_DENIED	4xx	خطأ في العميل تسبّب في حدوث خطأ في المصادقة وخطأ في الوصول وغير ذلك. لمزيد من التفاصيل، يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات.
OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، RI_EXHAUSTED، تم تجاوز حد المعدل، تم تجاوز الحد اليومي المسموح به، userRateLimitExceeded	4xx	حدث خطأ في العميل نتيجة وجود عدد كبير جدًا من الطلبات خلال فترة زمنية مسموح بها. إعادة المحاولة الطلب في وقت لاحق. لمزيد من التفاصيل، يمكنك الاطّلاع على ردّ واجهة برمجة التطبيقات.
UTF_REQUEST (معلمة غير صالحة أو مفقودة، طلب غير صالح خطأ في التحليل أو في التحقق من الصحة)	4xx	حدث خطأ في العميل نتيجة طلب غير صالح. يمكنك الاطّلاع على استجابة واجهة برمجة التطبيقات لمزيد من المعلومات. التفاصيل.
NOT_FOUND (404)	4xx	بالنسبة إلى Geolocation API تشير هذه الرسالة إلى أن المدخلات لم تكن كافية لإنتاج تقدير الموقع. بالنسبة إلى Roads API، تشير هذه الرسالة إلى أنه لا يمكن استخلاص المدخلات بشكل معقول إلى الطرق. هذا طلب قابل للفوترة، وسيستهلك حصة.
UNKNOWN_ERROR	5xx	خطأ في الخادم يشير إلى تعذُّر متابعة الطلب: داخلي خطأ، أو تحميل زائد، أو غير متاح، أو انتهاء المهلة، و غير ذلك.
^1 لتحسين اتساق إعداد تقارير رموز الخطأ، استخدمت "منصة خرائط Google" يتم نقل بيانات واجهات برمجة التطبيقات: 1) من فئة رمز استجابة HTTP 2xx إلى 4xx بالنسبة إلى حالات واجهة برمجة التطبيقات للخرائط: DATA_NOT_AVAILABLE وNOT_FOUND ZERO_RESULTS - الحالة، 2) من فئة رمز استجابة HTTP 2xx إلى 4xx بالنسبة حالات واجهة برمجة التطبيقات للخرائط: REQUEST_DENIED، OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، dailyLimitExceeded، rateLimitExceeded، userRateLimitExceeded، 3) من فئة رمز استجابة HTTP 2xx إلى 5xx حالة واجهة برمجة التطبيقات للخرائط: UNKNOWN_ERROR. يمكنك الاطّلاع على رمزَي الاستجابة أثناء عملية النقل. الفترة. لن تتغير رموز الاستجابة التي يتم عرضها في الردود من واجهة برمجة التطبيقات للخرائط. تأكَّد من أنّ الزيادة في 4xx و/أو 5xx في مقاييس "منصة خرائط Google" يرتبط بعملية النقل هذه من خلال التحقق من رمز الاستجابة الدقيقة الذي يزيد في مستكشف المقاييس (مزيد من المعلومات حول استخدام مراقبة السحابة الإلكترونية من Google لمنصة خرائط Google).

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

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

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

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

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

تقارير الحصص

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

يتم عرض مقدار استخدام الحصة في رسوم بيانية في صفحة الحصص في 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". (واجهة برمجة التطبيقات الثابتة للخرائط وواجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" وGeocoding API وDirects API Places API وTime Zone API Geolocation API وGeolocation API) ولكن هناك بعض الاستثناءات:

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

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

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

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

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

وحدات الحصة

يعرض هذا الجدول وحدة الحصة لواجهات برمجة التطبيقات في "منصة خرائط 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 لمزيد من المعلومات، يُرجى مراجعة الفوترة:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة: لا تتوفّر بيانات القناة لحزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android، حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS و Places API (جديدة) واجهة برمجة تطبيقات التحقق من صحة العناوين وواجهة برمجة التطبيقات Aerial View API واجهة برمجة تطبيقات جودة الهواء وواجهة برمجة تطبيقات الخرائط في الخرائط وواجهة برمجة تطبيقات مجموعات بيانات الخرائط واجهة برمجة التطبيقات للطرق Routes API وPollen API و حاليا Route Optimization API.

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

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

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

يمكنك التجميع حسب مفتاح التصنيف goog-maps-channel للاطّلاع على التكلفة الناتجة عن كل قناة.

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

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

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

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

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

• تفعيل الفوترة تصدير فوترة BigQuery في حسابك
• تنسيق الجدول هو PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID حيث:
• PROJECT_ID هو معرّف مشروعك الفعلي (على سبيل المثال "my-project-123456").
• DATASET_NAME هو اسم مجموعة البيانات التي أنشأتها (على سبيل المثال، "SampleDataSet").
• BILLING_ACCOUNT_ID هو مرجع لمعرّف حساب الفوترة، تبدأ بـ "gcp_billing_exportv1"، وتغيير الشُرط (-) إلى الشرطات السفلية (_). على سبيل المثال، سيصبح رقم تعريف حساب الفوترة 123456-7890AB-CDEF01. gcp_billing_export_v1_123456_789AB_CDEF01

ملاحظة: عند إنشاء مجموعة بيانات جديدة، في الواجهة على الفور، ولكن لن يظهر بعد الجدول المطلوب الاستعلام عنه. سيتم إنشاء الجدول تلقائيًا بعد بضع ساعات. سيستغرق الأمر بعد ذلك 24 ساعة تقريبًا للاطلاع على البيانات. لا تعكس مجموعة بيانات BigQuery إلا الاستخدام بيانات التكلفة المتكبدة من تاريخ إعداد تصدير الفوترة وبعده. ضِمن بمعنى آخر، لا تتم إضافة بيانات الفوترة بأثر رجعي، لذا لن تظهر لك معلومات الفوترة البيانات قبل تفعيل BigQuery Export.

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

مراجع ذات صلة

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

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

منصة خرائط Google:

• الفوترة في "منصة خرائط 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_available، NOT_FOUND، ZERO_RESULTS	200، 404	4xx^1	نعم	نعم	نعم
nofollow_REQUEST (قيمة مَعلمة غير صالحة)، MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED، وهكذا.	200، 400	4xx	نعم	نعم	نعم
ASCII_REQUEST (معلمة غير صالحة/مفقودة، خطأ في تحليل الطلب)	200، 400	4xx	نعم	لا	لا
REQUEST_DENIED	200، 400، 403	4xx^1	نعم	لا	لا
OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، RI_EXHAUSTED، تم تجاوز الحد اليومي المسموح به، تم تجاوز الحدّ الأقصى المسموح به لمعدّل الزحف، userRateLimitExceeded	200، 403، 429	4xx^1	نعم	لا	لا
UNKNOWN_ERROR	200، 500، 503	5xx^1	نعم	نعم	لا
^1 لتحسين اتساق إعداد تقارير رموز الخطأ، استخدمت "منصة خرائط Google" يتم نقل بيانات واجهات برمجة التطبيقات: 1) من فئة رمز استجابة HTTP 2xx إلى 4xx بالنسبة إلى حالات واجهة برمجة التطبيقات للخرائط: DATA_NOT_AVAILABLE وNOT_FOUND ZERO_RESULTS - الحالة، 2) من فئة رمز استجابة HTTP 2xx إلى 4xx بالنسبة حالات واجهة برمجة التطبيقات للخرائط: REQUEST_DENIED، OVER_DAILY_LIMIT، OVER_QUERY_LIMIT، dailyLimitExceeded، rateLimitExceeded، userRateLimitExceeded، 3) من فئة رمز استجابة HTTP 2xx إلى 5xx حالة واجهة برمجة التطبيقات للخرائط: UNKNOWN_ERROR. يمكنك الاطّلاع على رمزَي الاستجابة أثناء عملية النقل. الفترة. لن تتغير رموز الاستجابة التي يتم عرضها في الردود من واجهة برمجة التطبيقات للخرائط. تأكَّد من أنّ الزيادة في 4xx و/أو 5xx في مقاييس "منصة خرائط Google" يرتبط بعملية النقل هذه من خلال التحقق من رمز الاستجابة الدقيقة الذي يزيد في مستكشف المقاييس (مزيد من المعلومات حول استخدام مراقبة السحابة الإلكترونية من Google لمنصة خرائط Google).

تقارير التفاعل

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

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

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

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

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

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

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

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

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

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

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

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

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

أداة البحث عن الأماكن الإضافية

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

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

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

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