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