تصف هذه الصفحة رسائل الخطأ التي يمكن عرضها بواسطة واجهة برمجة تطبيقات تضمين الخرائط. عند حدوث خطأ، تعرض واجهة برمجة تطبيقات تضمين الخرائط نص رسالة الخطأ بدلاً من الخريطة. قد تحدث حالات خطأ معينة أيضًا، مما يؤدي إلى عرض خريطة مائية مظلمة.
الطلبات غير الصالحة
في حال تقديم طلب غير صالح، تعرض واجهة برمجة تطبيقات تضمين الخرائط رمز حالة HTTP 4xx ورسالة تصف المشكلة. في ما يلي أمثلة على شروط الخطأ هذه. ملاحظة: هذه ليست
قائمة كاملة بالأخطاء المحتملة. يُرجى التحقّق من رمز الخطأ والرسالة التي تعرضها واجهة برمجة التطبيقات للاطّلاع على تفاصيل حول مشاكل محدّدة.
| مثال على حالة الخطأ | رمز الحالة |
|---|---|
يتضمن الطلب معلمة غير صالحة أو معلمة مطلوبة
مفقودة. على سبيل المثال، لا تقع المَعلمة zoom ضمن
النطاق المتوقّع للقيم الرقمية أو أنّ معلَمة مطلوبة غير متوفّرة في
الطلب. |
400 BAD REQUEST |
| مفتاح واجهة برمجة التطبيقات المضمّن في الطلب غير صالح. | 403 FORBIDDEN |
أخطاء في مفتاح واجهة برمجة التطبيقات وQPS
يتم التعامل مع أخطاء مفتاح واجهة برمجة التطبيقات وQPS كطلبات غير صالحة. تتضمن الأسباب المحتملة ما يلي:
- مفتاح واجهة برمجة التطبيقات مفقود أو غير صالح. لحلّ هذا الخطأ، تأكَّد من أنّ طلبك يتضمّن مفتاح واجهة برمجة تطبيقات صالحًا. الحصول على مفتاح واجهة برمجة التطبيقات:
- لم يتم تفعيل واجهة برمجة تطبيقات تضمين الخرائط لمشروعك. يمكنك الاطّلاع على مزيد من المعلومات حول تفعيل واجهات برمجة التطبيقات وإيقافها.
- ينتهك مفتاح واجهة برمجة التطبيقات القيود. اطّلِع على مزيد من المعلومات حول أفضل الممارسات المتعلقة بمفتاح واجهة برمجة التطبيقات.
أخطاء إحالة HTTP والفوترة
يتم عرض خريطة معتمة أو صورة "تجوّل افتراضي" "سلبية" تم وضع علامة مائية عليها "لأغراض التطوير فقط" عندما ينطبق أي مما يلي:
- لم يتم تفعيل الفوترة في حسابك. تفعيل الفوترة.
- طريقة الفوترة المقدَّمة غير صالحة (على سبيل المثال، بطاقة ائتمان منتهية الصلاحية). لحلّ هذه المشكلة، يُرجى الانتقال إلى Google Cloud Console والتأكّد من تقديم طريقة دفع صالحة.
- تم تجاوز الحد اليومي الذي فرضه ذاتيًا. تعرَّف على كيفية عرض الحدود اليومية القابلة للفوترة أو تغييرها.
- لا يتضمّن الطلب مُحيل HTTP، وأنك تستخدم مفتاح واجهة برمجة تطبيقات محدود المُحيل. اطّلِع على مزيد من المعلومات عن إضافة المُحيلين.
التحقق من الأخطاء في المتصفح
بالنسبة إلى الأخطاء المتعلقة بالفوترة ومُحيل HTTP، تكتب واجهة برمجة تطبيقات تضمين الخرائط رسائل خطأ إلى window.console. بالنسبة إلى الطلبات غير الصالحة (بما في ذلك أخطاء مفتاح واجهة برمجة التطبيقات وأخطاء QPS)، يتم الإبلاغ عن رمز حالة HTTP 4xx فقط في وحدة التحكّم. يشرح هذا القسم كيفية التحقق من مخرجات وحدة التحكم في Google Chrome. إذا كنت تستخدم أي متصفحات أخرى، يُرجى مراجعة
وثائق مطوّري البرامج الخاصة بالمتصفح. كمرجع لك، هذه قائمة بالأدوات للتحقق
من ناتج وحدة التحكم في بعض المتصفحات الأخرى.
- وحدة التحكم لمتصفّح Internet Explorer.
- Web Console لمتصفح Firefox.
- تصحيح الأخطاء عن بُعد لنظام التشغيل Android.
- Web Inspector (أداة فحص الويب) لنظام التشغيل iOS.
في Chrome، يمكنك استخدام وحدة تحكم JavaScript للتحقق من ناتج وحدة التحكم على النحو التالي.
- لفتح أدوات المطوّرين، اختَر رمز القائمة > المزيد من الأدوات > أدوات المطوّرين.
- لفتح "وحدة تحكّم JavaScript"، انقر على علامة التبويب وحدة التحكم في أعلى نافذة "أدوات المطوّرين". يمكنك أيضًا استخدام مفتاح الخروج (Esc) لتفعيل وحدة تحكّم JavaScript.