رسائل الخطأ

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

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

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

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

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

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

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

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

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

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

• استخدِم إضافة Chrome Google Maps Platform API Checker. ويتيح لك ذلك تحديد ما إذا كان موقعك الإلكتروني يتّبع واجهات برمجة تطبيقات "خرائط Google" المرخَّصة من Google بشكل صحيح.
• إذا كنت تستخدم مكتبة أو مكوّنًا إضافيًا لتحميل Maps JavaScript API، تحقَّق من إعدادات تلك المكتبة وابحث عن خيار مفتاح واجهة برمجة التطبيقات.
• تحقّق من الأخطاء في المتصفّح. إذا ظهرت لك الرسائل التالية، يعني ذلك أنّك لا تستخدم مفتاح واجهة برمجة التطبيقات بشكل صحيح:
• تحذير بشأن واجهة برمجة التطبيقات لـ JavaScript في "خرائط Google": NoApiKeys
• خطأ في واجهة برمجة تطبيقات JavaScript في "خرائط Google": 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 الشبكة. ستظهر لك هنا طلبات الشبكة التي أجراها موقعك الإلكتروني. وستكون الطلبات التي يتم تقديمها باستخدام واجهة برمجة تطبيقات JavaScript للخرائط ضمن المسار maps/api/js. يمكنك هنا التأكّد مما إذا كانت الطلبات تستخدم المَعلمة key أم لا. قد يكون من المفيد فلترة حركة بيانات الشبكة حسب maps/api/js عند عرض علامة التبويب الشبكة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

رمز الخطأ الخاص بمطوّر البرامج	Type	الوصف
ApiNotActivatedMapError	خطأ	لم يتم تفعيل واجهة برمجة تطبيقات JavaScript للخرائط في مشروع واجهة برمجة التطبيقات الخاص بك. قد تحتاج إلى تفعيل واجهة برمجة تطبيقات JavaScript للخرائط ضمن واجهات برمجة التطبيقات في Google Cloud Console. لتفعيل Maps JavaScript API لمشروعك، انقر على الزر أدناه. التعرّف على كيفية إجراء ذلك
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 APIs for Work، ستحتاج إلى استخدام معلَمة key مع مفتاح واجهة برمجة التطبيقات بدلاً من المعلَمة client . راجِع دليل مصادقة الخطة المميّزة.
InvalidKeyMapError	خطأ	لم يتم العثور على مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمّل واجهة برمجة التطبيقات. يُرجى التأكّد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه. البدء
MalformedCredentialsMapError	خطأ	يستخدم تطبيقك مخطط معرّف موارد منتظم (URI) غير متوافق. تأكَّد من أنّ التطبيق يستخدم تنسيق معرّف موارد منتظم (URI) صالح كما هو موضّح في RFC 3986.
MissingKeyMapError	خطأ	يفتقد عنصر النص البرمجي الذي يحمِّل واجهة برمجة التطبيقات إلى معلمة المصادقة المطلوبة. إذا كنت تستخدم واجهة برمجة تطبيقات JavaScript العادية للخرائط، يجب استخدام المعلَمة key مع مفتاح واجهة برمجة تطبيقات صالح. لمزيد من المعلومات، اطّلِع على بدء استخدام "منصة خرائط Google". إذا كنت أحد عملاء الخطة المميّزة، عليك استخدام المَعلمة client مع معرّف العميل الخاص بك أو معلَمة key مع مفتاح صالح لواجهة برمجة التطبيقات. لمزيد من المعلومات، اطّلِع على دليل مفاتيح واجهة برمجة التطبيقات ومعرِّفات العملاء. إذا لم تكن مالك الموقع الإلكتروني، ليس هناك خطوات يمكنك اتّخاذها لإصلاح هذا الخطأ. ومع ذلك، يمكنك إبلاغ مالك الموقع الإلكتروني إن أمكن.
ProjectDeniedMapError	خطأ	لم يكتمل طلبك. قد تتمكّن من العثور على مزيد من التفاصيل حول الخطأ في Cloud Console. يُرجى الاطّلاع على Cloud Console.
RefererDeniedMapError	خطأ	تم حظر تطبيقك لعدم امتثاله لبنود خدمة "منصة خرائط Google" بعد تلقّي عدة إشعارات عبر البريد الإلكتروني. لتقديم طلب إعادة نظر في قرار الحظر ومراجعة عملية التنفيذ، يُرجى إكمال هذا النموذج. سيصلك ردّ عبر البريد الإلكتروني في غضون بضعة أيام عمل.
RefererNotAllowedMapError	خطأ	لم تتم إضافة عنوان URL الحالي الذي يُحمِّل واجهة برمجة تطبيقات JavaScript للخرائط إلى قائمة المُحيلين المسموح بهم. يُرجى التحقّق من إعدادات المُحيل لمفتاح واجهة برمجة التطبيقات في Cloud Console. يمكنك الاطّلاع على Maps JavaScript API والحصول على مفتاح واجهة برمجة تطبيقات.
OverQuotaMapError	خطأ	تجاوز عدد الطلبات حدود الاستخدام لواجهة برمجة تطبيقات JavaScript للخرائط. ستعمل طلبات تطبيقك مجددًا عند إعادة ضبط الحصة اليومية التالية. إذا لم تكن مالك الموقع الإلكتروني، ما مِن خطوات يمكنك اتّخاذها لإصلاح هذا الخطأ. ومع ذلك، يمكنك إبلاغ مالك الموقع الإلكتروني إن أمكن. لمزيد من التفاصيل، راجِع دليل حدود الاستخدام. توضّح الصفحة أيضًا طريقة زيادة حدود الاستخدام.
ApiProjectMapError	خطأ	تعذَّر حلّ مفتاح واجهة برمجة التطبيقات المقدَّم أو مشروع واجهة برمجة التطبيقات المرتبط به. قد يكون هذا الخطأ مؤقتًا. في حال استمرار رسالة الخطأ هذه، قد تحتاج إلى الحصول على مفتاح واجهة برمجة تطبيقات جديد أو إنشاء مشروع جديد لواجهة برمجة التطبيقات. لمزيد من المعلومات، اطّلِع على بدء استخدام "منصة خرائط Google".
ClientIdLooksLikeCryptoKey	تحذير	ربما قدَّمت مفتاح تشفير في المعلَمة client. إذا كان لديك ترخيص "خطة مميزة" أو ترخيص Maps APIs for Work، يُرجى تحديد معرِّف العميل الخاص بك على أنه المعلَمة client. لست بحاجة إلى استخدام مفتاح التشفير لواجهة Maps JavaScript API. راجِع دليل معرّفات العملاء لعملاء الخطة المميّزة وواجهات Maps API for Work.
ClientIdLooksLikeKey	تحذير	قد تكون قدّمت مفتاح واجهة برمجة التطبيقات في المعلَمة client. إذا كان لديك ترخيص "خطة مميزة" أو ترخيص Maps APIs for Work، يُرجى تحديد معرّف العميل الخاص بك على أنه معلَمة client. إذا كانت لديك خطة مميّزة في "منصة خرائط 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. إذا كانت لديك خطة مميّزة في "منصة خرائط Google"، يمكنك استخدام مَعلمة client أو معلَمة key. إذا لم يكن لديك أي تراخيص، عليك استخدام المعلَمة key بدلاً من المعلَمة client . راجِع دليل مصادقة الخطة المميّزة.
KeyLooksLikeCryptoKey	تحذير	ربما تكون قد قدّمت مفتاح تشفير أو مفتاح توقيع كمَعلمة key. إذا كنت تمتلك خطة مميّزة أو ترخيص Maps APIs for Work، يُرجى تحديد معرِّف العميل كمَعلمة client وإزالة المَعلمة key من عنصر النص البرمجي. ولا يكون مفتاح التشفير مطلوبًا لواجهة برمجة تطبيقات JavaScript للخرائط. إذا كانت لديك خطة مميّزة في "منصة خرائط Google"، يمكنك استخدام مَعلمة client أو معلَمة key. إذا لم يكن لديك أي تراخيص، يمكنك الحصول على مفتاح واجهة برمجة التطبيقات في Cloud Console. راجِع دليل تحديد معرِّف عميل عند تحميل واجهة برمجة التطبيقات.
KeyLooksLikeProjectNumber	تحذير	ربما قدّمت رقم مشروع كمَعلمة key. يُرجى التأكّد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console. تعرَّف على كيفية الحصول على مفتاح واجهة برمجة التطبيقات.
NoApiKeys	تحذير	لا يحتوي عنصر النص البرمجي الذي يُحمِّل واجهة برمجة التطبيقات على مفتاح واجهة برمجة تطبيقات. يُرجى التأكّد من تضمين مفتاح واجهة برمجة تطبيقات صالح كمَعلمة key. ويمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه للبدء. البدء في حال تحميل واجهة برمجة تطبيقات JavaScript للخرائط من مسار الإصدار 2 المتوقّف نهائيًا، ستتلقّى التحذير NoApiKeys حتى إذا حدّدت المعلَمة key. يُرجى مراجعة دليل الترقية من الإصدار 2 إلى الإصدار الثالث ونقل تطبيقك إلى الإصدار الثالث من واجهة برمجة تطبيقات JavaScript للخرائط.
RetiredVersion	تحذير	ربما قدمت نسخة قديمة في عنصر النص البرمجي الخاص بك. يُرجى تحديث تطبيقك لاستخدام أحد الإصدارات المتاحة. راجِع تحديد الإصدارات | واجهة برمجة تطبيقات JavaScript لخرائط Google.
SensorNotRequired	تحذير	لم تعُد المَعلمة sensor مطلوبة لواجهة برمجة تطبيقات JavaScript للخرائط. ولن يمنع ذلك عمل واجهة برمجة تطبيقات JavaScript للخرائط من العمل بشكل صحيح، ولكنّنا ننصحك بإزالة المعلَمة sensor من عنصر النص البرمجي.
SignatureNotRequired	تحذير	ولا تكون المعلَمة signature مطلوبة لواجهة برمجة تطبيقات JavaScript للخرائط. ولن يمنع تشغيل واجهة برمجة تطبيقات JavaScript للخرائط من العمل بشكل صحيح، ولكن قد يشكّل خطرًا أمنيًا. يُرجى إزالته من عنصر النص البرمجي.
SignedInNotSupported	تحذير	تم إيقاف المعلَمة signed_in نهائيًا، وهي غير متوافقة مع إصدار Maps JavaScript API الذي تستخدمه. ولن يمنع ذلك عمل واجهة برمجة تطبيقات JavaScript للخرائط من العمل، ولكن قد يتغيّر سلوك تطبيقك إذا كنت تعتمد على ميزات تسجيل الدخول.
UrlAuthenticationCommonError	خطأ	حدث خطأ لا يتناسب مع الفئات الأخرى في هذه الصفحة. يمكن أن يرجع ذلك إلى مشكلة مؤقتة. يُرجى إعادة محاولة الطلب بعد مهلة قصيرة. وإذا لم يؤدِّ ذلك إلى حلّ المشكلة، يُرجى مراجعة دليل المطوِّر للتأكّد من تنسيق الطلب الصحيح.

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

تكتب واجهة برمجة تطبيقات JavaScript للخرائط رسائل خطأ إلى 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 مرة أخرى لفتحها.

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

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