رسائل الخطأ

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

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

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

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

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

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

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

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

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

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

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

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

• إذا كانت لديك إمكانية الوصول إلى رمز مصدر التطبيق، فابحث عن علامة <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 واختَر المشروع الذي تم إنشاء مفتاح واجهة برمجة التطبيقات بموجبه. للتأكد من ارتباط المفتاح بالمشروع:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

رمز الخطأ للمطوِّر	النوع	الوصف
ApiNotActivatedMapError	خطأ	لم يتم تنشيط واجهة برمجة تطبيقات JavaScript للخرائط في مشروع واجهة برمجة التطبيقات الخاص بك. قد تحتاج إلى تفعيل واجهة برمجة تطبيقات JavaScript للخرائط ضمن واجهات برمجة التطبيقات في Google Cloud Console. لتفعيل Maps JavaScript API لمشروعك، انقر على الزر أدناه. تعرَّف على كيفية إجراء ذلك
ApiTargetBlockedMapError	خطأ	مفتاح واجهة برمجة التطبيقات هذا غير مُصرَّح له باستخدام هذه الخدمة أو واجهة برمجة التطبيقات. يُرجى التحقق إعدادات قيود واجهة برمجة التطبيقات لمفتاح واجهة برمجة التطبيقات في وحدة التحكّم في Google Cloud لضمان أنّ جميع واجهات برمجة التطبيقات والخدمات التي تحتاج إليها للاستخدام يتم تحديدها بشكل صحيح في قائمة واجهات برمجة التطبيقات المفعّلة. عرض مفاتيح واجهة برمجة التطبيقات في 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 Maps Platform، بعد اتّباع العديد من الإشعارات عبر البريد الإلكتروني لتقديم طلب إعادة النظر في حظر هذه الإعلانات ومراجعتها، يُرجى إكمال هذا النموذج. سيصلك ردّ عبر البريد الإلكتروني في غضون بضعة أيام عمل.
RefererNotAllowedMapError	خطأ	عدم استخدام عنوان URL الحالي الذي يحمِّل واجهة برمجة تطبيقات JavaScript للخرائط تمت إضافتها إلى قائمة المُحيلين المسموح بهم. يُرجى التحقق من المُحيل إعدادات مفتاح واجهة برمجة التطبيقات في Cloud Console. يمكنك الاطّلاع على واجهة برمجة تطبيقات JavaScript للخرائط الحصول على مفتاح واجهة برمجة تطبيقات
OverQuotaMapError	خطأ	تجاوز عدد الطلبات حدود الاستخدام واجهة برمجة تطبيقات JavaScript للخرائط. سيتم تنفيذ طلبات تطبيقك مرة أخرى عند إعادة ضبط الحصة اليومية التالية. إذا لم تكن مالك الموقع الإلكتروني، ما مِن خطوات يمكنك اتّخاذها وإصلاح هذا الخطأ. ومع ذلك، قد تحتاج إلى إبلاغ مالك الموقع الإلكتروني إن أمكن. لمزيد من التفاصيل، راجع دليل وحدود الاستخدام. توضّح الصفحة أيضًا كيفية تحقيق النجاح وحدود الاستخدام.
ApiProjectMapError	خطأ	مفتاح واجهة برمجة التطبيقات المقدَّم أو مشروع واجهة برمجة التطبيقات المرتبط به، تعذر حلها. قد يكون هذا الخطأ مؤقتًا. إذا ظهرت رسالة الخطأ هذه غير متوفر، قد تحتاج إلى الحصول على مفتاح واجهة برمجة تطبيقات جديد أو إنشاء مشروع واجهة برمجة تطبيقات جديد. لمزيد من المعلومات، يُرجى مراجعة بدء استخدام "منصة خرائط Google"
ClientIdLooksLikeCryptoKey	تحذير	يُحتمل أنّك قدّمت مفتاح تشفير في client. . إذا كنت مشتركًا في خطة Premium أو ترخيص Maps APIs for Work، يُرجى التحديد معرِّف العميل كمعلمة client. لا يجب عليك استخدام مفتاح التشفير في Maps JavaScript API. اطّلِع على دليل العميل المعرّفات للخطة المميّزة عملاء Maps APIs for Work.
ClientIdLooksLikeKey	تحذير	قد يعود السبب إلى أنّك قدّمت مفتاح واجهة برمجة التطبيقات في مَعلمة client. إذا كنت مشتركًا في خطة Premium أو ترخيص 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. . إذا كنت مشتركًا في خطة Premium أو ترخيص 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 إلى الإصدار 3 وترحيل تطبيقك إلى الإصدار 3 من واجهة برمجة تطبيقات JavaScript لـ "خرائط Google".
RetiredVersion	تحذير	ربما تكون قد قدّمت نسخة تمت إزالتها في عنصر النص البرمجي. يُرجى تحديث تطبيقك لاستخدام أحد الإصدارات المتاحة. عرض تحديد الإصدارات | واجهة برمجة تطبيقات JavaScript لـ "خرائط Google":
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 على النحو التالي.

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]

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

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

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

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

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

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

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

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