تصف هذه الصفحة رسائل الخطأ التي يمكن أن يعرضها خادم واجهة برمجة تطبيقات JavaScript للخرائط. تضيف واجهة برمجة تطبيقات JavaScript للخرائط رسائل الخطأ والتحذير إلى وحدة تحكم JavaScript. خطأ معين قد تحدث أيضًا ظروفًا، مما يؤدي إلى عرض صورة خريطة ذات علامة مائية.
مفتاح واجهة برمجة التطبيقات وأخطاء الفوترة
تحديد المشاكل وحلّها
في ظل ظروف معينة، تظهر خريطة مظلمة أو "سلبية" صورة "التجوّل الافتراضي" المميزة بعلامة مائية مع النص "لأغراض التطوير فقط" قد يتم عرضها. يشير هذا السلوك عادةً إلى مشاكل في مفتاح واجهة برمجة التطبيقات أو الفوترة. من أجل استخدام منتجات "منصة خرائط Google"، يجب تفعيل الفوترة في حسابك، ويجب أن تتضمّن جميع الطلبات مفتاح واجهة برمجة تطبيقات صالحًا. للحصول على مساعدة في العثور على رسائل الخطأ، راجع القسم الذي يتناول التحقق من الأخطاء في متصفحك.
ستساعدك الخطوات التالية في تحديد المشكلة وحلّها.
رموز الخطأ في JavaScript API للخرائط للمطوّرين ومالكي المواقع الإلكترونية
تسرد الجداول التالية رموز الخطأ المحتملة التي يعرضها Maps JavaScript API، مع وصف للسبب وكيفية لحلّ المشكلة. للحصول على مساعدة في العثور على رسائل الخطأ، راجع القسم الذي يتناول التحقق من الأخطاء في متصفحك.
أخطاء تحميل الخريطة
إذا حدث خطأ أثناء تحميل واجهة برمجة تطبيقات JavaScript للخرائط، يُرجى مراجعة الجدول التالي للعثور على تفسيرات لرموز الأخطاء.
رمز الخطأ | الرسالة | الوصف |
---|---|---|
NotLoadingAPIFromGoogleMapsError
|
يجب تنزيل واجهة برمجة تطبيقات JavaScript للخرائط مباشرةً من موقع الخوادم. |
عنصر النص البرمجي الذي يحمِّل واجهة برمجة تطبيقات JavaScript للخرائط هو لا يتم تضمينها بشكل صحيح في صفحتك. لكي تعمل واجهة برمجة التطبيقات بشكل صحيح، يجب تحميله مباشرةً من https://maps.googleapis.com. |
TOSViolationMapError
|
يبدو أنّ هذا الموقع الإلكتروني ينتهك بنود خدمة Google Maps API. تم إيقاف واجهة برمجة تطبيقات خرائط Google لهذا الموقع الإلكتروني. |
تم حظر تطبيقك بسبب عدم امتثاله بنود خدمة Google Maps Platform، بعد اتّباع العديد من الإشعارات عبر البريد الإلكتروني لتقديم طلب إعادة النظر في حظر هذه الإعلانات ومراجعتها، يُرجى إكمال هذا النموذج. سيصلك ردّ عبر البريد الإلكتروني في غضون بضعة أيام عمل. إذا كان لديك ترخيص "الخطة المميّزة من Google Maps Platform"، يُرجى استخدام يمكنك استخدام بيانات اعتماد الخطة المميّزة في "منصة خرائط Google" لحلّ هذا الخطأ. اطّلِع على دليل مصادقة "الخطة المميّزة" |
UnauthorizedURLForClientIdMapError
|
عنوان URL هذا غير مسموح له باستخدام معرِّف عميل "خرائط Google" الذي تم تقديمه. |
الخطة المميزة أو واجهات برمجة تطبيقات Maps for Work معرف العميل المضمن في تحميل النص البرمجي غير صالح، أو أن العنوان الحالي الذي يحمِّل لم تتم إضافة واجهة برمجة تطبيقات JavaScript للخرائط إلى قائمة عناوين 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، يلزمك استخدام
مَعلمة اطّلِع على دليل مصادقة "الخطة المميّزة" |
InvalidKeyMapError
|
خطأ |
مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمِّل واجهة برمجة التطبيقات ليس التي تم العثور عليها. يُرجى التأكد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه.
|
MalformedCredentialsMapError
|
خطأ |
يستخدم التطبيق مخطط URI غير متوافق. التحقق من أن التطبيق يستخدم تنسيق معرّف موارد منتظم (URI) صالح كما هو موضّح في RFC 3986. |
MissingKeyMapError
|
خطأ |
لا يحتوي عنصر النص البرمجي الذي يحمِّل واجهة برمجة التطبيقات على مَعلمة المصادقة المطلوبة. إذا كنت تستخدم واجهة برمجة تطبيقات JavaScript للخرائط القياسية، يجب استخدام
معلَمة إذا كنت أحد عملاء الخطة المميّزة، عليك
استخدام مَعلمة إذا لم تكن مالك الموقع الإلكتروني، ما مِن خطوات يمكنك اتّخاذها لحلّ هذه المشكلة. خطأ. ومع ذلك، قد تحتاج إلى إبلاغ مالك الموقع الإلكتروني، إن أمكن. |
ProjectDeniedMapError
|
خطأ |
لم يكتمل طلبك. قد تتمكّن من العثور على المزيد من تفاصيل حول الخطأ في Cloud Console. يُرجى الاطّلاع على Cloud Console. |
RefererDeniedMapError
|
خطأ |
تم حظر تطبيقك بسبب عدم امتثاله بنود خدمة Google Maps Platform، بعد اتّباع العديد من الإشعارات عبر البريد الإلكتروني لتقديم طلب إعادة النظر في حظر هذه الإعلانات ومراجعتها، يُرجى إكمال هذا النموذج. سيصلك ردّ عبر البريد الإلكتروني في غضون بضعة أيام عمل. |
RefererNotAllowedMapError
|
خطأ |
عدم استخدام عنوان URL الحالي الذي يحمِّل واجهة برمجة تطبيقات JavaScript للخرائط تمت إضافتها إلى قائمة المُحيلين المسموح بهم. يُرجى التحقق من المُحيل إعدادات مفتاح واجهة برمجة التطبيقات في Cloud Console. يمكنك الاطّلاع على واجهة برمجة تطبيقات JavaScript للخرائط الحصول على مفتاح واجهة برمجة تطبيقات |
OverQuotaMapError
|
خطأ |
تجاوز عدد الطلبات حدود الاستخدام واجهة برمجة تطبيقات JavaScript للخرائط. سيتم تنفيذ طلبات تطبيقك مرة أخرى عند إعادة ضبط الحصة اليومية التالية. إذا لم تكن مالك الموقع الإلكتروني، ما مِن خطوات يمكنك اتّخاذها وإصلاح هذا الخطأ. ومع ذلك، قد تحتاج إلى إبلاغ مالك الموقع الإلكتروني إن أمكن. لمزيد من التفاصيل، راجع دليل وحدود الاستخدام. توضّح الصفحة أيضًا كيفية تحقيق النجاح وحدود الاستخدام. |
ApiProjectMapError
|
خطأ |
مفتاح واجهة برمجة التطبيقات المقدَّم أو مشروع واجهة برمجة التطبيقات المرتبط به، تعذر حلها. قد يكون هذا الخطأ مؤقتًا. إذا ظهرت رسالة الخطأ هذه غير متوفر، قد تحتاج إلى الحصول على مفتاح واجهة برمجة تطبيقات جديد أو إنشاء مشروع واجهة برمجة تطبيقات جديد. لمزيد من المعلومات، يُرجى مراجعة بدء استخدام "منصة خرائط Google" |
ClientIdLooksLikeCryptoKey
|
تحذير |
يُحتمل أنّك قدّمت مفتاح تشفير في اطّلِع على دليل العميل المعرّفات للخطة المميّزة عملاء Maps APIs for Work. |
ClientIdLooksLikeKey
|
تحذير |
قد يعود السبب إلى أنّك قدّمت مفتاح واجهة برمجة التطبيقات في مَعلمة اطّلِع على دليل مصادقة "الخطة المميّزة" |
InvalidChannel
|
تحذير |
قد تكون قدّمت مَعلمة |
InvalidClientId
|
تحذير |
لا يبدو أنّ المَعلمة اطّلِع على دليل مصادقة "الخطة المميّزة" |
InvalidKey
|
تحذير |
لا يؤدي مفتاح واجهة برمجة التطبيقات المضمّن في عنصر النص البرمجي الذي يحمِّل واجهة برمجة التطبيقات إلى تبدو صحيحة. يُرجى التأكد من استخدام مفتاح واجهة برمجة تطبيقات صحيح. يمكنك إنشاء مفتاح واجهة برمجة تطبيقات جديد في Cloud Console. للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه.
|
InvalidVersion
|
تحذير |
ربما قدّمت رقم إصدار غير صحيح في عنصر النص البرمجي. يُرجى التأكد من استخدام رقم إصدار صحيح. عرض تحديد الإصدارات | واجهة برمجة تطبيقات JavaScript لـ "خرائط Google": |
KeyLooksLikeClientId
|
تحذير |
ربما قدّمت معرِّف عميل كمَعلمة key . إذا كنت
لديك خطة مميّزة أو
ترخيص Maps APIs for Work، يُرجى تحديد معرِّف العميل على أنه
مَعلمة client بدلاً من المَعلمة key إذا كان لديك
الخطة المميّزة في "منصة خرائط Google"، يمكنك استخدام مَعلمة client .
أو معلمة key . إذا لم يكن لديك أي تراخيص،
عليك استخدام مَعلمة key بدلاً من مَعلمة client
.
اطّلِع على دليل مصادقة "الخطة المميّزة" |
KeyLooksLikeCryptoKey
|
تحذير |
ربما قدّمت مفتاح تشفير أو سر توقيع كـ اطّلِع على دليل تحديد معرِّف عميل عند تحميل واجهة برمجة التطبيقات. |
KeyLooksLikeProjectNumber
|
تحذير |
من المحتمل أنّك قدّمت رقم مشروع كمَعلمة التعرّف على كيفية الحصول على مفتاح واجهة برمجة التطبيقات |
NoApiKeys
|
تحذير |
لا يحتوي عنصر النص البرمجي الذي يحمِّل واجهة برمجة التطبيقات على مفتاح واجهة برمجة تطبيقات. يُرجى الحرص على
يمكنك تضمين مفتاح واجهة برمجة تطبيقات صالح كمَعلمة
للحصول على مفتاح واجهة برمجة التطبيقات، انقر على الزر أدناه للبدء.
في حالة تحميل واجهة برمجة تطبيقات JavaScript للخرائط من الإصدار 2 الذي تم إيقافه
، فستحصل على تحذير |
RetiredVersion
|
تحذير |
ربما تكون قد قدّمت نسخة تمت إزالتها في عنصر النص البرمجي. يُرجى تحديث تطبيقك لاستخدام أحد الإصدارات المتاحة. عرض تحديد الإصدارات | واجهة برمجة تطبيقات JavaScript لـ "خرائط Google": |
SensorNotRequired
|
تحذير |
لم تعد المعلمة |
SignatureNotRequired
|
تحذير |
المعلمة |
SignedInNotSupported
|
تحذير |
تم إيقاف مَعلمة |
UrlAuthenticationCommonError
|
خطأ |
حدث خطأ لا يتناسب مع الفئات الأخرى في هذا . قد يرجع السبب في ذلك إلى مشكلة مؤقتة. يُرجى إعادة محاولة طلبك بعد مهلة قصيرة. إذا لم يؤدِّ ذلك إلى حلّ المشكلة، يُرجى مُراجعة دليل المطوِّر للتأكد من أن الطلب بالتنسيق الصحيح. |
التحقق من الأخطاء في متصفحك
تقوم واجهة برمجة تطبيقات JavaScript للخرائط بكتابة رسائل الخطأ إلى
window.console
يوضح هذا القسم كيفية التحقق من
الناتج window.console
في Google Chrome. إذا كنت تستخدم أداة أخرى
يُرجى مراجعة مستندات مطوّري البرامج الخاصة بمتصفحك. لـ
مرجع، هذه قائمة بأدوات للتحقق من ناتج window.console
في بعض المتصفحات الأخرى
- Web Console لبرنامج Firefox.
- تصحيح الأخطاء عن بُعد لنظام التشغيل Android
- Web Inspector (أداة فحص الويب) لنظام التشغيل iOS.
في Chrome، يمكنك استخدام
وحدة تحكّم JavaScript
للتحقق من الإخراج window.console
على النحو التالي.
- لفتح "أدوات المطوّرين"، انقر على رمز القائمة > المزيد من الأدوات > أدوات المطورين.
- لفتح وحدة تحكم 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 عن الأخطاء.
- نشر الأسئلة في الحزمة القائمة الكاملة. تتوفر إرشادات حول كيفية نشر أسئلة رائعة على صفحة الدعم.