رسائل الخطأ

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

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

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

تحديد المشاكل وحلّها

في حالات معيّنة، قد يتم عرض خريطة داكنة، أو صورة &#39؛ سلبية&#39؛ التجوّل الافتراضي، مع علامة نصية مع النص &quotلأغراض التطوير فقط"، يشير هذا السلوك عادةً إلى مشاكل في مفتاح واجهة برمجة التطبيقات أو الفوترة. لاستخدام منتجات "منصة خرائط Google"، يجب تفعيل الفوترة في حسابك، ويجب أن تتضمّن جميع الطلبات مفتاح واجهة برمجة تطبيقات صالحًا. للحصول على مساعدة بشأن العثور على رسائل الخطأ، يُرجى الاطلاع على القسم الذي يتناول التحقق من الأخطاء في المتصفح.

ستساعدك الخطوات التالية على تحديد المشكلة وحلّها.

رموز خطأ JavaScript API للخرائط لمطوّري البرامج ومالكي المواقع الإلكترونية

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

أخطاء تحميل الخريطة

إذا واجهت خطأً أثناء تحميل واجهة برمجة تطبيقات JavaScript للخرائط، يُرجى الاطّلاع على الجدول أدناه للعثور على تفسيرات لرموز الخطأ.

رمز الخطأ الرسالة الوصف
NotLoadingAPIFromGoogleMapsError يجب تنزيل واجهة برمجة تطبيقات JavaScript للخرائط من خوادم Google مباشرةً.

لم يتم تضمين عنصر النص البرمجي الذي يُحمّل Maps API API بشكل صحيح في صفحتك. لكي تعمل واجهة برمجة التطبيقات بشكل صحيح، يجب تحميلها مباشرةً من https://maps.googleapis.com.

راجِع تحميل Maps API API.

TOSViolationMapError يبدو أنّ هذا الموقع الإلكتروني يخالف بنود خدمة Google Maps API. تم إيقاف Google Maps API لهذا الموقع الإلكتروني.

تم حظر طلبك بسبب عدم الامتثال لبنود خدمة "منصة خرائط Google"، بعد تلقّي عدة إشعارات عبر البريد الإلكتروني. لتقديم طلب إعادة النظر في الحظر ومراجعة عملية التنفيذ، يُرجى إكمال هذا النموذج. سيصلك ردّ عبر البريد الإلكتروني خلال بضعة أيام عمل.

إذا كان لديك ترخيص خطة مميّزة في "منصة خرائط Google"، يُرجى استخدام بيانات اعتماد الخطة المميزة في "منصة خرائط Google" لحل هذا الخطأ. راجِع دليل مصادقة الخطة المميزة.

UnauthorizedURLForClientIdMapError عنوان URL هذا غير مصرّح له باستخدام معرِّف عميل "خرائط Google" الذي تم تقديمه.

معرّف العميل في خطة Premium أو Maps API for Work المضمَّنة في تحميل النص البرمجي غير صالح أو منتهي الصلاحية أو العنوان الحالي الذي يحمّل واجهة برمجة تطبيقات JavaScript للخرائط لم تتم إضافته إلى قائمة عناوين URL المصرّح بها.

يمكنك الاطّلاع على تسجيل عناوين URL المسموح بها.

رموز خطأ واجهة برمجة تطبيقات JavaScript للخرائط

إذا عثرت على خطأ في وحدة تحكّم JavaScript في Chrome أو Firefox Web Console أو أي أدوات مكافئة أخرى في متصفّحاتك، يُرجى الاطّلاع على الجدول أدناه للعثور على تفسيرات لرموز الخطأ.

تعرض Maps JavaScript API كلاً من الأخطاء والتحذيرات. يشير خطأ إلى مشكلة خطيرة حدثت أثناء تحميل واجهة برمجة تطبيقات JavaScript لـ "خرائط Google". لا يمكن لصفحتك تحميل واجهة برمجة التطبيقات بشكل صحيح، ولن تعمل واجهة برمجة التطبيقات على هذه الصفحة. التحذير هو رسالة تكميلية حول تحميل واجهة برمجة تطبيقات JavaScript للخرائط. ويوضّح التحذير الأسباب المحتملة لحدوث خطأ، أو يقترح مشاكل محتملة في الرمز الذي يحمّل Maps JavaScript API. وإذا تلقّيت تحذيرات فقط بدون أي أخطاء، ستعمل واجهة برمجة التطبيقات بشكل صحيح على تلك الصفحة. ومع ذلك، ننصحك بحلّ هذه المشاكل المحتملة أيضًا.

رمز خطأ مطوّر البرامج النوع الوصف
ApiNotActivatedMapError خطأ

لم يتم تفعيل واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" في مشروع واجهة برمجة التطبيقات. قد تحتاج إلى تفعيل واجهة برمجة تطبيقات JavaScript للخرائط ضمن واجهات برمجة التطبيقات في Google Cloud Console.

لتفعيل Maps API API لمشروعك، انقر على الزر أدناه.
تعرَّف على كيفية إجراء ذلك

ApiTargetBlockedMapError خطأ

مفتاح واجهة برمجة التطبيقات هذا غير مُصرَّح له باستخدام هذه الخدمة أو واجهة برمجة التطبيقات. يُرجى الاطّلاع على إعدادات قيود واجهة برمجة التطبيقات الخاصة بمفتاح واجهة برمجة التطبيقات في Google Cloud Console للتأكّد من أنّ جميع واجهات برمجة التطبيقات والخدمات التي تحتاج إلى استخدامها تم تحديدها بشكل صحيح في قائمة واجهات برمجة التطبيقات المفعّلة.

راجِع مفاتيح واجهة برمجة التطبيقات في Cloud Console. لمزيد من المعلومات، راجِع أفضل ممارسات أمان واجهة برمجة التطبيقات.

DeletedApiProjectMapError خطأ

ربما تم حذف مشروع واجهة برمجة التطبيقات من Cloud Console. يُرجى التحقّق من المشروع الذي أنشأت له مفتاح واجهة برمجة تطبيقات تمّ تضمينه في أداة تحميل واجهة برمجة تطبيقات JavaScript. يمكنك إنشاء مشروع جديد لواجهة برمجة التطبيقات والحصول على مفتاح جديد في Cloud Console.

لإنشاء مشروع جديد والحصول على مفتاح واجهة برمجة تطبيقات للمشروع، انقر على الزر أدناه.
تعرَّف على كيفية إجراء ذلك

ClientBillingNotEnabledMapError خطأ

عدم تفعيل الفوترة في مشروعك يجب تفعيل الفوترة في مشروع Google Cloud المرتبط بمعرّف العميل هذا، هنا.

BillingNotEnabledMapError خطأ

لم يتم تفعيل الفوترة في مشروعك، ما يتسبب في حدوث هذا الخطأ. يجب تفعيل الفوترة في مشروع Google Cloud هنا.

مزيد من المعلومات

ExpiredKeyMapError خطأ

انتهت صلاحية مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات أو لم يتعرّف عليه النظام. قد يظهر لك هذا الخطأ بعد إنشاء مفتاح واجهة برمجة تطبيقات جديد إذا حاولت استخدام المفتاح قبل أن يتعرّف عليه النظام. يُرجى الانتظار بضع دقائق وإعادة المحاولة، أو قد تحتاج إلى إنشاء مفتاح جديد لواجهة برمجة التطبيقات في Cloud Console.

للحصول على مفتاح واجهة برمجة تطبيقات، انقر على الزر أدناه.
البدء

InvalidClientIdMapError خطأ

معرّف العميل المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات غير صالح أو منتهي الصلاحية. يُرجى التأكد من استخدام معرِّف العميل بشكل صحيح. يجب أن يبدأ معرِّف العميل ببادئة &"gme-". إذا ظهر لك هذا الخطأ حتى عند استخدام معرّف العميل بشكل صحيح، من المحتمل أنّ معرّف العميل قد انتهت صلاحيته. يُرجى التواصل مع مدير حسابك في Google.

إذا لم تكن لديك خطة مميّزة أو ترخيص Maps API for Work، ستحتاج إلى استخدام معلَمة key مع مفتاح واجهة برمجة التطبيقات بدلاً من المعلَمة client .

راجِع دليل مصادقة الخطة المميزة.

InvalidKeyMapError خطأ

لم يتم العثور على مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات. يُرجى التأكد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console.

للحصول على مفتاح واجهة برمجة تطبيقات، انقر على الزر أدناه.
البدء

MalformedCredentialsMapError خطأ

يستخدم تطبيقك نظام معرف موارد منتظم (URI) غير متوافق. تحقّق من أن التطبيق يستخدم تنسيق معرّف موارد منتظم (URI) صالحًا كما هو محدّد في RFC 3986.

MissingKeyMapError خطأ

لا يتضمّن عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات معلّمة المصادقة المطلوبة.

إذا كنت تستخدم واجهة برمجة تطبيقات JavaScript العادية للخرائط، عليك استخدام معلَمة key مع مفتاح واجهة برمجة تطبيقات صالح. ولمزيد من المعلومات، يمكنك الاطّلاع على بدء استخدام "منصة خرائط Google".

إذا كنت أحد عملاء خطة Premium، عليك استخدام مَعلمة client مع معرّف العميل أو معلمة key مع مفتاح واجهة برمجة تطبيقات صالح. لمزيد من المعلومات، راجِع الدليل مفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء.

وإذا لم تكن مالك الموقع الإلكتروني، لا يمكنك في هذه الحالة اتّخاذ أي خطوات لإصلاح هذا الخطأ. ومع ذلك، ننصحك بإبلاغ مالك الموقع الإلكتروني إن أمكن ذلك.

ProjectDeniedMapError خطأ

لم يكتمل طلبك. قد تتمكّن من العثور على المزيد من التفاصيل حول الخطأ في Cloud Console.

يُرجى الاطّلاع على Cloud Console.

RefererDeniedMapError خطأ

تم حظر طلبك بسبب عدم الامتثال لبنود خدمة "منصة خرائط Google"، بعد تلقّي عدة إشعارات عبر البريد الإلكتروني. لتقديم طلب إعادة النظر في الحظر ومراجعة عملية التنفيذ، يُرجى إكمال هذا النموذج. سيصلك ردّ عبر البريد الإلكتروني خلال بضعة أيام عمل.

RefererNotAllowedMapError خطأ

لم تتم إضافة عنوان URL الحالي الذي يحمّل واجهة برمجة تطبيقات JavaScript للخرائط إلى قائمة المُحيلين المسموح بهم. يُرجى التحقق من إعدادات المُحيل لمفتاح واجهة برمجة التطبيقات في Cloud Console.

يمكنك الاطّلاع على واجهة برمجة تطبيقات JavaScript للخرائط والحصول على مفتاح واجهة برمجة تطبيقات.

OverQuotaMapError خطأ

تجاوز عدد الطلبات الحدود القصوى المسموح بها لواجهة برمجة تطبيقات JavaScript للخرائط. ستعمل طلبات التطبيقات مرة أخرى في المرة التالية التي تتم فيها إعادة ضبط الحصة اليومية.

إذا لم تكن مالك الموقع الإلكتروني، ليس عليك اتّخاذ أي خطوات لإصلاح هذا الخطأ. ومع ذلك، ننصحك بإبلاغ مالك الموقع الإلكتروني إن أمكن ذلك.

لمزيد من التفاصيل، راجِع الدليل حدود الاستخدام. توضّح الصفحة أيضًا كيفية الاستفادة من حدود استخدام أعلى.

ApiProjectMapError خطأ

تعذر حلّ مفتاح واجهة برمجة التطبيقات الذي تمّ تقديمه أو مشروع واجهة برمجة التطبيقات المرتبط به. وقد يكون هذا الخطأ مؤقتًا. إذا استمر ظهور رسالة الخطأ هذه، قد تحتاج إلى الحصول على مفتاح جديد لواجهة برمجة التطبيقات أو إنشاء مشروع جديد لواجهة برمجة التطبيقات.

ولمزيد من المعلومات، يمكنك الاطّلاع على بدء استخدام "منصة خرائط Google".

ClientIdLooksLikeCryptoKey التحذير

من المحتمل أنك قدّمت مفتاح تشفير في المعلّمة client. إذا كانت لديك خطة مميّزة أو ترخيص Maps API for Work، يُرجى تحديد معرِّف العميل على أنه معلَمة client. ولست بحاجة إلى استخدام مفتاح التشفير الخاص بك لواجهة برمجة تطبيقات JavaScript للخرائط.

راجِع دليل معرّفات العملاء لعملاء خطة Premium وMaps API for Work.

ClientIdLooksLikeKey التحذير

ربما تكون قد قدّمت مفتاح واجهة برمجة تطبيقات في المعلمة client. إذا كانت لديك خطة مميّزة أو ترخيص Maps API for Work، يُرجى تحديد معرِّف العميل على أنه معلَمة client. إذا كانت لديك خطة مميّزة في "منصة خرائط Google"، يمكنك استخدام معلَمة client أو المعلَمة key. إذا لم يكن لديك أي تراخيص، يجب استخدام معلَمة key بدلاً من معلَمة client .

راجِع دليل مصادقة الخطة المميزة.

InvalidChannel التحذير

ربما تكون قد قدّمت معلّمة channel غير صالحة. يجب أن تكون القناة سلسلة الأبجدية الرقمية ASCII والتي قد تتضمن النقطة (.) والشرطة السفلية (_) والواصلة (-). يُرجى التأكد من تحديد معلمة channel صالحة.

يمكنك الاطّلاع على إعداد التقارير | الخطة المميزة على "منصة خرائط Google".

InvalidClientId التحذير

لا يبدو أن المَعلمة client تحتوي على معرّف عميل صحيح. يجب أن يبدأ معرِّف العميل بـ "gme-".

راجِع دليل مصادقة الخطة المميزة.

InvalidKey التحذير

لا يبدو مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات صحيحًا. يُرجى التأكد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console.

للحصول على مفتاح واجهة برمجة تطبيقات، انقر على الزر أدناه.
البدء

InvalidVersion التحذير

ربما قدّمت رقم إصدار غير صحيح في عنصر النص البرمجي. يُرجى التأكد من استخدام رقم إصدار صحيح.

اطّلِع على تحديد الإصدارات | واجهة برمجة تطبيقات JavaScript لـ "خرائط Google".

KeyLooksLikeClientId التحذير ربما تكون قد قدّمت معرّف عميل كمعلّمة key. إذا كانت لديك خطة مميّزة أو ترخيص Maps API for Work، يُرجى تحديد معرِّف العميل كمعلّمة client بدلاً من المعلّمة key. إذا كانت لديك خطة مميّزة في "منصة خرائط Google"، يمكنك استخدام معلَمة client أو المعلَمة key. إذا لم يكن لديك أي تراخيص، يجب استخدام معلَمة key بدلاً من معلَمة client .

راجِع دليل مصادقة الخطة المميزة.

KeyLooksLikeCryptoKey التحذير

من المحتمل أنك قدّمت مفتاح تشفير أو سرّ توقيع كمعلّمة key. إذا كان لديك خطة مميّزة أو ترخيص Maps API for Work، يُرجى تحديد معرِّف العميل كمعلّمة client وإزالة المعلَمة key من عنصر النص البرمجي. مفتاح التشفير غير مطلوب لواجهة برمجة تطبيقات JavaScript للخرائط. إذا كانت لديك خطة مميّزة في "منصة خرائط Google"، يمكنك استخدام معلَمة client أو المعلَمة key. إذا لم يكن لديك أي تراخيص، يمكنك الحصول على مفتاح واجهة برمجة تطبيقات في Cloud Console.

راجِع الدليل تحديد معرِّف عميل عند تحميل واجهة برمجة التطبيقات.

KeyLooksLikeProjectNumber التحذير

ربما تم توفير رقم مشروع كمعلمة key. يُرجى التأكد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console.

تعرَّف على كيفية الحصول على مفتاح لواجهة برمجة التطبيقات.

NoApiKeys التحذير

لا يحتوي عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات على مفتاح لواجهة برمجة التطبيقات. يُرجى التأكّد من تضمين مفتاح واجهة برمجة تطبيقات صالح كمَعلمة key. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console.

للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه للبدء.
البدء

في حال تحميل واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" من المسار الذي تم إيقاف العمل به للإصدار 2، ستتلقّى التحذير NoApiKeys، حتى إذا حدّدت المعلَمة key. يُرجى الاطّلاع على دليل ترقية الإصدار 2 إلى الإصدار 3 ونقل تطبيقك إلى الإصدار الثالث من واجهة برمجة تطبيقات JavaScript للخرائط.

RetiredVersion التحذير

ربما تم توفير إصدار متوقف في عنصر النص البرمجي. يُرجى تحديث التطبيق لاستخدام أحد الإصدارات المتاحة.

اطّلِع على تحديد الإصدارات | واجهة برمجة تطبيقات JavaScript لـ "خرائط Google".

SensorNotRequired التحذير

لم تعُد المعلَمة sensor مطلوبة لواجهة برمجة تطبيقات JavaScript للخرائط. ولن يمنع ذلك واجهة برمجة تطبيقات JavaScript للخرائط من العمل بشكل صحيح، ولكننا ننصح بإزالة مَعلمة sensor من عنصر النص البرمجي.

SignatureNotRequired التحذير

لا يلزم تضمين المعلَمة signature في Maps API API. ولن تمنع واجهة برمجة تطبيقات JavaScript للخرائط من العمل بشكل صحيح، ولكنها قد تشكّل مخاطر أمنية. يُرجى إزالته من عنصر النص البرمجي.

SignedInNotSupported التحذير

تم إيقاف المَعلمة signed_in وهي غير متوافقة مع إصدار واجهة برمجة تطبيقات JavaScript للخرائط الذي تستخدمه. ولن يمنع ذلك واجهة برمجة تطبيقات JavaScript ل"خرائط Google" من العمل، ولكن قد يتغيّر سلوك التطبيق، إذا كنت تعتمد على الميزات التي تم تسجيل الدخول إليها.

UrlAuthenticationCommonError خطأ

حدث خطأ لا يتوافق مع الفئات الأخرى في هذه الصفحة. ويمكن أن يرجع ذلك إلى مشكلة مؤقتة. يُرجى إعادة محاولة تقديم الطلب بعد فترة قصيرة. إذا لم يؤدِّ ذلك إلى حلّ المشكلة، يُرجى مراجعة دليل المطوّرين للتأكّد من استخدام الطلب التنسيق الصحيح.

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

تكتب واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" رسائل الخطأ في window.console. يوضّح هذا القسم طريقة التحقّق من مخرجات window.console في Google Chrome. إذا كنت تستخدم أي متصفحات أخرى، يُرجى التحقق من وثائق مطوّري البرامج للمتصفح. يمكنك الرجوع إلى هذه القائمة بالأدوات التي يمكنك من خلالها التحقق من نتائج window.console في بعض المتصفحات الأخرى.

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

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

في حال حدوث أي أخطاء أو تحذيرات عند تحميل واجهة برمجة تطبيقات JavaScript للخرائط، ستظهر كسطر واحد أو أكثر في وحدة التحكّم. يظهر خطأ أو رسالة تحذير بالتنسيق التالي:

Google Maps API error: [ERROR CODE] [Link to API document]
أو
Google Maps API warning: [ERROR CODE] [Link to API document]

يمكنك التحقق من جدول رموز الخطأ أعلاه للعثور على رمز الخطأ في رسالة الخطأ. يمكنك أيضًا العثور على تفاصيل حول رسالة الخطأ في مستند واجهة برمجة التطبيقات المرتبط بالرسالة.

ملاحظة: يمكنك الاستماع إلى أخطاء المصادقة آليًا.

التعامل مع المتصفحات غير المتوافقة

تأكَّد من أنّ إصدار المتصفّح الذي تستخدمه يتوافق حاليًا مع واجهة برمجة تطبيقات JavaScript ل"خرائط Google".

في حال لم يعمل الرمز الخاص بك

لمساعدتك في إعداد رمز الخرائط وتشغيله، يشير بريندان كيني ومانو ماركس إلى بعض الأخطاء الشائعة وكيفية إصلاحها.

  • ابحث عن الأخطاء الإملائية. تذكّر أنّ JavaScript هي لغة حسّاسة لحالة الأحرف.
  • تحقّق من الأساسيات، حيث تحدث بعض المشاكل الأكثر شيوعًا عند إنشاء الخريطة الأولية. على سبيل المثال:
    • تأكّد من أنّك حدّدت السمتَين zoom وcenter في خيارات الخريطة.
    • تأكّد من أنّك أعلنت عن عنصر div ستظهر فيه الخريطة على الشاشة.
    • تأكد من أن ارتفاع عنصر div للخريطة ويتم تلقائيًا إنشاء عناصر div على ارتفاع 0، وبالتالي تكون غير مرئية.
    يمكنك الاطّلاع على أمثلة عن تنفيذ المرجع.
  • استخدِم برنامج تصحيح أخطاء JavaScript للمساعدة في تحديد المشاكل، مثل المشكلة المتوفرة في أدوات مطوّري برامج Chrome. ابدأ بالبحث عن أخطاء في وحدة تحكُّم JavaScript.
  • انشر أسئلة على تجاوز الحزمة. تتوفّر إرشادات حول كيفية نشر الأسئلة الرائعة في صفحة الدعم.