این صفحه پیام‌های خطایی را که ممکن است توسط Maps Embed API برگردانده شود شرح می‌دهد. وقتی خطایی رخ می‌دهد، Maps Embed API نوشتار پیام خطا را به‌جای نقشه نشان می‌دهد. ممکن است شرایط خطای خاصی نیز رخ دهد که منجر به نمایش نقشه تیره با ته‌نقش شود.
درخواست‌های نامعتبر
درصورت نامعتبر بودن درخواست، Maps Embed API
رمز وضعیت اچ‌تی‌تی‌پی 4xx و پیامی را که مشکل را شرح می‌دهد
برمی‌گرداند. در زیر نمونه‌هایی از شرایط خطا آورده شده است. توجه: این فهرست کامل خطاهای احتمالی نیست. برای جزئیات مشکلات خاص، کد خطا و پیام واقعی برگردانده‌شده توسط میانای برنامه‌سازی کاربردی را بررسی کنید.
| نمونه‌ای از شرایط خطا | رمز وضعیت |
|---|---|
درخواست حاوی پارامتر نامعتبر است یا پارامتر الزامی وجود ندارد. برای مثال، پارامتر zoom در محدوده موردانتظار مقادیر عددی نیست، یا پارامتر الزامی در درخواست وجود ندارد. |
400 BAD REQUEST |
| کلید میانای API موجود در درخواست نامعتبر است. | 403 FORBIDDEN |
خطاهای سهمیه و کلید میانای برنامه‌سازی کاربردی
خطاهای کلید میانای برنامه‌سازی کاربردی و سهمیه به‌عنوان درخواست‌های نامعتبر درنظر گرفته می‌شوند. علل احتمالی شامل موارد زیر است:
- کلید میانای برنامه‌سازی کاربردی وجود ندارد یا نامعتبر است. برای رفع این خطا، مطمئن شوید که درخواستتان حاوی کلید میانای برنامه‌سازی کاربردی معتبر باشد. کلید میانای API دریافت کنید.
- Maps Embed API برای پروژه شما فعال نیست. درباره فعال و غیرفعال کردن میاناهای برنامه‌سازی کاربردی بیشتر بدانید.
- کلید میانای API نقض محدودیت دارد. درباره روال‌های مطلوب کلید میانای برنامه‌سازی کاربردی بیشتر بخوانید.
خطاهای صورت‌حساب و ارجاع‌دهنده HTTP
اگر هرکدام از موارد زیر درست باشد، نقشه تاریک یا تصویر «منفی» از «نمای خیابان» با ته‌نقش «فقط برای اهداف توسعه» برگردانده می‌شود:
- صدور صورت‌حساب در حسابتان فعال نشده است. فعال کردن صورت‌حساب.
- روش صورت‌حساب ارائه‌شده نامعتبر است (برای مثال، کارت اعتباری منقضی‌شده). برای حل این مشکل، به کنسول Google Cloud بروید و مطمئن شوید که روش پرداخت معتبری ارائه کرده‌اید.
- از حد روزانه خودتحمیلی فراتر رفته‌اید. با نحوه مشاهده یا تغییر حدود قابل‌صورت‌حساب روزانه آشنا شوید.
- درخواست فاقد ارجاع‌دهنده HTTP است و شما از کلید میانای برنامه‌سازی کاربردی محدودشده با ارجاع‌دهنده استفاده می‌کنید. درباره افزودن ارجاع‌دهنده بیشتر بدانید.
بررسی خطاها در مرورگر
برای خطاهای ارجاع‌دهنده HTTP و صورت‌حساب، Maps Embed API پیام‌های خطا را در window.console می‌نویسد. برای درخواست‌های نامعتبر (ازجمله
خطاهای کلید میانای برنامه‌سازی کاربردی و سهمیه)، فقط رمز وضعیت HTTP 4xx
در کنسول گزارش می‌شود این بخش توضیح می‌دهد که چگونه می‌توانید خروجی کنسول را در Google Chrome بررسی کنید. اگر از مرورگر دیگری استفاده می‌کنید، لطفاً مستندات توسعه‌دهنده
مرورگرتان را بررسی کنید. برای مرجع شما، این فهرستی از ابزارها برای
بررسی خروجی کنسول در برخی مرورگرهای دیگر است.
- کنسول برای Internet Explorer.
- کنسول وب برای Firefox.
- اشکال‌زدایی از راه دور برای Android.
- Web Inspector برای iOS.
در Chrome، می‌توانید از کنسول جاوا اسکریپت برای بررسی برونداد کنسول به‌صورت زیر استفاده کنید.
- برای باز کردن «ابزارهای توسعه‌دهنده»، نماد منو > ابزارهای بیشتر > ابزارهای توسعه‌دهنده را انتخاب کنید.
- برای باز کردن «کنسول جاوا اسکریپت»، روی برگه کنسول در بالای پنجره «ابزارهای توسعه‌دهندگان» کلیک کنید. همچنین می‌توانید از کلید ESC برای روشن/خاموش کردن «کنسول جاوا اسکریپت» استفاده کنید.