Places UI Kit : یک کتابخانه آماده برای استفاده که فضایی را برای سفارشی‌سازی و توسعه کم کد فراهم می‌کند. آن را امتحان کنید و نظرات خود را در مورد تجربه کیت UI خود به اشتراک بگذارید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

پیام های خطا

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

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

عیب‌یابی

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

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

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

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

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

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

هشدار Google Maps JavaScript API: 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>
```
ترافیک شبکه تولیدشده توسط وب‌سایتتان را در مرورگر بررسی کنید. در Chrome، این را می‌توان بااستفاده از برگه DevTools Network مشاهده کرد. در اینجا درخواست‌های شبکه را که وب‌سایتتان ایجاد کرده است خواهید دید. درخواست‌های انجام‌شده بااستفاده از Maps JavaScript API تحت مسیر maps/api/js خواهد بود. در اینجا می‌توانید تأیید کنید که آیا درخواست‌ها از پارامتر key استفاده می‌کنند یا نه. فیلتر کردن ترافیک شبکه براساس maps/api/js هنگام مشاهده برگه شبکه می‌تواند مفید باشد.

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

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

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

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

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

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

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

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

پس‌از اینکه پروژه‌تان را در «کنسول Cloud» پیدا کردید، با پیمایش به بخش صورت‌حساب در منو سمت راست، بررسی کنید که حساب صورت‌حسابی پیوست شده باشد.

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

به صفحه فعال کردن صورت‌حساب در کنسول Cloud بروید و حساب صورت‌حسابی به پروژه‌تان اضافه کنید. برای اطلاعات بیشتر، به شروع کار با «پلاتفرم Google Maps» مراجعه کنید.

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

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

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

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

آیا حد روزانه خودتحمیلی در API فراتر رفته است؟

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

با رفتن به داشبورد «میاناهای برنامه‌سازی کاربردی و سرویس‌ها» در کنسول Cloud می‌توانید حدود روزانه‌تان را بررسی کنید. وقتی به آنجا رسیدید:

اگر درخواست شد، پروژه‌ای را انتخاب کنید.
یک API را از فهرست انتخاب کنید، سپس روی برگه سهمیه‌ها کلیک کنید.

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

کلیدهای API با محدودیت نشانی‌های IP فقط با سرویس‌های وبی قابل‌استفاده هستند که برای استفاده از سمت سرور درنظر گرفته شده‌اند (مانند Geocoding API و دیگر میاناهای برنامه‌سازی کاربردی سرویس وب). بیشتر این سرویس‌های وب دارای سرویس‌های معادل در Maps JavaScript API هستند (برای مثال، Geocoding Service را ببینید). برای استفاده از سرویس‌های سمت کارخواه Maps JavaScript API، باید کلید API جداگانه‌ای ایجاد کنید که بتوان آن را با محدودیت ارجاع‌دهنده‌های HTTP ایمن کرد (به دریافت، افزودن، و محدود کردن کلید API مراجعه کنید).

کدهای خطای Maps JavaScript API برای توسعه‌دهندگان و مالکان سایت

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

خطاهای بار کردن نقشه

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

کد خطا پیام شرح

کد خطا	پیام	شرح
`NotLoadingAPIFromGoogleMapsError`	‫Maps JavaScript API باید مستقیماً از سرورهای Google بارگیری شود.	عنصر نوشتاری که «میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps» را بار می‌کند به‌درستی در صفحه‌تان گنجانده نشده است. برای اینکه این API به‌درستی کار کند، باید مستقیماً از https://maps.googleapis.com بار شود. بار کردن Maps JavaScript API را ببینید.
`TOSViolationMapError`	به‌نظر می‌رسد این وب‌سایت «شرایط خدمات Google Maps API» را نقض می‌کند. Google Maps API برای این وب‌سایت غیرفعال شده است.	برنامه‌تان به‌دلیل عدم رعایت «شرایط خدمات Google Maps Platform» مسدود شد. پیش‌از این، چند اعلان ایمیلی برایتان ارسال شده بود. برای پژوهش‌خواهی درباره مسدود شدن و بازبینی پیاده‌سازی‌تان، لطفاً این فرم را تکمیل کنید. ظرف چند روز کاری ازطریق ایمیل پاسخ دریافت خواهید کرد. لطفاً برای رفع این خطا از اطلاعات اعتباری کلید میانای برنامه‌سازی کاربردی یا شناسه کارخواه استفاده کنید. راهنمای کلیدهای میانای برنامه‌سازی کاربردی و شناسه‌های کارخواه را ببینید.
`UnauthorizedURLForClientIdMapError`	این نشانی وب برای استفاده از «شناسه کارخواه Google Maps» ارائه‌شده مجاز نیست.	شناسه کارخواه موجود در بارگذاری متن نامعتبر یا منقضی‌شده است، یا نشانی فعلی که Maps JavaScript API را بار می‌کند به فهرست نشانی‌های وب مجاز اضافه نشده است. ثبت نشانی‌های وب مجاز را ببینید.

NotLoadingAPIFromGoogleMapsError

‫Maps JavaScript API باید مستقیماً از سرورهای Google بارگیری شود.

عنصر نوشتاری که «میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps» را بار می‌کند به‌درستی در صفحه‌تان گنجانده نشده است. برای اینکه این API به‌درستی کار کند، باید مستقیماً از https://maps.googleapis.com بار شود.

بار کردن Maps JavaScript API را ببینید.

TOSViolationMapError

به‌نظر می‌رسد این وب‌سایت «شرایط خدمات Google Maps API» را نقض می‌کند. Google Maps API برای این وب‌سایت غیرفعال شده است.

برنامه‌تان به‌دلیل عدم رعایت «شرایط خدمات Google Maps Platform» مسدود شد. پیش‌از این، چند اعلان ایمیلی برایتان ارسال شده بود. برای پژوهش‌خواهی درباره مسدود شدن و بازبینی پیاده‌سازی‌تان، لطفاً این فرم را تکمیل کنید. ظرف چند روز کاری ازطریق ایمیل پاسخ دریافت خواهید کرد.

لطفاً برای رفع این خطا از اطلاعات اعتباری کلید میانای برنامه‌سازی کاربردی یا شناسه کارخواه استفاده کنید. راهنمای کلیدهای میانای برنامه‌سازی کاربردی و شناسه‌های کارخواه را ببینید.

UnauthorizedURLForClientIdMapError

این نشانی وب برای استفاده از «شناسه کارخواه Google Maps» ارائه‌شده مجاز نیست.

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

ثبت نشانی‌های وب مجاز را ببینید.

کدهای خطای Maps JavaScript API

اگر در کنسول جاوا اسکریپت Chrome، کنسول وب Firefox یا هر ابزار معادل دیگری در مرورگرهایتان خطایی پیدا کردید، لطفاً برای یافتن توضیحات کدهای خطا، جدول زیر را ببینید.

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

کد خطای توسعه‌دهنده	نوع	شرح
`ApiNotActivatedMapError`	خطا	«میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps» در پروژه API شما فعال نیست. ممکن است لازم باشد Maps JavaScript API را در بخش APIs در کنسول Google Cloud فعال کنید. برای فعال کردن «میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps» برای پروژه‌تان، روی دکمه زیر کلیک کنید. آشنایی با نحوه کار
`ApiTargetBlockedMapError`	خطا	این کلید میانای برنامه‌سازی کاربردی برای استفاده از این سرویس یا میانای برنامه‌سازی کاربردی مجاز نیست. لطفاً تنظیمات محدودیت‌های API کلید API خود را در کنسول Google Cloud بررسی کنید تا مطمئن شوید که همه APIها و سرویس‌هایی که باید استفاده کنید به‌درستی در فهرست APIهای فعال‌شده مشخص شده‌اند. کلیدهای میانای برنامه‌سازی کاربردی را در کنسول Cloud ببینید. برای کسب اطلاعات بیشتر، به روال‌های مطلوب امنیت API مراجعه کنید.
`DeletedApiProjectMapError`	خطا	ممکن است پروژه API شما از کنسول Cloud حذف شده باشد. لطفاً پروژه‌ای را که کلید میانای برنامه‌سازی کاربردی را برای آن تولید کرده‌اید بررسی کنید که در بارکننده میانای برنامه‌سازی کاربردی جاوا اسکریپت گنجانده شده است. می‌توانید پروژه API جدیدی ایجاد کنید و کلید جدیدی در «کنسول Cloud» دریافت کنید. برای ایجاد پروژه جدید و دریافت کلید میانای API برای پروژه، روی دکمه زیر کلیک کنید. آشنایی با نحوه کار
`ClientBillingNotEnabledMapError`	خطا	صدور صورت‌حساب را در پروژه‌تان فعال نکرده‌اید. باید «صورت‌حساب» را در Google Cloud Project مرتبط با این شناسه کارخواه، اینجا فعال کنید.
`BillingNotEnabledMapError`	خطا	صدور صورت‌حساب را در پروژه‌تان فعال نکرده‌اید و این باعث بروز این خطا شده است. باید «صورت‌حساب» را در «پروژه Google Cloud» اینجا فعال کنید. بیشتر بدانید
`ExpiredKeyMapError`	خطا	کلید API که در عنصر نوشتاری بارکننده API گنجانده شده است منقضی شده است یا سیستم آن را تشخیص نمی‌دهد. اگر قبل‌از اینکه سیستم کلید را شناسایی کند سعی کنید از کلید استفاده کنید، ممکن است این خطا را پس‌از ایجاد کلید جدید API دریافت کنید. چند دقیقه صبر کنید و دوباره امتحان کنید، یا ممکن است لازم باشد کلید API جدیدی در کنسول Cloud تولید کنید. برای دریافت کلید API، روی دکمه زیر کلیک کنید. شروع به کار
`InvalidAppCheckTokenMapError`	خطا	کد App Check ارائه‌شده نامعتبر یا منقضی شده است. این خطا فقط درصورتی ممکن است رخ دهد که درستی‌سنجی «بررسی برنامه» درحال استفاده باشد. راهنمای درستی‌سنجی «بررسی برنامه» را ببینید.
`InvalidClientIdMapError`	خطا	برای افزایش امنیت و قابلیت اطمینان اصالت‌سنجی، شناسه‌های کارخواه «پلاتفرم Maps» از ۲۶ مه ۲۰۲۵ منسوخ شده‌اند و پس‌از ۳۱ مه ۲۰۲۶ دیگر قابل‌استفاده نخواهند بود. به‌جای استفاده از شناسه کارخواه، باید از اعتبارنامه کلید میانای برنامه‌سازی کاربردی برای اصالت‌سنجی ترافیک سرویس Google Maps API استفاده کنید. برای اطلاعات بیشتر، به راهنمای انتقال شناسه کارخواه مراجعه کنید. مراحل ذکرشده در راهنما را برای بازیابی موقت شناسه کارخواه دنبال کنید.
`InvalidKeyMapError`	خطا	کلید میانای برنامه‌سازی کاربردی موجود در عنصر متن که میانای برنامه‌سازی کاربردی را بار می‌کند پیدا نشد. لطفاً مطمئن شوید که از کلید میانای API درست استفاده می‌کنید. می‌توانید کلید API جدیدی در «کنسول Cloud» تولید کنید. برای دریافت کلید API، روی دکمه زیر کلیک کنید. شروع به کار
`MalformedCredentialsMapError`	خطا	برنامه شما از طرح نشانی وب پشتیبانی‌نشده‌ای استفاده می‌کند. تأیید کنید که برنامه از قالب URI معتبر همان‌گونه که در RFC 3986 تعریف شده است استفاده می‌کند.
`MissingKeyMapError`	خطا	عنصر نوشتاری که «میانای برنامه‌سازی کاربردی» را بار می‌کند فاقد پارامتر اصالت‌سنجی الزامی است. اگر از Maps JavaScript API استفاده می‌کنید، باید از پارامتر `key` با کلید API معتبر استفاده کنید. برای اطلاعات بیشتر، به شروع به کار با Google Maps Platform مراجعه کنید. اگر از شناسه کارخواه استفاده می‌کنید، باید از پارامتر `client` با شناسه کارخواه خود یا پارامتر `key` با کلید API معتبر استفاده کنید. برای اطلاعات بیشتر، راهنمای کلیدهای میانای برنامه‌سازی کاربردی و شناسه‌های مشتری را ببینید. اگر مالک وب‌سایت نیستید، هیچ اقدامی نمی‌توانید برای رفع این خطا انجام دهید. بااین‌حال، درصورت امکان بهتر است به مالک سایت اطلاع دهید.
`ProjectDeniedMapError`	خطا	درخواستتان تکمیل نشده است. ممکن است بتوانید جزئیات بیشتر درباره خطا را در «کنسول Cloud» پیدا کنید. کنسول Cloud را ببینید.
`RefererDeniedMapError`	خطا	برنامه‌تان به‌دلیل عدم رعایت «شرایط خدمات Google Maps Platform» مسدود شد. پیش‌از این، چند اعلان ایمیلی برایتان ارسال شده بود. برای پژوهش‌خواهی کردن مسدود شدن و بررسی شدن پیاده‌سازی‌تان، لطفاً این فرم را تکمیل کنید. ظرف چند روز کاری پاسخی ازطریق ایمیل دریافت خواهید کرد.
`RefererNotAllowedMapError`	خطا	نشانی وب فعلی که Maps JavaScript API را بار می‌کند به فهرست ارجاع‌دهنده‌های مجاز اضافه نشده است. لطفاً تنظیمات ارجاع‌دهنده کلید API خود را در «کنسول Cloud» بررسی کنید. به Maps JavaScript API و دریافت کلید میانای برنامه‌سازی کاربردی مراجعه کنید.
`OverQuotaMapError`	خطا	تعداد درخواست‌ها از حدود استفاده برای Maps JavaScript API فراتر رفته است. درخواست‌های برنامه شما در بازنشانی سهمیه روزانه بعدی دوباره کار خواهد کرد. اگر مالک وب‌سایت نیستید، هیچ اقدامی نمی‌توانید برای رفع این خطا انجام دهید. بااین‌حال، درصورت امکان بهتر است به مالک سایت اطلاع دهید. برای جزئیات بیشتر، راهنمای حدود استفاده را ببینید. این صفحه همچنین توضیح می‌دهد که چگونه می‌توانید حد استفاده بالاتری دریافت کنید.
`ApiProjectMapError`	خطا	یا کلید میانای برنامه‌سازی کاربردی ارائه‌شده یا پروژه میانای برنامه‌سازی کاربردی که با آن مرتبط است، حل‌وفصل نشد. این خطا ممکن است موقتی باشد. اگر این پیام خطا ادامه داشت، ممکن است لازم باشد کلید میانای برنامه‌سازی کاربردی جدیدی دریافت کنید یا پروژه میانای برنامه‌سازی کاربردی جدیدی بسازید. برای اطلاعات بیشتر، به شروع به کار با Google Maps Platform مراجعه کنید.
`ClientIdLooksLikeCryptoKey`	هشدار	ممکن است کلید رمزنگاری‌شده‌ای را در پارامتر `client` ارائه کرده باشید. لطفاً شناسه کارخواهتان را به‌عنوان پارامتر `client` مشخص کنید. نیازی نیست از کلید رمزنگاری‌شده برای میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps استفاده کنید. به راهنمای شناسه‌های کارخواه مراجعه کنید.
`ClientIdLooksLikeKey`	هشدار	ممکن است کلید میانای API (کلید میانای برنامه‌سازی کاربردی) را در پارامتر `client` ارائه کرده باشید. لطفاً شناسه مشتری‌تان را به‌عنوان پارامتر `client` مشخص کنید، یا به‌جای پارامتر `client`، از پارامتر `key` با کلید API معتبر استفاده کنید. راهنمای کلیدهای میانای برنامه‌سازی کاربردی و شناسه‌های کارخواه را ببینید.
`InvalidChannel`	هشدار	ممکن است پارامتر `channel` نامعتبری ارائه کرده باشید. کانال باید رشته الفباعددی ASCII باشد که می‌تواند شامل نقطه (.)، زیرخط (_) و خط تیره (-) باشد. لطفاً مطمئن شوید که پارامتر `channel` معتبری را مشخص می‌کنید. گزارش‌دهی \| Google Maps Platform را ببینید.
`InvalidClientId`	هشدار	به‌نظر می‌رسد پارامتر `client` شناسه مشتری صحیح ندارد. شناسه مشتری باید با «gme-‎» شروع شود. راهنمای کلیدهای میانای برنامه‌سازی کاربردی و شناسه‌های کارخواه را ببینید.
`InvalidKey`	هشدار	کلید API که در عنصر نوشتاری بارکننده API گنجانده شده است درست به‌نظر نمی‌رسد. لطفاً مطمئن شوید که از کلید میانای API صحیح استفاده می‌کنید. می‌توانید کلید API جدیدی در «کنسول Cloud» تولید کنید. برای دریافت کلید میانای API، روی دکمه زیر کلیک کنید. شروع به کار
`InvalidVersion`	هشدار	ممکن است شماره نسخه نادرستی را در عنصر دستورگان خود ارائه کرده باشید. لطفاً مطمئن شوید که از شماره نسخه صحیح استفاده می‌کنید. نسخه‌بندی \| Google Maps JavaScript API را ببینید.
`KeyLooksLikeClientId`	هشدار	ممکن است شناسه کارخواه را به‌عنوان پارامتر `key` ارائه کرده باشید. لطفاً شناسه کارخواه خود را به‌جای پارامتر `key` به‌عنوان پارامتر `client` مشخص کنید، یا از پارامتر `key` با کلید میانای برنامه‌سازی کاربردی معتبر استفاده کنید. راهنمای کلیدهای میانای برنامه‌سازی کاربردی و شناسه‌های کارخواه را ببینید.
`KeyLooksLikeCryptoKey`	هشدار	ممکن است کلید رمزنگاری‌شده یا رمز امضا را به‌عنوان پارامتر `key` ارائه کرده باشید. لطفاً شناسه کارخواهتان را به‌عنوان پارامتر `client` مشخص کنید، و پارامتر `key` را از عنصر نوشتاری‌تان بردارید. کلید رمزنگاری برای «میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps» لازم نیست. یا می‌توانید کلید میانای برنامه‌سازی کاربردی را در کنسول Cloud دریافت کنید و از پارامتر `key` استفاده کنید. راهنمای مشخص کردن شناسه مشتری هنگام بار کردن API را ببینید.
`KeyLooksLikeProjectNumber`	هشدار	ممکن است شماره پروژه‌ای را به‌عنوان پارامتر `key` ارائه کرده باشید. لطفاً مطمئن شوید که از کلید میانای API صحیح استفاده می‌کنید. می‌توانید کلید API جدیدی در «کنسول Cloud» تولید کنید. با نحوه دریافت کلید API آشنا شوید.
`NoApiKeys`	هشدار	عنصر دستورگانی که API را بار می‌کند کلید API ندارد. لطفاً مطمئن شوید کلید میانای API معتبری را به‌عنوان پارامتر `key` اضافه کرده‌اید. می‌توانید کلید API جدیدی در «کنسول Cloud» تولید کنید. برای دریافت کلید API، روی دکمه زیر کلیک کنید تا شروع کنید. شروع به کار اگر Maps JavaScript API را از مسیر منسوخ‌شده v2 بار می‌کنید، هشدار `NoApiKeys` را دریافت خواهید کرد، حتی اگر پارامتر `key` را مشخص کرده باشید. لطفاً راهنمای ارتقا از نسخه ۲ به نسخه ۳ را بررسی کنید و برنامه خود را به نسخه ۳ Maps JavaScript API منتقل کنید.
`RetiredVersion`	هشدار	ممکن است نسخه‌ای قدیمی را در عنصر اسکریپت خود ارائه کرده باشید. لطفاً برنامه‌تان را به‌روز کنید تا از یکی از نسخه‌های دردسترس استفاده کنید. نسخه‌بندی \| Google Maps JavaScript API را ببینید.
`SensorNotRequired`	هشدار	پارامتر `sensor` دیگر برای میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps لازم نیست. این کار مانع از عملکرد صحیح Maps JavaScript API نمی‌شود، اما توصیه می‌کنیم پارامتر `sensor` را از عنصر نوشتار بردارید.
`SignatureNotRequired`	هشدار	پارامتر `signature` برای میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps لازم نیست. این کار مانع از عملکرد صحیح Maps JavaScript API نمی‌شود، اما ممکن است مخاطرات امنیتی ایجاد کند. لطفاً آن را از عنصر اسکریپت خود بردارید.
`SignedInNotSupported`	هشدار	پارامتر `signed_in` منسوخ شده است و در نسخه «میانای برنامه‌سازی کاربردی جاوا اسکریپت Maps» که استفاده می‌کنید پشتیبانی نمی‌شود. این کار مانع از عملکرد Maps JavaScript API نمی‌شود، اما اگر به ویژگی‌های ورود به سیستم متکی باشید، ممکن است رفتار برنامه‌تان تغییر کند.
`UrlAuthenticationCommonError`	خطا	خطایی روی داده است که در دسته‌های دیگر این صفحه قرار نمی‌گیرد. ممکن است دلیل آن مشکلی موقت باشد. لطفاً درخواست را پس‌از کمی تأخیر دوباره امتحان کنید. اگر با این کار مشکل برطرف نشد، لطفاً راهنمای توسعه‌دهنده را مرور کنید تا مطمئن شوید درخواست قالب مناسبی دارد.

بررسی خطاها در مرورگر

Maps JavaScript API پیام‌های خطا را در window.console می‌نویسد. این بخش توضیح می‌دهد که چگونه می‌توانید خروجی window.console را در Google Chrome بررسی کنید. اگر از مرورگر دیگری استفاده می‌کنید، لطفاً اسناد توسعه‌دهنده مرورگرتان را بررسی کنید. برای اطلاع شما، این فهرست ابزارهایی است که می‌توانید با آن‌ها خروجی window.console را در برخی مرورگرهای دیگر بررسی کنید.

کنسول وب برای Firefox.
اشکال‌زدایی از راه دور برای Android.
بازرس وب برای iOS.

در Chrome، می‌توانید از کنسول جاوا اسکریپت برای بررسی برونداد window.console به روش زیر استفاده کنید.

برای باز کردن «ابزارهای توسعه‌دهندگان»، نماد منو > ابزارهای بیشتر > ابزارهای توسعه‌دهندگان را انتخاب کنید.
برای باز کردن «کنسول جاوا اسکریپت»، کلید «گریز» را روی صفحه‌کلید فشار دهید. کلید 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 پشتیبانی می‌شود.

اگر درحال توسعه برنامه بومی Windows هستید که در «وب‌نما» اجرا می‌شود، مطمئن شوید که از WebView2 مبتنی بر Edge استفاده می‌کنید. نسخه‌های قبلی WebView، براساس Internet Explorer، دیگر پشتیبانی نمی‌شوند.

اگر کد همچنان کار نمی‌کند

برای کمک به شما در راه‌اندازی و اجرای کد نقشه‌ها، برندان کنی و مانو مارکز در این ویدیو به برخی‌از اشتباهات رایج و نحوه رفع آن‌ها اشاره می‌کنند.

غلط املایی را بررسی کنید. به‌خاطر داشته باشید که جاوا اسکریپت زبانی حروف‌حساس است.
موارد پایه را بررسی کنید - برخی‌از رایج‌ترین مشکلات در ایجاد نقشه اولیه رخ می‌دهد. برای مثال:
- تأیید کنید که ویژگی‌های zoom و center را در گزینه‌های نقشه مشخص کرده‌اید.
- مطمئن شوید که عنصر div را که نقشه در آن در صفحه نمایش داده می‌شود اعلام کرده‌اید.
- مطمئن شوید عنصر div برای نقشه ارتفاع داشته باشد. به‌طور پیش‌فرض، عناصر div با ارتفاع ۰ ایجاد می‌شوند و بنابراین نامرئی هستند.
برای پیاده‌سازی مرجع به نمونه‌های ما مراجعه کنید.
از اشکال‌زدای جاوا اسکریپت برای کمک به شناسایی مشکلات استفاده کنید، مثل اشکال‌زدایی که در ابزارهای توسعه‌دهنده Chrome دردسترس است. با بررسی کنسول جاوا اسکریپت برای یافتن خطاها شروع کنید.
سؤالات را در Stack Overflow پست کنید. دستورالعمل‌های مربوط به نحوه پست کردن سؤالات عالی در صفحه پشتیبانی دردسترس است.