رسائل الخطأ

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

الطلبات غير الصالحة

في حال طلب غير صالح، تعرض واجهة برمجة التطبيقات تضمين الخرائط رمز حالة HTTP 4xx ورسالة تصف المشكلة. في ما يلي أمثلة عن حالات الخطأ هذه. ملاحظة: هذه ليست قائمة كاملة بالأخطاء المحتملة. يُرجى التحقّق من رمز الخطأ الفعلي والرسالة التي تعرضها واجهة برمجة التطبيقات للحصول على تفاصيل مشاكل محدّدة.

مثال على حالة الخطأ رمز الحالة
يتضمّن الطلب معلَمة غير صالحة، أو معلَمة مطلوبة مفقودة. على سبيل المثال، إنّ المعلَمة zoom ليست ضمن النطاق المتوقّع للقيم الرقمية أو أنّ هناك معلمة مطلوبة غير مضمّنة في الطلب. 400 BAD REQUEST
مفتاح واجهة برمجة التطبيقات المضمّن في الطلب غير صالح. 403 FORBIDDEN

أخطاء في واجهة برمجة التطبيقات ومفتاح واجهة برمجة التطبيقات

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

أخطاء في الفوترة ومُحيل HTTP

يتم عرض خريطة داكنة، أو "بطاقة سلبية&quot، أو صورة التجوّل الافتراضي، مع علامة مائية مع &"لأغراض التطوير فقط&quot، عندما ينطبق أي مما يلي:

التحقق من الأخطاء في متصفحك

بالنسبة إلى أخطاء مُحيل HTTP والفوترة، تكتب واجهة برمجة تطبيقات تضمين الخرائط أخطاء إلى window.console. بالنسبة إلى الطلبات غير الصالحة (بما في ذلك مفتاح واجهة برمجة التطبيقات وأخطاء QPS)، يتم الإبلاغ فقط عن رمز حالة HTTP 4xx في وحدة التحكّم. يوضّح هذا القسم طريقة التحقّق من مخرجات وحدة التحكّم في Google Chrome. إذا كنت تستخدم أي متصفحات أخرى، يُرجى التحقق من وثائق مطوّري البرامج لمتصفحك. يمكنك الرجوع إلى قائمة الأدوات هذه للتحقق من مخرجات وحدة التحكم في بعض المتصفحات الأخرى.

في Chrome، يمكنك استخدام وحدة تحكّم JavaScript للتحقّق من ناتج وحدة التحكّم على النحو التالي.

  1. لفتح أدوات المطوّرين، اختَر رمز القائمة &gt؛ المزيد من الأدوات، &gt، أدوات المطوّرين.
  2. لفتح"وحدة تحكّم JavaScript"، انقر على علامة التبويب Console في أعلى نافذة"أدوات المطوّرين". يمكنك أيضًا استخدام مفتاح ESC لتبديل وحدة تحكم JavaScript.