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

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

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

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

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

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

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

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

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

لمطوّري الويب:

• إذا كان بإمكانك الوصول إلى رمز المصدر الخاص بتطبيقك، ابحث عن العلامة <script> المستخدَمة لتحميل Maps JavaScript API. عند تحميل واجهة برمجة تطبيقات JavaScript للخرائط، استبدِل 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. انتقِل إلى قسم Credentials (بيانات الاعتماد) الذي يمكن الوصول إليه من الشريط الجانبي الأيمن ضمن Google Maps Platform > بيانات الاعتماد.
2. تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات الذي تستخدمه حاليًا على موقعك الإلكتروني مُدرَج. إذا لم يكن الأمر كذلك، يمكنك التبديل إلى مشروع مختلف والتحقّق من بيانات الاعتماد هناك.
3. إذا تعذّر عليك العثور على مشروع مفتاح واجهة برمجة التطبيقات، قد يعني ذلك أنّك فقدت إمكانية الوصول إلى هذا المشروع. اطلب المساعدة من مستخدمين آخرين في مؤسستك. إذا تعذّر العثور على المشروع الأصلي، عليك إجراء ما يلي:
   1. أنشئ مشروعًا جديدًا. يمكن إجراء ذلك من خلال اختيار مشروع جديد من قائمة المشاريع، أو من خلال اختيار إنشاء مشروع من صفحة "مدير الموارد".
   2. أنشئ مفتاح واجهة برمجة تطبيقات جديدًا. ويمكن إجراء ذلك في صفحة بيانات الاعتماد. بعد ذلك، انقر على إنشاء بيانات اعتماد ثم اختَر مفتاح واجهة برمجة التطبيقات.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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