رسائل الخطأ

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

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

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

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

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

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

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

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

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

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

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

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

• إذا كان بإمكانك الوصول إلى الرمز المصدر لتطبيقك، ابحث عن علامة <script> التي يتم استخدامها لتحميل Maps JavaScript API. عند تحميل Maps JavaScript API، استبدِل 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".
البدء

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تكتب Maps JavaScript API رسائل الخطأ في 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]

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

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

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

تأكَّد من أنّ إصدار المتصفّح الذي تستخدمه متوافق حاليًا مع Maps JavaScript API.

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

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

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

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