پیام‌های خطا در API استاتیک نمای خیابان

Street View Static API ممکن است در صورت بروز مشکل، خطا یا اخطاری صادر کند. این راهنما هر پیام خطا را توضیح می‌دهد و دستورالعمل‌های بیشتری برای رفع خطاها ارائه می‌دهد.

درخواست های نامعتبر

در صورت درخواست نامعتبر، API استاتیک نمای خیابان یک کد وضعیت HTTP 4xx و پیامی که مشکل را توصیف می‌کند، برمی‌گرداند. در زیر نمونه هایی از چنین شرایط خطا آورده شده است. توجه: این لیست کاملی از خطاهای احتمالی نیست. لطفاً کد خطای واقعی و پیام بازگردانده شده توسط API را برای جزئیات مشکلات خاص بررسی کنید.

مثال شرط خطا کد وضعیت
درخواست شامل یک پارامتر نامعتبر است یا یک پارامتر مورد نیاز وجود ندارد. به عنوان مثال، پارامتر size در محدوده مورد انتظار مقادیر عددی نیست یا در درخواست وجود ندارد. 400 BAD REQUEST
کلید API موجود در درخواست نامعتبر است. 403 FORBIDDEN

خطاهایی که مانع از نمایش تصویر نمای خیابان می شود

اگر درخواست معتبر است، اما خطای دیگری رخ می دهد که از نمایش تصویر نمای خیابان جلوگیری می کند، API استاتیک نمای خیابان بسته به خطا، متن یا تصویر خطا را به جای تصویر نمای خیابان برمی گرداند. یک مثال از چنین شرایط خطا زمانی است که برنامه از محدودیت های استفاده خود فراتر رود.

تصویر خطا به جای نقشه نمایش داده می شود
شکل: یک تصویر خطا به جای تصویر نمای خیابان نمایش داده می شود

اگر از Street View Static API بدون کلید API استفاده می‌کنید، یا اگر صورت‌حساب در حساب شما فعال نباشد، صفحه به جای تصویر نمای خیابان، یک تصویر خطا را با پیوندی نشان‌دهنده نوع خطا نشان می‌دهد. به عنوان مثال "g.co/streetviewerror/key".

خطاها و راه حل های بدون کلید
خطای محدودیت‌های استفاده: بیش از حد مجاز بارگیری نقشه روزانه ارائه شده است شما در حال استفاده از Street View Static API بدون کلید API هستید. برای حل، شما باید:
  1. یک کلید API دریافت کنید
  2. فعال کردن صورتحساب
  3. URL خود را امضا کنید
خطای محدودیت استفاده: نشانی‌های اینترنتی درخواست دارای امضای دیجیتالی نیستند درخواست شما فاقد امضای دیجیتال است (الزامی). برای حل، URL خود را امضا کنید