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

تذكير: لاستخدام Maps JavaScript API:

• يجب أن تتضمّن جميع طلبات البيانات من واجهة برمجة التطبيقات Maps JavaScript API مفتاح واجهة برمجة التطبيقات، لأنّنا لم نعُد نتيح الوصول بدون مفتاح.
• يجب تفعيل الفوترة في كل مشروع من مشاريعك.

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

في ظروف معيّنة، قد يتم عرض خريطة معتمة أو صورة "سلبية" في "التجوّل الافتراضي"، تحمل علامة مائية تتضمّن النص "لأغراض التطوير فقط". يشير هذا السلوك عادةً إلى مشاكل في مفتاح واجهة برمجة التطبيقات أو الفوترة. لاستخدام منتجات "منصة خرائط 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 واختَر المشروع الذي تم إنشاء مفتاح واجهة برمجة التطبيقات ضمنه. للتأكّد من أنّ المفتاح مرتبط بالمشروع:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إذا لم يعمل الرمز:

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

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