وقتی درخواستی ناموفق باشد، Maps Static API خطا یا هشداری صادر می‌کند. این راهنما پیام‌های خطا را توضیح می‌دهد و دستورالعمل‌هایی برای حل‌وفصل کردن آن‌ها ارائه می‌دهد.
درخواست‌های نامعتبر
برای درخواست نامعتبر، Maps Static API
کد وضعیت HTTP 4xx و پیامی که مشکل را
توضیح می‌دهد برمی‌گرداند، همان‌طور که در فهرست زیر نشان داده شده است. برای جزئیات مشکلات خاص، کد خطای واقعی و پیام برگشتی ازسوی API را بررسی کنید.
- درخواست شامل پارامتر نامعتبر است یا پارامتر الزامی وجود ندارد. برای مثال، پارامتر
sizeدر محدوده موردانتظار مقادیر عددی نیست یا در درخواست وجود ندارد. 400 BAD REQUEST- کلید API موجود در درخواست نامعتبر است.
403 FORBIDDEN
خطاهایی که مانع نمایش نقشه می‌شوند
اگر درخواست معتبر باشد، اما خطای دیگری رخ دهد که مانع نمایش نقشه شود، Maps Static API به‌جای نقشه، یا نوشتار یا تصویر خطا برمی‌گرداند. برای مثال، زمانی که برنامه از حدود استفاده خود فراتر می‌رود، خطایی رخ می‌دهد.
خطاهای مربوط به کلیدهای میانای برنامه‌سازی کاربردی و صورت‌حساب
اگر از «میانای برنامه‌سازی کاربردی Maps Static» بدون کلید API استفاده کنید، یا اگر صورت‌حساب در حسابتان فعال نباشد، صفحه به‌جای نقشه، تصویر خطا را با پیوندی که نوع خطا را نشان می‌دهد نمایش می‌دهد. برای مثال، «g.co/staticmaperror/key».
| خطاها و راه‌حل‌های بدون کلید | |
|---|---|
 |
از Maps Static API بدون کلید میانای برنامه‌سازی کاربردی استفاده می‌کنید. برای رفع این خطا، مراحل زیر را تکمیل کنید: |
 |
درخواست شما فاقد امضای دیجیتال الزامی است. برای رفع این خطا، نشانی وب خود را امضا کنید. |
هشدارها
برای برخی‌از شرایط خطا، «میانای برنامه‌سازی کاربردی» نقشه برمی‌گرداند، اما ممکن است برخی‌از اطلاعات در نقشه وجود نداشته باشد. وقتی این اتفاق می‌افتد، می‌توانید هشدار را بااستفاده از شرایط زیر شناسایی کنید:
- نقشه با نوار خطای زردی که روی نقشه قرار گرفته است و متن «خطای نقشه: g.co/staticmaperror» نشان داده می‌شود.
- این API هشداری را در قالب سرصفحه HTTP با نام
X-Staticmap-API-Warningبرمی‌گرداند.
برای مثال، نشانی وب زیر حاوی مقدار غیرمنتظره‌ای در پارامتر
markers است:
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY
API نقشه را برمی‌گرداند، اما نوار خطای زردی را با نوشتار «خطای نقشه: g.co/staticmaperror» روی تصویر نمایش می‌دهد:
این API سرایند HTTP زیر را نیز برمی‌گرداند:
X-Staticmap-API-Warning:Error geocoding: marker 1
جدول زیر هشدارهایی را که API می‌تواند به‌عنوان سرایندهای HTTP صادر کند شرح می‌دهد:
هشدارهایی در X-Staticmap-API-Warning سرصفحه
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
هنگام تلاش برای زمین‌کد کردن درخواست، خطایی رخ داد. بسته به عنصری که در آن زمین‌کدیابی
ناموفق بوده است، مثل center، marker،
visible، یا path، و تعداد
عناصری که ناموفق بوده‌اند، گونه‌های مختلفی از این پیام وجود دارد. یک نمونه از این هشدار
X-Staticmap-API-Warning:Error geocoding: marker 1 است، همان‌طور که در مثال قبلی نشان داده شد. |
Too many geocoded markers requested (max is 15). |
درخواست بیش‌از حداکثر تعداد مجاز نشانگر با نشانی انسان‌خوان را مشخص می‌کند. حداکثر ۱۵ است. این حد فقط برای نشانگرهایی اعمال می‌شود که به‌عنوان نشانی انسان‌خوان مشخص شده‌اند و نیاز به زمین‌کدیابی دارند. این موضوع برای نشانگرهایی که با مختصات عرض و طول جغرافیایی مشخص شده‌اند صدق نمی‌کند. |
Too many geocoded polyline vertices requested (max is 15). |
درخواست بیش‌از حداکثر تعداد مجاز چندخطی با نشانی انسان‌خوان را مشخص می‌کند. حداکثر ۱۵ است. این حد فقط برای چندخطی‌هایی اعمال می‌شود که رأس‌های آن‌ها به‌عنوان نشانی‌های انسان‌خوان مشخص شده‌اند و نیاز به زمین‌کدیابی دارند. این موضوع برای چندخطی‌هایی که با مختصات عرض جغرافیایی و طول جغرافیایی مشخص شده‌اند صدق نمی‌کند. |
می‌توانید هشدارهای سرایند HTTP را در کنسول Chrome DevTools، کنسول وب Firefox، یا ابزارهای معادل دیگر در مرورگرتان ببینید.