پیغام خطا

این صفحه پیام های خطایی را که می تواند توسط Maps Embed API بازگردانده شود، توضیح می دهد. هنگامی که خطایی رخ می دهد، Maps Embed API متن پیام خطا را به جای نقشه ارائه می دهد. شرایط خطای خاصی نیز ممکن است رخ دهد که منجر به نمایش یک نقشه واترمارک تاریک می شود.

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

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

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

خطاهای کلید API و QPS

خطاهای کلید API و QPS به عنوان درخواست های نامعتبر تلقی می شوند. علل احتمالی شامل موارد زیر است:

صورتحساب و خطاهای ارجاع HTTP

یک نقشه تاریک یا تصویر «منفی» نمای خیابان، که با  «فقط برای اهداف توسعه» واترمارک شده است، در صورت صحت هر یک از موارد زیر برگردانده می‌شود:

بررسی خطاها در مرورگر شما

برای خطاهای ارجاع‌دهنده صورت‌حساب و HTTP، Maps Embed API پیام‌های خطا را در window.console می‌نویسد. برای درخواست‌های نامعتبر (از جمله کلید API و خطاهای QPS)، فقط کد وضعیت HTTP 4xx در کنسول گزارش می‌شود. این بخش توضیح می دهد که چگونه می توانید خروجی کنسول در Google Chrome را بررسی کنید. اگر از مرورگر دیگری استفاده می‌کنید، لطفاً اسناد توسعه‌دهنده مرورگر خود را بررسی کنید. برای مرجع شما، این فهرستی از ابزارها برای بررسی خروجی کنسول در برخی از مرورگرهای دیگر است.

در کروم، می‌توانید از کنسول جاوا اسکریپت برای بررسی خروجی کنسول به شرح زیر استفاده کنید.

  1. برای باز کردن ابزارهای برنامه‌نویس، نماد منو > ابزارهای بیشتر > ابزارهای برنامه‌نویس را انتخاب کنید.
  2. برای باز کردن کنسول جاوا اسکریپت، روی تب Console در بالای پنجره Developer Tools کلیک کنید. همچنین می توانید از کلید ESC برای جابجایی کنسول جاوا اسکریپت استفاده کنید.