إشعار الأمان: نما إلى علمنا بمشكلة أمنية قد تؤثر في المواقع الإلكترونية التي تستخدم مكتبات معيّنة تابعة لجهات خارجية (بما في ذلك polyfill.io). وقد تؤدي هذه المشكلة في بعض الأحيان إلى إعادة توجيه الزائرين بعيدًا عن الموقع الإلكتروني المقصود بدون معرفة مالك الموقع أو إذنه. وفي السابق، كان يتضمّن العديد من نماذج JavaScript تعريف النص البرمجي polyfill.io. تمت إزالة هذا المحتوى من نماذجنا. إذا كنت قد استخدمت نماذج JavaScript التي تحتوي على هذا التعريف، ننصحك بإزالة التعريف.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

رسائل الخطأ

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

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

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

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

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

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

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

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

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

تحذير بشأن واجهة برمجة تطبيقات JavaScript لـ "خرائط Google": NoApiKeys
خطأ في واجهة برمجة تطبيقات JavaScript لخرائط Google: MissingKeyMapError

لمطوّري البرامج على الويب:

إذا كان بإمكانك الوصول إلى رمز المصدر لتطبيقك، ابحث عن علامة <script> التي تُستخدَم لتحميل واجهة برمجة التطبيقات JavaScript لخرائط Google. عند تحميل واجهة برمجة تطبيقات JavaScript للخرائط، استبدِل YOUR_API_KEY في الرمز أدناه باستخدام مفتاح واجهة برمجة التطبيقات.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
تحقق من حركة بيانات الشبكة الناتجة عن موقعك الإلكتروني في المتصفح. في Chrome، يمكن الاطّلاع على ذلك باستخدام علامة التبويب الشبكة في أدوات المطوّرين. ستظهر لك هنا طلبات الشبكة التي يقدّمها موقعك الإلكتروني. ستتم إضافة الطلبات التي يتم إجراؤها باستخدام Maps JavaScript API ضمن المسار maps/api/js. يمكنك هنا التأكّد مما إذا كانت الطلبات تستخدِم المَعلمة key. قد يكون من المفيد فلترة حركة بيانات الشبكة حسب maps/api/js عند عرض علامة التبويب الشبكة.

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

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

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

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

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

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

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

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

بعد تحديد موقع مشروعك على Cloud Console التحقّق من إرفاق حساب الفوترة من خلال الانتقال إلى قسم الفوترة في القائمة الجانبية اليمنى

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

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

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

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

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

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

هل تم تجاوز الحد اليومي الذي تفرضه واجهة برمجة التطبيقات بشكل ذاتي؟

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

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

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

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

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

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

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

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

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

رمز الخطأ الرسالة الوصف

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

NotLoadingAPIFromGoogleMapsError

يجب تنزيل واجهة برمجة تطبيقات JavaScript للخرائط مباشرةً من موقع الخوادم.

عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات JavaScript لتطبيق "خرائط Google" غير مضمّن بشكل صحيح في صفحتك. لكي تعمل واجهة برمجة التطبيقات بشكلٍ صحيح، يجب تحميلها مباشرةً من https://maps.googleapis.com.

راجِع تحميل واجهة برمجة التطبيقات Maps JavaScript API.

TOSViolationMapError

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

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

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

UnauthorizedURLForClientIdMapError

لا يملك عنوان URL هذا الإذن لاستخدام معرّف العميل المقدَّم في "خرائط Google".

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

عرض تسجيل عناوين URL المسموح بها

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

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

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

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

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

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

Web Console لمتصفّح Firefox
تصحيح الأخطاء عن بُعد لنظام التشغيل Android
Web Inspector (أداة فحص الويب) لنظام التشغيل iOS.

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

لفتح "أدوات المطوّرين"، انقر على رمز القائمة > المزيد من الأدوات > أدوات المطوّرين.
لفتح وحدة تحكّم 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".

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

إذا لم يعمل الرمز بعد

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

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