قد تُصدر واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" رسالة خطأ أو تحذير عند حدوث خطأ. يشرح هذا الدليل كل رسالة خطأ، ويقدّم المزيد من التعليمات لحل الأخطاء.
الطلبات غير الصالحة
في حال تقديم طلب غير صالح، تعرض واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" رمز حالة HTTP 4xx ورسالة تصف المشكلة. في ما يلي أمثلة على شروط الخطأ هذه. ملاحظة: هذه ليست
قائمة كاملة بالأخطاء المحتملة. يُرجى التحقّق من رمز الخطأ والرسالة التي تعرضها واجهة برمجة التطبيقات للاطّلاع على تفاصيل حول مشاكل محدّدة.
| مثال على حالة الخطأ | رمز الحالة |
|---|---|
يتضمن الطلب معلمة غير صالحة أو معلمة مطلوبة
مفقودة. على سبيل المثال، لا تقع المَعلمة size ضمن
النطاق المتوقّع للقيم الرقمية أو غير متوفّرة في الطلب. |
400 BAD REQUEST |
| مفتاح واجهة برمجة التطبيقات المضمّن في الطلب غير صالح. | 403 FORBIDDEN |
الأخطاء التي تمنع عرض صورة "التجوّل الافتراضي"
إذا كان الطلب صالحًا ولكن حدث خطأ آخر يمنع عرض صورة "التجوّل الافتراضي"، تعرض واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" إما صورة نصية أو صورة خطأ بدلاً من صورة "التجوّل الافتراضي"، وذلك استنادًا إلى الخطأ. ومن الأمثلة على حالة الخطأ هذه عندما يتجاوز التطبيق حدود الاستخدام الخاصة به.
الأخطاء المتعلقة بمفاتيح واجهة برمجة التطبيقات والفوترة
في حال استخدام واجهة برمجة التطبيقات الثابتة لميزة "التجوّل الافتراضي" بدون مفتاح واجهة برمجة التطبيقات، أو في حال عدم تفعيل الفوترة في حسابك، ستعرض الصفحة صورة خطأ بدلاً من صورة "التجوّل الافتراضي"، مع رابط يشير إلى نوع الخطأ. على سبيل المثال "g.co/streetviewerror/key".
| الأخطاء والحلول بدون مفتاح | |
|---|---|
 |
استخدام واجهة برمجة التطبيقات الثابتة للتجوّل الافتراضي بدون مفتاح واجهة برمجة التطبيقات. لحلّ المشكلة، يجب إجراء ما يلي: |
 |
لا يتضمّن طلبك توقيعًا رقميًا (مطلوب). لحلّ المشكلة، يجب التوقيع على عنوان URL. |