حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

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

رسائل الخطأ

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

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

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

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

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

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

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

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

استخدِم إضافة Chrome‏ Google Maps Platform API Checker. يتيح لك ذلك تحديد ما إذا كان موقعك الإلكتروني ينفّذ واجهات برمجة التطبيقات المرخّصة من Google Maps بشكل صحيح.
إذا كنت تستخدم مكتبة أو مكوّنًا إضافيًا لتحميل 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 واختَر المشروع الذي تم إنشاء مفتاح واجهة برمجة التطبيقات ضمنه. للتأكّد من أنّ المفتاح مرتبط بالمشروع، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

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

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

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

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

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

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

NotLoadingAPIFromGoogleMapsError

يجب تنزيل Maps JavaScript API مباشرةً من خوادم Google.

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

يُرجى الاطّلاع على تحميل Maps JavaScript API.

TOSViolationMapError

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

تم حظر تطبيقك بسبب عدم امتثاله لبنود خدمة "منصة خرائط Google"، وذلك بعد إرسال عدة إشعارات عبر البريد الإلكتروني. لطلب إعادة النظر في الحظر ومراجعة عملية التنفيذ، يُرجى إكمال نموذج طلب إعادة النظر في بنود خدمة "منصة خرائط 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 API. يمكنك إنشاء مشروع جديد لواجهة برمجة التطبيقات والحصول على مفتاح جديد في وحدة تحكّم Cloud. لإنشاء مشروع جديد والحصول على مفتاح واجهة برمجة تطبيقات للمشروع، انقر على الزر أدناه. التعرّف على كيفية إجراء ذلك
`ClientBillingNotEnabledMapError`	خطأ	لم يتم تفعيل الفوترة في مشروعك. يجب تفعيل الفوترة في مشروع Google Cloud المرتبط بمعرّف العميل هذا.
`BillingNotEnabledMapError`	خطأ	لم يتم تفعيل الفوترة في مشروعك، ما يؤدي إلى حدوث هذا الخطأ. يجب تفعيل الفوترة في مشروع Google Cloud. مزيد من المعلومات
`ExpiredKeyMapError`	خطأ	انتهت صلاحية مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات أو لم يتعرّف عليه النظام. قد يظهر لك هذا الخطأ بعد إنشاء مفتاح واجهة برمجة تطبيقات جديد إذا حاولت استخدام المفتاح قبل أن يتعرّف عليه النظام. يُرجى الانتظار بضع دقائق ثم إعادة المحاولة، أو قد تحتاج إلى إنشاء مفتاح جديد لواجهة برمجة التطبيقات في وحدة تحكّم Cloud. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه. البدء
`InvalidAppCheckTokenMapError`	خطأ	الرمز المميّز المقدَّم لميزة "فحص التطبيقات" غير صالح أو منتهي الصلاحية. لا يمكن أن يحدث هذا الخطأ إلا في حال استخدام ميزة "فحص التطبيقات". يُرجى الاطّلاع على دليل التحقّق من ميزة "فحص التطبيقات".
`InvalidClientIdMapError`	خطأ	لتعزيز أمان المصادقة وموثوقيتها، تم إيقاف معرّفات عملاء "منصة خرائط Google" نهائيًا اعتبارًا من 26 مايو 2025، ولن يكون بالإمكان استخدامها بعد 31 مايو 2026. بدلاً من استخدام معرّف العميل، يجب استخدام بيانات اعتماد مفتاح واجهة برمجة التطبيقات لمصادقة زيارات خدمة Google Maps API. لمزيد من المعلومات، يُرجى الاطّلاع على دليل نقل معرّفات العملاء. اتّبِع الخطوات الواردة في الدليل لاستعادة معرّف العميل مؤقتًا.
`InvalidKeyMapError`	خطأ	لم يتم العثور على مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات. يُرجى التأكّد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح واجهة برمجة التطبيقات جديد في Cloud Console. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه. البدء
`MalformedCredentialsMapError`	خطأ	يستخدم تطبيقك مخطّط URI غير متوافق. تأكَّد من أنّ التطبيق يستخدم تنسيق معرّف موارد منتظم (URI) صالحًا على النحو المحدّد في RFC 3986.
`MissingKeyMapError`	خطأ	لا يتضمّن عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات مَعلمة المصادقة المطلوبة. إذا كنت تستخدم Maps JavaScript API، عليك استخدام مَعلمة `key` مع مفتاح واجهة برمجة تطبيقات صالح. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة بدء استخدام "منصة خرائط Google". إذا كنت تستخدم معرِّف عميل، يجب استخدام المَعلمة `client` مع معرِّف العميل أو المَعلمة `key` مع مفتاح واجهة برمجة تطبيقات صالح. لمزيد من المعلومات، يُرجى الاطّلاع على دليل مفاتيح واجهة برمجة التطبيقات ومعرّفات العملاء. إذا لم تكن مالك الموقع الإلكتروني، لن تتمكّن من اتّخاذ أي خطوات لإصلاح هذا الخطأ. ومع ذلك، قد تحتاج إلى إبلاغ مالك الموقع الإلكتروني إن أمكن.
`ProjectDeniedMapError`	خطأ	لم يكتمل طلبك. قد تتمكّن من العثور على مزيد من التفاصيل حول الخطأ في Google Cloud Console. يُرجى الاطّلاع على وحدة تحكّم Cloud.
`RefererDeniedMapError`	خطأ	تم حظر تطبيقك بسبب عدم امتثاله لبنود خدمة "منصة خرائط Google"، وذلك بعد إرسال عدة إشعارات عبر البريد الإلكتروني. لطلب إعادة النظر في الحظر ومراجعة عملية التنفيذ، يُرجى إكمال نموذج طلب إعادة النظر في بنود خدمة "منصة خرائط 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. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه. البدء
`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. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه للبدء. البدء إذا كنت تحمّل Maps JavaScript API من مسار الإصدار 2 المتوقّف نهائيًا، سيظهر لك التحذير `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 في بعض المتصفّحات الأخرى.

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

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

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