این صفحه پیامهای خطایی را که میتواند توسط Maps JavaScript API بازگردانده شود، توضیح میدهد. Maps JavaScript API پیامهای خطا و هشدار را در کنسول جاوا اسکریپت مینویسد. شرایط خطای خاصی نیز ممکن است رخ دهد که منجر به نمایش یک نقشه واترمارک تاریک می شود.
کلید API و خطاهای صورتحساب
عیب یابی
تحت شرایط خاص، ممکن است یک نقشه تاریک یا تصویر "منفی" نمای خیابان، با متن "فقط برای اهداف توسعه" نشان داده شود. این رفتار معمولاً مشکلات مربوط به کلید API یا صورتحساب را نشان میدهد. برای استفاده از محصولات Google Maps Platform، صورتحساب باید در حساب شما فعال باشد و همه درخواستها باید دارای یک کلید API معتبر باشند. برای راهنمایی در مورد یافتن پیام های خطا، به بخش بررسی خطاها در مرورگر خود مراجعه کنید.
جریان زیر به شما در رفع مشکل کمک می کند.
کدهای خطای Maps JavaScript API برای توسعه دهندگان و صاحبان سایت
جداول زیر کدهای خطای احتمالی بازگردانده شده توسط Maps JavaScript API را با توضیح علت و نحوه رفع مشکل فهرست می کنند. برای کمک در یافتن پیام های خطا، به بخش بررسی خطاها در مرورگر خود مراجعه کنید.
خطاهای بارگیری نقشه
اگر هنگام بارگیری Maps JavaScript API با خطایی مواجه شدید، لطفاً جدول زیر را ببینید تا توضیحات مربوط به کدهای خطا را بیابید.
کد خطا | پیام | توضیحات |
---|---|---|
NotLoadingAPIFromGoogleMapsError | Maps JavaScript API باید مستقیماً از سرورهای Google دانلود شود. | عنصر اسکریپت که Maps JavaScript API را بارگیری می کند به درستی در صفحه شما گنجانده نشده است. برای اینکه API به درستی کار کند، باید مستقیماً از https://maps.googleapis.com بارگیری شود. به بارگیری Maps JavaScript API مراجعه کنید. |
TOSViolationMapError | به نظر می رسد این وب سایت شرایط خدمات Google Maps API را نقض می کند. Google Maps API برای این وب سایت غیرفعال شده است. | برنامه شما به دلیل عدم مطابقت با شرایط خدمات پلتفرم Google Maps، به دنبال چندین اعلان ایمیل مسدود شد. برای درخواست تجدیدنظر در مورد بلوک و بررسی اجرای شما، لطفاً این فرم را تکمیل کنید. ظرف چند روز کاری پاسخی از طریق ایمیل دریافت خواهید کرد. اگر مجوز پلتفرم Google Maps Premium Plan دارید، لطفاً از اعتبارنامه Google Maps Platform Premium Plan خود برای رفع این خطا استفاده کنید. راهنمای احراز هویت طرح Premium را ببینید. |
UnauthorizedURLForClientIdMapError | این نشانی اینترنتی مجاز به استفاده از Google Maps Client ID ارائه شده نیست. | شناسه سرویس گیرنده Premium Plan یا Maps APIs for Work موجود در بارگیری اسکریپت نامعتبر است، منقضی شده است، یا آدرس فعلی در حال بارگیری Maps JavaScript API به لیست URL های مجاز اضافه نشده است. به ثبت نام URL های مجاز مراجعه کنید. |
کدهای خطای Maps JavaScript API
اگر خطایی در کنسول جاوا اسکریپت کروم ، کنسول وب فایرفاکس یا هر ابزار مشابه دیگری در مرورگرهای خود پیدا کردید، لطفاً جدول زیر را ببینید تا توضیحات مربوط به کدهای خطا را بیابید.
Maps JavaScript API هم خطاها و هم هشدارها را برمی گرداند. یک خطا نشان دهنده یک مشکل جدی است که هنگام بارگیری Maps JavaScript API رخ داده است. صفحه شما نمی تواند API را به درستی بارگیری کند و API در آن صفحه کار نخواهد کرد. یک هشدار یک پیام تکمیلی در مورد بارگیری Maps JavaScript API است. این اخطار دلایل احتمالی یک خطا را توضیح میدهد، یا مشکلات احتمالی را در کد شما پیشنهاد میکند که Maps JavaScript API را بارگیری میکند. اگر فقط اخطارها را بدون هیچ خطایی دریافت کنید، API به درستی در آن صفحه کار خواهد کرد. با این حال، توصیه می کنیم این مشکلات احتمالی را نیز برطرف کنید.
کد خطای برنامه نویس | تایپ کنید | توضیحات |
---|---|---|
ApiNotActivatedMapError | خطا | Maps JavaScript API در پروژه API شما فعال نیست. ممکن است لازم باشد Maps JavaScript API را در زیر APIها در Google Cloud Console فعال کنید. برای فعال کردن Maps JavaScript API برای پروژه خود، روی دکمه زیر کلیک کنید. |
ApiTargetBlockedMapError | خطا | این کلید API مجاز به استفاده از این سرویس یا API نیست. لطفاً تنظیمات محدودیتهای API کلید API خود را در Google Cloud Console بررسی کنید تا مطمئن شوید که همه APIها و سرویسهایی که باید استفاده کنید به درستی در فهرست APIهای فعال مشخص شدهاند. کلیدهای API را در Cloud Console ببینید. برای اطلاعات بیشتر، بهترین شیوه های امنیتی API را ببینید. |
DeletedApiProjectMapError | خطا | پروژه API شما ممکن است از کنسول Cloud حذف شده باشد. لطفاً پروژه ای را بررسی کنید که برای آن کلید API را که در بارکننده جاوا اسکریپت API موجود است، ایجاد کرده اید. می توانید یک پروژه API جدید ایجاد کنید و یک کلید جدید در Cloud Console دریافت کنید. برای ایجاد یک پروژه جدید و دریافت کلید API برای پروژه، روی دکمه زیر کلیک کنید. |
ClientBillingNotEnabledMapError | خطا | شما صورتحساب را در پروژه خود فعال نکرده اید. باید صورتحساب در پروژه Google Cloud مرتبط با این شناسه مشتری را در اینجا فعال کنید. |
BillingNotEnabledMapError | خطا | شما صورتحساب پروژه خود را فعال نکرده اید که باعث این خطا می شود. در اینجا باید صورتحساب در پروژه Google Cloud را فعال کنید. |
ExpiredKeyMapError | خطا | کلید API موجود در عنصر اسکریپت که API را بارگیری می کند منقضی شده است یا توسط سیستم شناسایی نمی شود. اگر بخواهید از کلید قبل از شناسایی توسط سیستم استفاده کنید، ممکن است پس از ایجاد یک کلید API جدید، این خطا را دریافت کنید. چند دقیقه صبر کنید و دوباره امتحان کنید، یا ممکن است لازم باشد یک کلید API جدید در Cloud Console ایجاد کنید. برای دریافت کلید API، روی دکمه زیر کلیک کنید. |
InvalidClientIdMapError | خطا | شناسه سرویس گیرنده موجود در عنصر اسکریپت که API را بارگیری می کند نامعتبر است یا منقضی شده است. لطفاً مطمئن شوید که از شناسه مشتری خود به درستی استفاده می کنید. شناسه مشتری باید با پیشوند "gme-" شروع شود. اگر حتی زمانی که از شناسه مشتری خود به درستی استفاده می کنید، این خطا را مشاهده می کنید، ممکن است شناسه مشتری منقضی شده باشد. لطفاً با مدیر حساب Google خود تماس بگیرید. اگر مجوز Premium Plan یا Maps APIs for Work ندارید، باید از یک پارامتر راهنمای احراز هویت طرح Premium را ببینید. |
InvalidKeyMapError | خطا | کلید API موجود در عنصر اسکریپت که API را بارگیری می کند، یافت نشد. لطفاً مطمئن شوید که از یک کلید API درست استفاده می کنید. می توانید یک کلید API جدید در Cloud Console ایجاد کنید. برای دریافت کلید API، روی دکمه زیر کلیک کنید. |
MalformedCredentialsMapError | خطا | برنامه شما از یک طرح URI پشتیبانی نشده استفاده می کند. بررسی کنید که برنامه از یک فرمت URI معتبر همانطور که در RFC 3986 تعریف شده است استفاده می کند. |
MissingKeyMapError | خطا | عنصر اسکریپت که API را بارگیری می کند، پارامتر احراز هویت لازم را ندارد. اگر از Maps JavaScript API استاندارد استفاده میکنید، باید از یک پارامتر اگر مشتری Premium Plan هستید، باید از یک پارامتر اگر شما مالک وب سایت نیستید، هیچ اقدامی برای رفع این خطا وجود ندارد. با این حال، ممکن است بخواهید در صورت امکان به مالک سایت اطلاع دهید. |
ProjectDeniedMapError | خطا | درخواست شما تکمیل نشده است. ممکن است بتوانید جزئیات بیشتری درباره این خطا در کنسول Cloud پیدا کنید. به Cloud Console مراجعه کنید. |
RefererDeniedMapError | خطا | برنامه شما به دلیل عدم مطابقت با شرایط خدمات پلتفرم Google Maps، به دنبال چندین اعلان ایمیل مسدود شد. برای درخواست تجدیدنظر در مورد بلوک و بررسی اجرای شما، لطفاً این فرم را تکمیل کنید. ظرف چند روز کاری پاسخی از طریق ایمیل دریافت خواهید کرد. |
RefererNotAllowedMapError | خطا | URL فعلی در حال بارگیری Maps JavaScript API به لیست ارجاع دهندگان مجاز اضافه نشده است. لطفاً تنظیمات ارجاع دهنده کلید API خود را در Cloud Console بررسی کنید. Maps JavaScript API را ببینید و یک کلید API دریافت کنید . |
OverQuotaMapError | خطا | تعداد درخواستها از محدودیتهای استفاده برای Maps JavaScript API فراتر رفته است. درخواستهای برنامه شما در بازنشانی سهمیه روزانه بعدی دوباره کار خواهند کرد. اگر شما مالک وب سایت نیستید، هیچ اقدامی برای رفع این خطا وجود ندارد. با این حال، ممکن است بخواهید در صورت امکان به مالک سایت اطلاع دهید. برای جزئیات بیشتر، راهنمای محدودیتهای استفاده را ببینید. این صفحه همچنین توضیح می دهد که چگونه می توانید محدودیت های استفاده بالاتری دریافت کنید. |
ApiProjectMapError | خطا | کلید API ارائه شده یا پروژه API که با آن مرتبط است قابل حل نیست. این خطا ممکن است موقتی باشد. اگر این پیام خطا ادامه داشت، ممکن است لازم باشد یک کلید API جدید دریافت کنید یا یک پروژه API جدید ایجاد کنید. برای اطلاعات بیشتر، شروع به کار با Google Maps Platform را ببینید. |
ClientIdLooksLikeCryptoKey | هشدار | ممکن است یک کلید رمزنگاری در پارامتر راهنمای شناسههای مشتری برای مشتریان طرح Premium و Maps APIs for Work را ببینید. |
ClientIdLooksLikeKey | هشدار | ممکن است یک کلید API در پارامتر راهنمای احراز هویت طرح Premium را ببینید. |
InvalidChannel | هشدار | ممکن است یک پارامتر مشاهده گزارش | طرح ممتاز پلتفرم Google Maps . |
InvalidClientId | هشدار | به نظر نمی رسد پارامتر راهنمای احراز هویت طرح Premium را ببینید. |
InvalidKey | هشدار | کلید API موجود در عنصر اسکریپت که API را بارگیری می کند صحیح به نظر نمی رسد. لطفاً مطمئن شوید که از یک کلید API درست استفاده می کنید. می توانید یک کلید API جدید در Cloud Console ایجاد کنید. برای دریافت کلید API، روی دکمه زیر کلیک کنید. |
InvalidVersion | هشدار | ممکن است شماره نسخه نادرستی را در عنصر اسکریپت خود وارد کرده باشید. لطفاً مطمئن شوید که از شماره نسخه صحیح استفاده می کنید. مشاهده نسخه | Google Maps JavaScript API . |
KeyLooksLikeClientId | هشدار | ممکن است شناسه مشتری را به عنوان پارامتر key ارائه کرده باشید. اگر مجوز Premium Plan یا Maps APIs for Work دارید، لطفاً به جای پارامتر key ، شناسه مشتری خود را به عنوان پارامتر client مشخص کنید. اگر طرح ممتاز پلتفرم Google Maps دارید، میتوانید از یک پارامتر client یا یک پارامتر key استفاده کنید. اگر هیچ مجوزی ندارید، باید به جای پارامتر client از یک پارامتر key استفاده کنید.راهنمای احراز هویت طرح Premium را ببینید. |
KeyLooksLikeCryptoKey | هشدار | ممکن است یک کلید رمزنگاری یا رمز امضا را به عنوان پارامتر به راهنمای تعیین شناسه مشتری هنگام بارگیری API مراجعه کنید. |
KeyLooksLikeProjectNumber | هشدار | ممکن است شماره پروژه را به عنوان پارامتر |
NoApiKeys | هشدار | عنصر اسکریپت که API را بارگیری می کند کلید API ندارد. لطفاً مطمئن شوید که یک کلید API معتبر به عنوان پارامتر برای دریافت کلید API، برای شروع روی دکمه زیر کلیک کنید. اگر Maps JavaScript API را از مسیر منسوخ v2 بارگیری میکنید، حتی اگر پارامتر |
RetiredVersion | هشدار | ممکن است یک نسخه بازنشسته را در عنصر اسکریپت خود ارائه کرده باشید. لطفاً برنامه خود را برای استفاده از یکی از نسخه های موجود به روز کنید. مشاهده نسخه | Google Maps JavaScript API . |
SensorNotRequired | هشدار | پارامتر |
SignatureNotRequired | هشدار | پارامتر |
SignedInNotSupported | هشدار | پارامتر |
UrlAuthenticationCommonError | خطا | خطایی روی داده است که در دستههای دیگر این صفحه قرار نمیگیرد. این می تواند ناشی از یک مشکل موقت باشد. لطفاً پس از یک تاخیر کوتاه دوباره درخواست را امتحان کنید. اگر با این کار مشکل حل نشد، لطفاً راهنمای توسعه دهنده را مرور کنید تا مطمئن شوید که فرمت درخواستی مناسب است. |
بررسی خطاها در مرورگر شما
Maps JavaScript API پیام های خطا را در window.console
می نویسد. این بخش توضیح می دهد که چگونه می توانید خروجی window.console
را در Google Chrome بررسی کنید. اگر از مرورگر دیگری استفاده میکنید، لطفاً اسناد توسعهدهنده مرورگر خود را بررسی کنید. برای مرجع شما، این فهرستی از ابزارها برای بررسی خروجی window.console
در برخی مرورگرهای دیگر است.
- کنسول وب برای فایرفاکس.
- اشکال زدایی از راه دور برای اندروید.
- بازرس وب برای iOS.
در کروم، میتوانید از کنسول جاوا اسکریپت برای بررسی خروجی window.console
به شرح زیر استفاده کنید.
- برای باز کردن Developer Tools، نماد منو > More Tools > Developer Tools را انتخاب کنید.
- برای باز کردن کنسول جاوا اسکریپت، کلید ESC را روی صفحه کلید خود فشار دهید. کلید ESC کنسول جاوا اسکریپت را تغییر می دهد. اگر کنسول را ببندید، دوباره کلید ESC را فشار دهید تا باز شود.
اگر هنگام بارگیری Maps JavaScript API خطا یا هشداری رخ دهد، به صورت یک یا چند خط در کنسول ظاهر میشود. یک پیام خطا یا هشدار دارای قالب زیر است:
Google Maps API error: [ERROR CODE] [Link to API document]
یا
Google Maps API warning: [ERROR CODE] [Link to API document]
می توانید جدول کدهای خطا را در بالا بررسی کنید تا کد خطا را در پیام خطا پیدا کنید. همچنین می توانید جزئیات مربوط به پیام خطا را در سند API پیوند داده شده از پیام بیابید.
توجه: می توانید خطاهای احراز هویت را به صورت برنامه ای گوش دهید .
مدیریت مرورگرهای پشتیبانی نشده
مطمئن شوید که نسخه مرورگری که استفاده میکنید در حال حاضر توسط Maps JavaScript API پشتیبانی میشود.
اگر در حال توسعه یک برنامه بومی ویندوز هستید که در WebView اجرا می شود، مطمئن شوید که از WebView2 مبتنی بر Edge استفاده می کنید. نسخههای قبلی WebView، مبتنی بر اینترنت اکسپلورر، دیگر پشتیبانی نمیشوند.
اگر کد شما هنوز کار نمی کند
برندان کنی و مانو مارکس برای کمک به شما در راهاندازی کد نقشههای خود، در این ویدیو به برخی از اشتباهات رایج و نحوه رفع آنها اشاره میکنند.
- به دنبال اشتباهات تایپی باشید به یاد داشته باشید که جاوا اسکریپت یک زبان حساس به حروف بزرگ و کوچک است.
- اصول اولیه را بررسی کنید - برخی از رایج ترین مشکلات با ایجاد نقشه اولیه رخ می دهد. مانند:
- تأیید کنید که ویژگی های
zoom
وcenter
را در گزینه های نقشه خود مشخص کرده اید. - اطمینان حاصل کنید که یک عنصر div را اعلام کرده اید که در آن نقشه روی صفحه ظاهر می شود.
- اطمینان حاصل کنید که عنصر div برای نقشه دارای ارتفاع است. به طور پیش فرض، عناصر div با ارتفاع 0 ایجاد می شوند و بنابراین نامرئی هستند.
- تأیید کنید که ویژگی های
- از یک اشکالزدای جاوا اسکریپت برای کمک به شناسایی مشکلات استفاده کنید، مانند آنچه در ابزارهای برنامهنویس Chrome موجود است. با جستجوی خطا در کنسول جاوا اسکریپت شروع کنید.
- سوالات را به Stack Overflow ارسال کنید. دستورالعملهایی درباره نحوه ارسال سؤالات عالی در صفحه پشتیبانی موجود است.