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