وقتی درخواستی ناموفق باشد، Street View Static API خطا یا هشدار برمی‌گرداند. این راهنما پیام‌های خطا را توضیح می‌دهد و دستورالعمل‌هایی برای حل آن‌ها ارائه می‌دهد.
درخواست‌های نامعتبر
برای درخواست نامعتبر، Street View Static API رمز وضعیت HTTP 4xx
و پیامی را که مشکل را شرح می‌دهد برمی‌گرداند. جدول زیر نمونه‌هایی از این شرایط خطا را فهرست می‌کند، هرچند این فهرست کاملی از خطاهای احتمالی نیست. می‌توانید
کد خطا و پیام واقعی برگردانده‌شده توسط میانای برنامه‌سازی کاربردی را برای جزئیات
مشکلات خاص بررسی کنید.
| نمونه‌ای از شرایط خطا | رمز وضعیت |
|---|---|
درخواست حاوی پارامتر نامعتبر است یا پارامتر الزامی وجود ندارد. برای مثال، پارامتر size در محدوده موردانتظار مقادیر عددی نیست یا در درخواست وجود ندارد. |
400 BAD REQUEST |
| کلید میانای API موجود در درخواست نامعتبر است. | 403 FORBIDDEN |
خطاهایی که مانع نمایش تصویر نمای خیابان می‌شود
اگر درخواست معتبر باشد، اما خطای دیگری رخ دهد که مانع از نمایش تصویر نمای خیابان شود، Street View Static API بسته به خطا، به‌جای تصویر نمای خیابان، متن یا تصویر خطا را برمی‌گرداند. نمونه‌ای از چنین شرایط خطایی زمانی است که برنامه از حدود استفاده خود فراتر می‌رود.
خطاهای مربوط به کلیدهای میانای برنامه‌سازی کاربردی و صورت‌حساب
اگر از Street View Static API بدون کلید میانای برنامه‌سازی کاربردی استفاده کنید، یا اگر صورت‌حساب در حسابتان فعال نشده باشد، صفحه به‌جای تصویر نمای خیابان، تصویر خطایی را با پیوندی که نوع خطا را نشان می‌دهد نمایش می‌دهد. برای مثال، «g.co/streetviewerror/key».
| خطاها و راه‌حل‌های بدون کلید | |
|---|---|
 |
درحال استفاده از Street View Static API بدون کلید میانای برنامه‌سازی کاربردی هستید. برای رفع این خطا، مراحل زیر را تکمیل کنید: |
 |
درخواست شما فاقد امضای دیجیتال الزامی است. برای رفع این خطا، نشانی وب خود را امضا کنید. |