طراحی نقشه جدید به زودی به پلتفرم نقشه های گوگل ارائه می شود. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگ پیش‌فرض جدید و بهبودهایی در تجربیات نقشه و قابلیت استفاده است. همه سبک‌های نقشه به‌طور خودکار در مارس 2025 به‌روزرسانی می‌شوند. برای اطلاعات بیشتر در مورد در دسترس بودن و نحوه انتخاب زودتر، به سبک نقشه جدید برای پلتفرم Google Maps مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

پیغام خطا

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

کلید API و خطاهای صورت‌حساب

عیب یابی

تحت شرایط خاص، ممکن است یک نقشه تاریک یا تصویر "منفی" نمای خیابان، با متن "فقط برای اهداف توسعه" نشان داده شود. این رفتار معمولاً مشکلات مربوط به کلید API یا صورت‌حساب را نشان می‌دهد. برای استفاده از محصولات Google Maps Platform، صورت‌حساب باید در حساب شما فعال باشد و همه درخواست‌ها باید دارای یک کلید API معتبر باشند. برای راهنمایی در مورد یافتن پیام های خطا، به بخش بررسی خطاها در مرورگر خود مراجعه کنید.

جریان زیر به شما در رفع مشکل کمک می کند.

آیا از کلید API استفاده می کنید؟

مطمئن نیستم. چگونه می توانم بررسی کنم که آیا از کلید API استفاده می کنم؟

یک کلید API به عنوان پارامتر key در URL که برای بارگیری Maps JavaScript API استفاده می‌شود، ارسال می‌شود. در اینجا چند گزینه برای بررسی اینکه آیا از کلید API استفاده می کنید وجود دارد:

از افزونه Google Maps Platform API Checker Chrome استفاده کنید. این به شما امکان می دهد تعیین کنید که آیا وب سایت شما به درستی API های دارای مجوز Google Maps را پیاده سازی می کند یا خیر.
اگر از کتابخانه یا افزونه ای برای بارگیری Maps JavaScript API استفاده می کنید، تنظیمات مربوط به آن کتابخانه را بررسی کنید و به دنبال گزینه کلید API بگردید.
خطاهای مرورگر خود را بررسی کنید. اگر پیام های زیر را مشاهده کردید، از کلید API خود به درستی استفاده نمی کنید:

هشدار API جاوا اسکریپت Google Maps: NoApiKeys
خطای Google Maps JavaScript API: MissingKeyMapError

برای توسعه دهندگان وب:

اگر به کد منبع برنامه خود دسترسی دارید، به دنبال تگ <script> باشید که برای بارگیری Maps JavaScript API استفاده می شود. هنگام بارگیری Maps JavaScript API، YOUR_API_KEY در کد زیر را با کلید API خود جایگزین کنید.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
ترافیک شبکه ایجاد شده توسط وب سایت خود را در مرورگر بررسی کنید. در کروم، این مورد را می توان با استفاده از تب DevTools Network مشاهده کرد. در اینجا درخواست های شبکه ای را که توسط وب سایت خود ارائه شده است مشاهده خواهید کرد. درخواست‌های ارسال شده با استفاده از Maps JavaScript API در مسیر maps/api/js قرار خواهند گرفت. در اینجا می توانید تأیید کنید که آیا درخواست ها از پارامتر key استفاده می کنند. فیلتر کردن ترافیک شبکه بر اساس maps/api/js هنگام مشاهده برگه Network ممکن است مفید باشد.

نه، من از کلید API استفاده نمی کنم.

برای دریافت کلید API، روی دکمه زیر کلیک کنید. اگر راه‌اندازی هدایت‌شده را نمی‌بینید، دستورالعمل‌های کامل را در «شروع با پلتفرم Google Maps» دنبال کنید.
شروع کنید

بله، من از یک کلید API استفاده می کنم.

عالی! بیایید ادامه دهیم و بررسی کنیم که آیا یک حساب صورتحساب به پروژه شما متصل است یا خیر.

آیا یک حساب صورتحساب به پروژه شما پیوست شده است؟

مطمئن نیستم. چگونه می توانم بررسی کنم که آیا حساب صورتحساب به پروژه من پیوست شده است؟

به صفحه صورتحساب در Google Cloud Console بروید و پروژه ای را انتخاب کنید که کلید API شما تحت آن ایجاد شده است. برای تأیید اینکه کلید با پروژه مرتبط است:

به بخش Credentials بروید، که از نوار سمت چپ زیر Google Maps Platform > Credentials قابل دسترسی است.
بررسی کنید که کلید API که در حال حاضر در وب‌سایت خود استفاده می‌کنید فهرست شده باشد. اگر اینطور نیست، به پروژه دیگری بروید و اعتبار را در آنجا بررسی کنید.
اگر نمی توانید پروژه را برای کلید API خود پیدا کنید، ممکن است دسترسی به این پروژه را از دست داده باشید. از دیگران در سازمان خود کمک بخواهید. اگر پروژه اصلی نمی تواند مکان یابی شود، باید:
1. یک پروژه جدید ایجاد کنید. این کار را می توان با انتخاب پروژه جدید از لیست پروژه ها یا با انتخاب ایجاد پروژه از طریق صفحه مدیریت منابع انجام داد.
2. یک کلید API جدید ایجاد کنید. این کار را می توان در صفحه اعتبارنامه انجام داد. پس از آن روی Create credentials کلیک کنید و سپس کلید API را انتخاب کنید.

هنگامی که پروژه خود را در Cloud Console پیدا کردید، با رفتن به بخش صورتحساب در منوی سمت چپ، بررسی کنید که آیا یک حساب صورت‌حساب ضمیمه شده است.

خیر، حساب صورتحساب به پروژه من پیوست نشده است.

به صفحه فعال کردن صورتحساب در Cloud Console بروید و یک حساب صورتحساب به پروژه خود اضافه کنید. برای اطلاعات بیشتر، شروع به کار با Google Maps Platform را ببینید.

بله، یک حساب صورتحساب به پروژه من پیوست شده است.

عالی! بیایید مطمئن شویم روش صورتحساب ارائه شده معتبر است.

آیا روش صورتحساب ارائه شده دیگر معتبر نیست (مثلاً کارت اعتباری منقضی شده)؟

می‌توانید یک روش پرداخت را در Cloud Console اضافه، حذف یا به‌روزرسانی کنید .

آیا بیش از حد مجاز روزانه در API وجود دارد؟

اگر محدودیت روزانه برای هر یک از API های خود تعیین کرده اید، که برای جلوگیری از افزایش غیرمنتظره معمول است، می توانید با افزایش محدودیت روزانه خود، این مشکل را حل کنید.

می توانید محدودیت های روزانه خود را با رفتن به داشبورد APIs & Services در Cloud Console بررسی کنید. یک بار آنجا:

در صورت درخواست، پروژه ای را انتخاب کنید.
یک API را از لیست انتخاب کنید، سپس روی برگه Quotas کلیک کنید.

آیا کلید API شما دارای محدودیت آدرس IP است؟

کلیدهای API با محدودیت آدرس‌های IP را فقط می‌توان با سرویس‌های وب استفاده کرد که برای استفاده از سمت سرور در نظر گرفته شده‌اند (مانند API Geocoding و سایر APIهای وب سرویس ). اکثر این سرویس‌های وب دارای سرویس‌های معادل در Maps JavaScript API هستند (به عنوان مثال، سرویس کدگذاری جغرافیایی را ببینید). برای استفاده از خدمات سمت سرویس گیرنده Maps JavaScript API، باید یک کلید API جداگانه ایجاد کنید که می تواند با محدودیت ارجاع دهنده HTTP ایمن شود (به دریافت، افزودن و محدود کردن یک کلید 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 های مجاز مراجعه کنید.

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 ندارید، باید از یک پارامتر `key` با کلید API خود به جای پارامتر `client` استفاده کنید. راهنمای احراز هویت طرح Premium را ببینید.
`InvalidKeyMapError`	خطا	کلید API موجود در عنصر اسکریپت که API را بارگیری می کند، یافت نشد. لطفاً مطمئن شوید که از یک کلید API درست استفاده می کنید. می توانید یک کلید API جدید در Cloud Console ایجاد کنید. برای دریافت کلید API، روی دکمه زیر کلیک کنید. شروع کنید
`MalformedCredentialsMapError`	خطا	برنامه شما از یک طرح URI پشتیبانی نشده استفاده می کند. بررسی کنید که برنامه از یک فرمت URI معتبر همانطور که در RFC 3986 تعریف شده است استفاده می کند.
`MissingKeyMapError`	خطا	عنصر اسکریپت که API را بارگیری می کند، پارامتر احراز هویت لازم را ندارد. اگر از Maps JavaScript API استاندارد استفاده می‌کنید، باید از یک پارامتر `key` با یک کلید API معتبر استفاده کنید. برای اطلاعات بیشتر، شروع به کار با Google Maps Platform را ببینید. اگر مشتری Premium Plan هستید، باید از یک پارامتر `client` با شناسه مشتری خود یا یک پارامتر `key` با یک کلید API معتبر استفاده کنید. برای اطلاعات بیشتر، به راهنمای کلیدهای API و شناسه مشتری مراجعه کنید. اگر شما مالک وب سایت نیستید، هیچ اقدامی برای رفع این خطا وجود ندارد. با این حال، ممکن است بخواهید در صورت امکان به مالک سایت اطلاع دهید.
`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`	هشدار	ممکن است یک کلید رمزنگاری در پارامتر `client` ارائه کرده باشید. اگر مجوز Premium Plan یا Maps APIs for Work دارید، لطفاً شناسه مشتری خود را به عنوان پارامتر `client` مشخص کنید. برای Maps JavaScript API نیازی به استفاده از کلید رمزنگاری خود ندارید. راهنمای شناسه‌های مشتری برای مشتریان طرح Premium و Maps APIs for Work را ببینید.
`ClientIdLooksLikeKey`	هشدار	ممکن است یک کلید API در پارامتر `client` ارائه کرده باشید. اگر مجوز Premium Plan یا Maps APIs for Work دارید، لطفاً شناسه مشتری خود را به عنوان پارامتر `client` مشخص کنید. اگر طرح ممتاز پلتفرم Google Maps دارید، می‌توانید از یک پارامتر `client` یا یک پارامتر `key` استفاده کنید. اگر هیچ مجوزی ندارید، باید به جای پارامتر `client` از یک پارامتر `key` استفاده کنید. راهنمای احراز هویت طرح Premium را ببینید.
`InvalidChannel`	هشدار	ممکن است یک پارامتر `channel` نامعتبر ارائه کرده باشید. کانال باید یک رشته الفبایی ASCII باشد که ممکن است شامل نقطه (.)، زیرخط (_) و خط فاصله (-) باشد. لطفاً مطمئن شوید که یک پارامتر `channel` معتبر را مشخص کرده اید. مشاهده گزارش \| طرح ممتاز پلتفرم Google Maps .
`InvalidClientId`	هشدار	به نظر نمی رسد پارامتر `client` دارای شناسه مشتری صحیحی باشد. شناسه مشتری باید با "gme-" شروع شود. راهنمای احراز هویت طرح 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`	هشدار	ممکن است یک کلید رمزنگاری یا رمز امضا را به عنوان پارامتر `key` ارائه کرده باشید. اگر مجوز Premium Plan یا Maps APIs for Work دارید، لطفاً شناسه مشتری خود را به عنوان پارامتر `client` مشخص کنید و پارامتر `key` را از عنصر اسکریپت خود حذف کنید. کلید رمزنگاری برای Maps JavaScript API مورد نیاز نیست. اگر طرح ممتاز پلتفرم Google Maps دارید، می‌توانید از یک پارامتر `client` یا یک پارامتر `key` استفاده کنید. اگر هیچ مجوزی ندارید، می توانید یک کلید API در کنسول Cloud دریافت کنید. به راهنمای تعیین شناسه مشتری هنگام بارگیری API مراجعه کنید.
`KeyLooksLikeProjectNumber`	هشدار	ممکن است شماره پروژه را به عنوان پارامتر `key` ارائه کرده باشید. لطفاً مطمئن شوید که از یک کلید API درست استفاده می کنید. می توانید یک کلید API جدید در Cloud Console ایجاد کنید. با نحوه دریافت کلید API آشنا شوید .
`NoApiKeys`	هشدار	عنصر اسکریپت که API را بارگیری می کند کلید API ندارد. لطفاً مطمئن شوید که یک کلید API معتبر به عنوان پارامتر `key` وارد کرده‌اید. می توانید یک کلید API جدید در Cloud Console ایجاد کنید. برای دریافت کلید API، برای شروع روی دکمه زیر کلیک کنید. شروع کنید اگر Maps JavaScript API را از مسیر منسوخ v2 بارگیری می‌کنید، حتی اگر پارامتر `key` مشخص کرده باشید، هشدار `NoApiKeys` دریافت خواهید کرد. لطفاً راهنمای ارتقاء v2 به v3 را بررسی کنید و برنامه خود را به Maps JavaScript API v3 منتقل کنید.
`RetiredVersion`	هشدار	ممکن است یک نسخه بازنشسته را در عنصر اسکریپت خود ارائه کرده باشید. لطفاً برنامه خود را برای استفاده از یکی از نسخه های موجود به روز کنید. مشاهده نسخه \| Google Maps JavaScript API .
`SensorNotRequired`	هشدار	پارامتر `sensor` دیگر برای Maps JavaScript API مورد نیاز نیست. این مانع از عملکرد صحیح Maps JavaScript API نمی شود، اما توصیه می کنیم پارامتر `sensor` را از عنصر اسکریپت حذف کنید.
`SignatureNotRequired`	هشدار	پارامتر `signature` برای Maps JavaScript API مورد نیاز نیست. از عملکرد صحیح Maps JavaScript API جلوگیری نمی کند، اما ممکن است خطرات امنیتی ایجاد کند. لطفاً آن را از عنصر اسکریپت خود حذف کنید.
`SignedInNotSupported`	هشدار	پارامتر `signed_in` منسوخ شده است و در نسخه Maps JavaScript API که استفاده می‌کنید پشتیبانی نمی‌شود. این مانع از کار کردن Maps JavaScript API نمی‌شود، اما اگر به ویژگی‌های واردشده به سیستم متکی باشید، ممکن است رفتار برنامه شما تغییر کند.
`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 ارسال کنید. دستورالعمل‌هایی درباره نحوه ارسال سؤالات عالی در صفحه پشتیبانی موجود است.