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

رسائل الخطأ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

هل لم تعد طريقة الفوترة المقدمة صالحة (على سبيل المثال، بطاقة ائتمان منتهية الصلاحية)؟

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

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

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

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

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

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

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

رموز خطأ جافا سكريبت لواجهة برمجة تطبيقات الخرائط لمطوّري البرامج ومالكي المواقع

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

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

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

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

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

NotLoadingAPIFromGoogleMapsError

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

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

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

TOSViolationMapError

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

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

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

UnauthorizedURLForClientIdMapError

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

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

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

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

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

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

رمز خطأ مطوّر البرامج	النوع	الوصف
`ApiNotActivatedMapError`	خطأ	لم يتم تنشيط واجهة برمجة تطبيقات جافا سكريبت للخرائط في مشروع واجهة برمجة التطبيقات. قد تحتاج إلى تفعيل واجهة برمجة تطبيقات JavaScript للخرائط ضمن واجهات برمجة التطبيقات في Google Cloud Console. لتنشيط واجهة برمجة التطبيقات لجافا سكريبت في مشروعك، انقر على الزر أدناه. تعرّف على كيفية إجراء ذلك
`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 for Work، ستحتاج إلى استخدام معلَمة `key` مع مفتاح واجهة برمجة التطبيقات بدلاً من معلَمة `client`. راجع دليل مصادقة الخطة المميزة.
`InvalidKeyMapError`	خطأ	لم يتم العثور على مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات. يُرجى التأكد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console. للحصول على مفتاح واجهة برمجة تطبيقات، انقر على الزر أدناه. البدء
`MalformedCredentialsMapError`	خطأ	يستخدم تطبيقك مخطط URI غير مدعوم. تأكد من أن التطبيق يستخدم تنسيق URI صالحًا كما هو محدد في RFC 3986.
`MissingKeyMapError`	خطأ	يفتقد عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات معلمة المصادقة المطلوبة. إذا كنت تستخدم واجهة برمجة تطبيقات JavaScript 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`. إذا كان لديك ترخيص Premium أو Maps API for Work، يُرجى تحديد معرِّف العميل الخاص بك كمعلمة `client`. لا تحتاج إلى استخدام مفتاح التشفير لواجهة برمجة تطبيقات JavaScript للخرائط. اطّلع على دليل معرِّفات العملاء لعملاء Premium وMaps API for Work.
`ClientIdLooksLikeKey`	التحذير	من المحتمل أنك قدّمت مفتاح واجهة برمجة تطبيقات في المَعلمة `client`. إذا كان لديك ترخيص Premium أو Maps API for Work، يُرجى تحديد معرِّف العميل على أنه المعلمة `client`. إذا كنت مشتركًا في خطة مميّزة في Google Maps Platform Premium، يمكنك استخدام معلَمة `client` أو معلَمة `key`. إذا لم يكن لديك أي تراخيص، يجب استخدام معلمة `key` بدلاً من معلمة `client`. راجع دليل مصادقة الخطة المميزة.
`InvalidChannel`	التحذير	من المحتمل أنك قدّمت مَعلمة `channel` غير صالحة. يجب أن تكون القناة سلسلة أبجدية رقمية ASCII، ويمكن أن تحتوي على نقطة (.) وشرطة سفلية (_) وواصلة (-). يُرجى التأكد من تحديد معلمة `channel` صالحة. اطّلِع على إعداد التقارير \| خطة Google Maps Platform Premium.
`InvalidClientId`	التحذير	يبدو أن المَعلمة `client` لا تحتوي على معرِّف عميل صحيح. يجب أن يبدأ معرِّف العميل بـ "gme-". راجع دليل مصادقة الخطة المميزة.
`InvalidKey`	التحذير	لا يبدو مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات صحيحًا. يُرجى التأكد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح جديد لواجهة برمجة التطبيقات في Cloud Console. للحصول على مفتاح واجهة برمجة تطبيقات، انقر على الزر أدناه. البدء
`InvalidVersion`	التحذير	ربما قدّمت رقم إصدار غير صحيح في عنصر النص البرمجي. يُرجى التأكد من استخدام رقم إصدار صحيح. راجع تحديد الإصدارات \| واجهة برمجة تطبيقات JavaScript لخرائط Google.
`KeyLooksLikeClientId`	التحذير	من المحتمل أنك قدّمت معرّف عميل كمعلّمة `key`. إذا كانت لديك خطة مميّزة أو ترخيص Maps API for Work، يُرجى تحديد معرِّف العميل الخاص بك كمعلمة `client` بدلاً من المعلمة `key`. إذا كنت مشتركًا في خطة مميّزة في Google Maps Platform Premium، يمكنك استخدام معلَمة `client` أو معلَمة `key`. إذا لم يكن لديك أي تراخيص، يجب استخدام معلمة `key` بدلاً من معلمة `client`. راجع دليل مصادقة الخطة المميزة.
`KeyLooksLikeCryptoKey`	التحذير	من المحتمل أنك قدّمت مفتاح تشفير أو سر توقيع كمَعلمة `key`. إذا كان لديك ترخيص Premium أو Maps API for Work، يُرجى تحديد معرِّف العميل كمعلَمة `client` وإزالة المَعلمة `key` من عنصر النص البرمجي. مفتاح التشفير غير مطلوب لواجهة برمجة تطبيقات JavaScript للخرائط. إذا كنت مشتركًا في خطة مميّزة في Google Maps Platform Premium، يمكنك استخدام معلَمة `client` أو معلَمة `key`. إذا لم يكن لديك أي تراخيص، يمكنك الحصول على مفتاح واجهة برمجة التطبيقات في Cloud Console. راجِع دليل تحديد معرِّف عميل عند تحميل واجهة برمجة التطبيقات.
`KeyLooksLikeProjectNumber`	التحذير	ربما قدمت رقم المشروع كمعلمة `key`. يُرجى التأكد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح جديد لواجهة برمجة التطبيقات في Cloud Console. تعرَّف على كيفية الحصول على مفتاح واجهة برمجة تطبيقات.
`NoApiKeys`	التحذير	لا يحتوي عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات على مفتاح واجهة برمجة تطبيقات. يُرجى التأكد من تضمين مفتاح واجهة برمجة تطبيقات صالح كمَعلمة `key`. يمكنك إنشاء مفتاح جديد لواجهة برمجة التطبيقات في Cloud Console. للحصول على مفتاح واجهة برمجة تطبيقات، انقر على الزر أدناه للبدء. البدء في حال تحميل واجهة برمجة تطبيقات JavaScript للخرائط من مسار الإصدار 2 الذي تم إيقافه، ستتلقّى تحذير `NoApiKeys`، حتى إذا حددت معلمة `key`. يُرجى الاطّلاع على دليل ترقية الإصدار v2 إلى v3 ونقل تطبيقك إلى الإصدار 3 من JavaScript JavaScript API.
`RetiredVersion`	التحذير	ربما قدمت إصدارًا متقاعدًا في عنصر النص البرمجي. يُرجى تحديث التطبيق لاستخدام أحد الإصدارات المتاحة. راجع تحديد الإصدارات \| واجهة برمجة تطبيقات JavaScript لخرائط Google.
`SensorNotRequired`	التحذير	لم تعد معلَمة `sensor` مطلوبة لواجهة برمجة تطبيقات JavaScript للخرائط. ولن يمنع هذا الإجراء واجهة برمجة تطبيقات JavaScript للخرائط من العمل بشكل صحيح، ولكننا ننصحك بإزالة المعلَمة `sensor` من عنصر النص البرمجي.
`SignatureNotRequired`	التحذير	معلمة `signature` غير مطلوبة لواجهة برمجة تطبيقات JavaScript للخرائط. ولن يمنع هذا الإجراء واجهة برمجة تطبيقات JavaScript للخرائط من العمل بشكل صحيح، ولكنه قد يعرّضك لمخاطر أمنية. يُرجى إزالته من عنصر النص البرمجي.
`SignedInNotSupported`	التحذير	تم إيقاف المعلمة `signed_in` نهائيًا وهي غير متاحة على إصدار واجهة برمجة تطبيقات JavaScript للخرائط الذي تستخدمه. لن يمنع هذا الإجراء "واجهة برمجة تطبيقات JavaScript" للخرائط من العمل، ولكن قد يتغير سلوك التطبيق، إذا كنت تعتمد على الميزات التي تم تسجيل الدخول إليها.
`UrlAuthenticationCommonError`	خطأ	حدث خطأ لا يتلاءم مع الفئات الأخرى على هذه الصفحة. قد يرجع ذلك إلى مشكلة مؤقتة. يُرجى إعادة محاولة الطلب بعد مهلة قصيرة. إذا لم يفلح ذلك في حل المشكلة، يُرجى مراجعة دليل المطوِّر للتأكد من استخدام الطلب تنسيقًا صحيحًا.

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

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

وحدة تحكم الويب لمتصفح فايرفوكس.
تصحيح الأخطاء عن بُعد لنظام التشغيل Android.
أداة فحص الويب لنظام التشغيل iOS.

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

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

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

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

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

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

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

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

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

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

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

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