رسائل الخطأ

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

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

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

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

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

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

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

هل تستخدم مفتاح واجهة برمجة التطبيقات؟

ليس لدي جواب أكيد. كيف يمكنني التحقّق مما إذا كنت أستخدم مفتاح واجهة برمجة التطبيقات؟

يتم تمرير مفتاح واجهة برمجة التطبيقات كمَعلمة key في عنوان URL المستخدَم لتحميل Google Maps JavaScript API. في ما يلي بعض الخيارات للتحقّق مما إذا كنت تستخدم مفتاح واجهة برمجة التطبيقات:

• استخدِم إضافة Google Maps Platform API Checker في Chrome. يتيح لك ذلك تحديد ما إذا كان موقعك الإلكتروني ينفّذ واجهات برمجة تطبيقات "خرائط Google" المرخّصة من Google بشكلٍ سليم.
• إذا كنت تستخدم مكتبة أو مكوّنًا إضافيًا لتحميل واجهة برمجة التطبيقات JavaScript خرائط Google، تحقَّق من إعدادات هذه المكتبة وابحث عن خيار مفتاح واجهة برمجة التطبيقات.
• تحقّق من الأخطاء في المتصفّح. إذا ظهرت لك الرسائل التالية، يعني ذلك أنّك لا تستخدم مفتاح واجهة برمجة التطبيقات بشكل صحيح:
• تحذير بشأن واجهة برمجة التطبيقات JavaScript لخرائط Google: NoApiKeys
• خطأ في Google Maps JavaScript API: MissingKeyMapError

لمطوّري الويب:

• إذا كان بإمكانك الوصول إلى رمز المصدر لتطبيقك، ابحث عن علامة <script> التي تُستخدَم لتحميل واجهة برمجة التطبيقات JavaScript لخرائط Google. عند تحميل واجهة برمجة تطبيقات JavaScript لخرائط Google، استبدِل YOUR_API_KEY في الرمز البرمجي أدناه بمفتاح واجهة برمجة التطبيقات.

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>

• تحقّق من عدد زيارات الشبكة التي يجريها موقعك الإلكتروني في المتصفّح. في Chrome، يمكن الاطّلاع على ذلك باستخدام علامة التبويب الشبكة في DevTools. ستظهر لك هنا طلبات الشبكة التي يقدّمها موقعك الإلكتروني. ستتم إضافة الطلبات التي يتم إجراؤها باستخدام Maps JavaScript API ضمن المسار maps/api/js. يمكنك هنا التأكّد مما إذا كانت الطلبات تستخدِم المَعلمة key. قد يكون من المفيد فلترة حركة بيانات الشبكة حسب maps/api/js عند عرض علامة التبويب الشبكة.

لا، لا أستخدم مفتاح واجهة برمجة التطبيقات.

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

نعم، أستخدم مفتاح واجهة برمجة التطبيقات.

رائع! لننتقل إلى الخطوة التالية ونتحقق مما إذا كان حساب فوترة مرتبطًا بمشروعك.

هل تم إرفاق حساب فوترة بمشروعك؟

ليس لدي جواب أكيد. كيف يمكنني التحقّق مما إذا كان حساب الفوترة مرتبطًا بمشروعي؟

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

1. انتقِل إلى قسم بيانات الاعتماد، والذي يمكن الوصول إليه من الشريط الجانبي الأيمن ضمن منصة خرائط Google > بيانات الاعتماد.
2. تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات الذي تستخدمه حاليًا على موقعك الإلكتروني مُدرَج. إذا لم يكن الأمر كذلك، يمكنك التبديل إلى مشروع مختلف والتحقّق من بيانات الاعتماد هناك.
3. إذا تعذّر عليك العثور على مشروع مفتاح واجهة برمجة التطبيقات، قد يعني ذلك أنّك فقدت إمكانية الوصول إلى هذا المشروع. اطلب المساعدة من مستخدمين آخرين في مؤسستك. إذا تعذّر العثور على المشروع الأصلي، عليك إجراء ما يلي:
   1. أنشئ مشروعًا جديدًا. يمكن إجراء ذلك من خلال اختيار مشروع جديد من قائمة المشاريع، أو من خلال اختيار إنشاء مشروع من صفحة "مدير الموارد".
   2. أنشئ مفتاح واجهة برمجة تطبيقات جديدًا. ويمكن إجراء ذلك في صفحة بيانات الاعتماد. بعد ذلك، انقر على إنشاء بيانات اعتماد، ثم اختَر مفتاح واجهة برمجة التطبيقات.

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

لا، لم يتم ربط حساب فوترة بمشروعي.

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

نعم، تم إرفاق حساب فوترة بمشروعي.

رائع! لنتأكّد من أنّ طريقة الفوترة المقدَّمة صالحة.

هل لم تعُد طريقة الفوترة المقدَّمة صالحة (مثل بطاقة ائتمان منتهية الصلاحية)؟

يمكنك إضافة طريقة دفع أو إزالتها أو تعديلها في Cloud Console.

هل تم تجاوز حدّ يومي ذاتيًا تم فرضه على واجهة برمجة التطبيقات؟

إذا كنت قد حدّدت حدًا يوميًا لأيّ من واجهات برمجة التطبيقات، وهو إجراء شائع لمنع الزيادات غير المتوقّعة، يمكنك حلّ هذه المشكلة من خلال زيادة الحدّ اليومي.

يمكنك التحقّق من حدودك اليومية من خلال الانتقال إلى لوحة بيانات "واجهات برمجة التطبيقات والخدمات" في Cloud Console. بعد ذلك:

1. اختَر مشروعًا إذا طُلب منك ذلك.
2. اختَر واجهة برمجة تطبيقات من القائمة، ثم انقر على علامة التبويب الحصص.

هل يتضمّن مفتاح واجهة برمجة التطبيقات قيودًا على عناوين IP؟

لا يمكن استخدام مفاتيح واجهة برمجة التطبيقات التي تتضمّن قيودًا على عناوين IP إلا مع خدمات الويب التي تكون مخصّصة للاستخدام من جهة الخادم (مثل Geocoding API وWeb Service APIs الأخرى). توفّر معظم خدمات الويب هذه خدمات مماثلة ضمن واجهة برمجة التطبيقات Maps JavaScript API (على سبيل المثال، اطّلِع على خدمة ترميز المواقع الجغرافية). لاستخدام خدمات جهة العميل في واجهة برمجة التطبيقات JavaScript API، عليك إنشاء مفتاح واجهة برمجة تطبيقات منفصل يمكن تأمينه من خلال تقييد مُحيلي HTTP (اطّلِع على الحصول على مفتاح واجهة برمجة تطبيقات وإضافته وحظره).

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

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

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

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

رمز الخطأ	الرسالة	الوصف
NotLoadingAPIFromGoogleMapsError	يجب تنزيل واجهة برمجة تطبيقات JavaScript لخرائط Google مباشرةً من خوادم Google.	عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google" غير مضمّن بشكل صحيح في صفحتك. لكي تعمل واجهة برمجة التطبيقات بشكلٍ صحيح، يجب تحميلها مباشرةً من https://maps.googleapis.com. راجِع تحميل واجهة برمجة التطبيقات Maps JavaScript API.
TOSViolationMapError	يبدو أنّ هذا الموقع الإلكتروني ينتهك بنود خدمة Google Maps API. تم إيقاف Google Maps API لهذا الموقع الإلكتروني.	تم حظر تطبيقك بسبب عدم امتثاله لبنود خدمة "منصة خرائط Google"، وذلك بعد تلقّي عدة إشعارات عبر البريد الإلكتروني. لتقديم طلب إعادة نظر بشأن المنع ومراجعة عملية التنفيذ، يُرجى إكمال هذا النموذج. سيصلك ردّ عبر البريد الإلكتروني في غضون بضعة أيام عمل. إذا كان لديك ترخيص "خطة Premium" في "منصة خرائط Google"، يُرجى استخدام بيانات اعتماد "خطة Premium" في "منصة خرائط Google" لحلّ هذا الخطأ. اطّلِع على دليل مصادقة الخطة المميّزة.
UnauthorizedURLForClientIdMapError	لا يملك عنوان URL هذا الإذن لاستخدام معرّف العميل المقدَّم في "خرائط Google".	رقم تعريف العميل لـ "الخطة المميّزة" أو واجهات برمجة التطبيقات في "خرائط Google" لميزة "العمل" غير صالح أو منتهي الصلاحية أو لم تتم إضافة العنوان الحالي الذي يحمّل Maps JavaScript API إلى قائمة العناوين URL المعتمَدة. اطّلِع على تسجيل عناوين URL المسموح بها.

رموز أخطاء Maps JavaScript API

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

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

رمز خطأ المطوّر	النوع	الوصف
ApiNotActivatedMapError	خطأ	لم يتم تفعيل واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" في مشروع واجهة برمجة التطبيقات. قد تحتاج إلى تفعيل واجهة برمجة التطبيقات JavaScript لخرائط Google ضمن واجهات برمجة التطبيقات في Google Cloud Console. لتفعيل واجهة برمجة التطبيقات JavaScript API في "خرائط Google" لمشروعك، انقر على الزر أدناه. التعرّف على كيفية إجراء ذلك
ApiTargetBlockedMapError	خطأ	مفتاح واجهة برمجة التطبيقات هذا غير مصرّح له باستخدام هذه الخدمة أو واجهة برمجة التطبيقات. يُرجى التحقّق من إعدادات قيود واجهة برمجة التطبيقات لمفتاح واجهة برمجة التطبيقات في Google Cloud Console للتأكّد من تحديد جميع واجهات برمجة التطبيقات والخدمات التي تحتاج إلى استخدامها بشكل صحيح في قائمة واجهات برمجة التطبيقات المفعّلة. اطّلِع على مفاتيح واجهة برمجة التطبيقات في Cloud Console. لمزيد من المعلومات، يُرجى الاطّلاع على أفضل ممارسات أمان واجهة برمجة التطبيقات.
DeletedApiProjectMapError	خطأ	قد يكون تم حذف مشروع واجهة برمجة التطبيقات من Cloud Console. يُرجى التحقّق من المشروع الذي أنشأت له مفتاح واجهة برمجة التطبيقات المُدرَج في أداة تحميل واجهة برمجة التطبيقات JavaScript API. يمكنك إنشاء مشروع جديد لواجهة برمجة التطبيقات و الحصول على مفتاح جديد في Cloud Console. لإنشاء مشروع جديد والحصول على مفتاح واجهة برمجة تطبيقات للمشروع، انقر على الزر أدناه. التعرّف على كيفية إجراء ذلك
ClientBillingNotEnabledMapError	خطأ	لم تفعِّل الفوترة في مشروعك. يجب تفعيل الفوترة في مشروع Google Cloud المرتبط بمعرّف العميل هذا، هنا.
BillingNotEnabledMapError	خطأ	لم تفعِّل ميزة الفوترة في مشروعك، ما يؤدي إلى ظهور هذا الخطأ. يجب تفعيل الفوترة في مشروع Google Cloud هنا. مزيد من المعلومات
ExpiredKeyMapError	خطأ	مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات قد انتهت صلاحيته أو لم يتم التعرّف عليه من قِبل النظام. قد يظهر لك هذا الخطأ بعد إنشاء مفتاح واجهة برمجة تطبيقات جديد إذا حاولت استخدام المفتاح قبل أن يتعرّف عليه النظام. يُرجى الانتظار بضع دقائق وإعادة المحاولة، أو قد تحتاج إلى إنشاء مفتاح جديد لواجهة برمجة التطبيقات في Cloud Console. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه. البدء
InvalidAppCheckTokenMapError	خطأ	الرمز المميّز الذي تم تقديمه لفحص التطبيق غير صالح أو منتهي الصلاحية. لا يمكن حدوث هذا الخطأ إلا إذا كانت ميزة التحقّق من التطبيق قيد الاستخدام. اطّلِع على دليل التحقّق من التطبيقات باستخدام App Check.
InvalidClientIdMapError	خطأ	معرّف العميل المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات هو غير صالح أو انتهت صلاحيته. يُرجى التأكّد من استخدام معرّف العميل بشكل صحيح. يجب أن يبدأ معرّف العميل بالبادئة "gme-". إذا ظهر لك هذا الخطأ حتى عند استخدام معرّف العميل بشكل صحيح، قد يكون معرّف العميل قد انتهت صلاحيته. يُرجى التواصل مع مدير حسابك في Google. إذا لم يكن لديك خطة Premium أو ترخيص "واجهات برمجة تطبيقات خرائط Google" للعمل، عليك استخدام مَعلمة key مع مفتاح واجهة برمجة التطبيقات بدلاً من المَعلمة client . اطّلِع على دليل مصادقة الخطة المميّزة.
InvalidKeyMapError	خطأ	لم يتم العثور على مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات. يُرجى التأكّد من استخدام مفتاح واجهة برمجة التطبيقات الصحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه. البدء
MalformedCredentialsMapError	خطأ	يستخدم تطبيقك مخطّط معرِّف موارد منتظم (URI) غير متوافق. تأكَّد من أنّ التطبيق يستخدم تنسيق معرّف موارد منتظم صالحًا كما هو محدّد في RFC 3986.
MissingKeyMapError	خطأ	لا يتضمّن عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات مَعلمة المصادقة المطلوبة. إذا كنت تستخدم واجهة برمجة التطبيقات العادية لـ JavaScript في "خرائط Google"، يجب استخدام مَعلمة key مع مفتاح صالح لواجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على بدء استخدام Google Maps Platform. إذا كنت أحد عملاء الخطة المميّزة، عليك استخدام مَعلمة client مع معرّف العميل، أو مَعلمة key مع مفتاح واجهة برمجة تطبيقات صالح. لمزيد من المعلومات، يُرجى الاطّلاع على دليل مفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء. إذا لم تكن مالك الموقع الإلكتروني، لا يمكنك اتّخاذ أي خطوات لإصلاح هذا الخطأ. ومع ذلك، ننصحك بإشعار مالك الموقع الإلكتروني إذا أمكن.
ProjectDeniedMapError	خطأ	لم يتم إكمال طلبك. قد تتمكّن من العثور على المزيد من التفاصيل حول الخطأ في Cloud Console. راجِع Cloud Console.
RefererDeniedMapError	خطأ	تم حظر تطبيقك بسبب عدم امتثاله لبنود خدمة "منصة خرائط Google"، وذلك بعد تلقّي عدة إشعارات عبر البريد الإلكتروني. لتقديم طلب إعادة نظر بشأن المنع ومراجعة عملية التنفيذ، يُرجى إكمال هذا النموذج. سيصلك ردّ عبر البريد الإلكتروني في غضون بضعة أيام عمل.
RefererNotAllowedMapError	خطأ	لم تتم إضافة عنوان URL الحالي الذي يحمّل واجهة برمجة التطبيقات JavaScript خرائط Google إلى قائمة المُحيلِين المسموح بهم. يُرجى التحقّق من إعدادات المُحيل لمفتاح واجهة برمجة التطبيقات في Cloud Console. اطّلِع على واجهة برمجة التطبيقات Maps JavaScript API واحصل على مفتاح واجهة برمجة التطبيقات.
OverQuotaMapError	خطأ	تجاوز عدد الطلبات حدود الاستخدام لواجهة برمجة التطبيقات Maps JavaScript API. ستتمكّن طلبات تطبيقك من العمل مرة أخرى عند إعادة ضبط الحصة اليومية التالية. إذا لم تكن مالك الموقع الإلكتروني، لا يمكنك اتّخاذ أي خطوات لمحاولة حلّ هذا الخطأ. ومع ذلك، ننصحك بإشعار مالك الموقع الإلكتروني إذا أمكن. لمزيد من التفاصيل، اطّلِع على دليل حدود الاستخدام. توضّح الصفحة أيضًا كيفية الحصول على حدود استخدام أعلى.
ApiProjectMapError	خطأ	تعذّر حلّ مفتاح واجهة برمجة التطبيقات المقدَّم أو مشروع واجهة برمجة التطبيقات المرتبط به. قد يكون هذا الخطأ مؤقتًا. في حال استمرار ظهور رسالة الخطأ هذه، قد تحتاج إلى الحصول على مفتاح جديد لواجهة برمجة التطبيقات أو إنشاء مشروع جديد لواجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على بدء استخدام Google Maps Platform.
ClientIdLooksLikeCryptoKey	تحذير	من المحتمل أنّك قد قدّمت مفتاح تشفير في المَعلمة client. إذا كان لديك خطة Premium أو ترخيص "واجهات برمجة التطبيقات في خرائط Google" لإصدار Work، يُرجى تحديد رقم تعريف العميل كمَعلمة client. لست بحاجة إلى استخدام مفتاح التشفير لواجهة برمجة التطبيقات JavaScript لـ "خرائط Google". اطّلِع على دليل معرّفات العميل لعملاء الخطة المميّزة وواجهات برمجة تطبيقات "خرائط Google" لعملاء Workspace.
ClientIdLooksLikeKey	تحذير	من المحتمل أنّك قد قدّمت مفتاح واجهة برمجة التطبيقات في المَعلمة client. إذا كان لديك خطة Premium أو ترخيص "واجهات برمجة التطبيقات في خرائط Google" لإصدار Work، يُرجى تحديد معرّف العميل كمَعلمة client. إذا كانت لديك خطة Premium في "منصة خرائط Google"، يمكنك استخدام مَعلمة client أو مَعلمة key. إذا لم يكن لديك أي تراخيص، يجب استخدام مَعلمة key بدلاً من مَعلمة client . اطّلِع على دليل مصادقة الخطة المميّزة.
InvalidChannel	تحذير	قد تكون قد قدّمت مَعلمة channel غير صالحة. يجب أن تكون القناة سلسلة أبجدية رقمية بترميز ASCII، ويمكن أن تتضمّن نقطة (.) وشرطة سفلية (_) وواصلة (-). يُرجى التأكّد من تحديد مَعلمة channel صالحة. اطّلِع على إعداد التقارير | خطة Google Maps Platform Premium.
InvalidClientId	تحذير	يبدو أنّ المَعلمة client لا تحتوي على رقم تعريف العميل الصحيح. يجب أن يبدأ معرّف العميل بـ "gme-". اطّلِع على دليل مصادقة الخطة المميّزة.
InvalidKey	تحذير	يبدو أنّ مفتاح واجهة برمجة التطبيقات المُدرَج في عنصر النص البرمجي الذي يحمِّل واجهة برمجة التطبيقات غير صحيح. يُرجى التأكّد من استخدام مفتاح واجهة برمجة التطبيقات الصحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه. البدء
InvalidVersion	تحذير	قد تكون قد قدّمت رقم إصدار غير صحيح في عنصر النص البرمجي. يُرجى التأكّد من استخدام رقم الإصدار الصحيح. راجِع إصدارات واجهة برمجة التطبيقات | Google Maps JavaScript API.
KeyLooksLikeClientId	تحذير	من المحتمل أنّك قد قدّمت معرّف عميل كمَعلمة key. إذا كان لديك خطة Premium أو ترخيص "واجهات برمجة تطبيقات خرائط Google" لإصدار Work، يُرجى تحديد معرّف العميل كمَعلمة client بدلاً من المَعلمة key. إذا كانت لديك خطة Premium في "منصة خرائط Google"، يمكنك استخدام مَعلمة client أو مَعلمة key. إذا لم يكن لديك أي تراخيص، يجب استخدام مَعلمة key بدلاً من مَعلمة client . اطّلِع على دليل مصادقة الخطة المميّزة.
KeyLooksLikeCryptoKey	تحذير	قد تكون قد قدّمت مفتاح تشفير أو سر توقيع كمَعلمة key. إذا كانت لديك "خطة Premium" أو ترخيص "واجهات برمجة تطبيقات خرائط Google" لإصدار "العمل"، يُرجى تحديد معرّف العميل كمَعلمة client، وإزالة المَعلمة key من عنصر النص البرمجي. المفتاح التشفيري ليس مطلوبًا لواجهة برمجة تطبيقات JavaScript لخرائط Google. إذا كانت لديك خطة Premium في "منصة خرائط Google"، يمكنك استخدام مَعلمة client أو مَعلمة key. إذا لم يكن لديك أي تراخيص، يمكنك الحصول على مفتاح واجهة برمجة التطبيقات في Cloud Console. اطّلِع على دليل تحديد معرّف العميل عند تحميل واجهة برمجة التطبيقات.
KeyLooksLikeProjectNumber	تحذير	من المحتمل أنّك قد قدّمت رقم مشروع كمَعلمة key. يُرجى التأكّد من استخدام مفتاح واجهة برمجة التطبيقات الصحيح. يمكنك إنشاء مفتاح جديد لواجهة برمجة التطبيقات في Cloud Console. تعرَّف على كيفية الحصول على مفتاح واجهة برمجة التطبيقات.
NoApiKeys	تحذير	لا يحتوي عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات على مفتاح واجهة برمجة التطبيقات. يُرجى التأكّد من تضمين مفتاح واجهة برمجة تطبيقات صالح كمَعلمة key. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه للبدء. البدء في حال تحميل واجهة برمجة تطبيقات JavaScript لخرائط Google من مسار الإصدار 2 المتوقّف نهائيًا، ستتلقّى تحذير NoApiKeys، حتى إذا حدّدت المَعلمة key. يُرجى الاطّلاع على دليل الترقية من الإصدار 2 إلى الإصدار 3 ونقل بيانات تطبيقك إلى الإصدار 3 من واجهة برمجة التطبيقات JavaScript لخرائط Google.
RetiredVersion	تحذير	من المحتمل أنّك قد قدّمت إصدارًا متوقّفًا في عنصر النص البرمجي. يُرجى تحديث تطبيقك لاستخدام أحد الإصدارات المتاحة. راجِع إصدارات واجهة برمجة التطبيقات | Google Maps JavaScript API.
SensorNotRequired	تحذير	لم تعُد المَعلمة sensor مطلوبة لتطبيق Maps JavaScript API. ولن يؤدي ذلك إلى منع Maps JavaScript API من العمل بشكل صحيح، ولكننا ننصح بإزالة المَعلمة sensor من عنصر النص البرمجي.
SignatureNotRequired	تحذير	لا تكون المَعلمة signature مطلوبة لأجل Maps JavaScript API. ولن يؤدي ذلك إلى منع Maps JavaScript API من العمل بشكل صحيح، ولكن قد يؤدي إلى حدوث مخاطر أمنية. يُرجى إزالته من عنصر النص البرمجي.
SignedInNotSupported	تحذير	تم إيقاف مَعلمة signed_in نهائيًا وهي غير متاحة في الإصدار من واجهة برمجة التطبيقات Maps JavaScript API التي تستخدمها. لن يؤدي ذلك إلى منع واجهة برمجة التطبيقات JavaScript لـ "خرائط Google" من العمل، ولكن قد يتغيّر سلوك تطبيقك، إذا كنت تعتمد على الميزات التي تتطلّب تسجيل الدخول.
UrlAuthenticationCommonError	خطأ	حدث خطأ لا يندرج ضمن أي من الفئات الأخرى في هذه الصفحة. قد يرجع سبب ذلك إلى مشكلة مؤقتة. يُرجى إعادة محاولة تنفيذ الطلب بعد فترة قصيرة. إذا لم يؤدّ ذلك إلى حلّ المشكلة، يُرجى مراجعة دليل المطوّر للتأكّد من أنّ الطلب بالتنسيق الصحيح.

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

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

• Web Console لمتصفّح Firefox
• تصحيح الأخطاء عن بُعد لنظام التشغيل Android
• Web Inspector لأجهزة iOS

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

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

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

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

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

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

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

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

إذا كنت تُطوّر تطبيقًا أصليًا لنظام التشغيل Windows يتم تشغيله في WebView، تأكَّد من استخدام WebView2 المستنِد إلى Edge. لم تعُد الإصدارات السابقة من WebView، المستندة إلى Internet Explorer، متوافقة.

في حال استمرار عدم عمل الرمز

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

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