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