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