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