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