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