رسائل الخطأ في واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي"

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

الطلبات غير الصالحة

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

مثال على حالة الخطأ رمز الحالة
يتضمّن الطلب معلَمة غير صالحة، أو معلَمة مطلوبة مفقودة. على سبيل المثال، لا تقع المعلَمة size ضمن النطاق المتوقّع للقيم الرقمية أو غير متوفّرة في الطلب. 400 BAD REQUEST
مفتاح واجهة برمجة التطبيقات المضمّن في الطلب غير صالح. 403 FORBIDDEN

الأخطاء التي تمنع عرض صورة التجوّل الافتراضي

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

تم عرض صورة خطأ بدلاً من خريطة
الشكل: صورة خطأ يتم عرضها بدلاً من صورة "التجوّل الافتراضي"

إذا كنت تستخدم واجهة برمجة التطبيقات الثابتة في ميزة "التجوّل الافتراضي" بدون مفتاح واجهة برمجة التطبيقات، أو إذا لم يتم تفعيل الفوترة في حسابك، ستعرض الصفحة صورة خطأ بدلاً من صورة التجوّل الافتراضي، مع رابط يوضح نوع الخطأ. على سبيل المثال "g.co/streetviewerror/key".

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