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

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

پیغام خطا

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

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

عیب‌یابی

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

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

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

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

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

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

هشدار API جاوا اسکریپت نقشه گوگل: NoApiKeys
خطای API جاوا اسکریپت نقشه گوگل: MissingKeyMapError

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

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

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

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

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

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

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

مطمئن نیستم. چطور می‌توانم بررسی کنم که آیا حساب صورتحساب به پروژه من متصل است یا خیر؟

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

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

پس از اینکه پروژه خود را در کنسول Cloud پیدا کردید، با رفتن به بخش Billing در منوی سمت چپ، بررسی کنید که آیا حساب صورتحساب متصل شده است یا خیر.

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

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

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

عالیه! بیایید مطمئن شویم که روش پرداخت ارائه شده معتبر است.

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

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

آیا محدودیت روزانه‌ای که خودتان برای API تعیین کرده‌اید، بیش از حد مجاز است؟

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

می‌توانید محدودیت‌های روزانه خود را با رفتن به داشبورد APIها و خدمات در کنسول ابری بررسی کنید. در آنجا:

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

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

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

کدهای خطای API جاوا اسکریپت نقشه برای توسعه‌دهندگان و صاحبان سایت

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

خطاهای بارگذاری نقشه

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

کد خطا پیام توضیحات

کد خطا	پیام	توضیحات
`NotLoadingAPIFromGoogleMapsError`	API جاوا اسکریپت Maps باید مستقیماً از سرورهای گوگل دانلود شود.	عنصر اسکریپتی که API جاوا اسکریپت Maps را بارگذاری می‌کند، به درستی در صفحه شما گنجانده نشده است. برای اینکه API به درستی کار کند، باید مستقیماً از https://maps.googleapis.com بارگذاری شود. به بارگذاری API جاوا اسکریپت نقشه‌ها مراجعه کنید.
`TOSViolationMapError`	به نظر می‌رسد این وب‌سایت شرایط خدمات Google Maps API را نقض می‌کند. Google Maps API برای این وب‌سایت غیرفعال شده است.	درخواست شما به دلیل عدم رعایت شرایط خدمات پلتفرم نقشه‌های گوگل، پس از چندین ایمیل اطلاع‌رسانی، مسدود شده است. برای اعتراض به مسدودیت و بررسی پیاده‌سازی خود، لطفاً این فرم را تکمیل کنید. ظرف چند روز کاری از طریق ایمیل پاسخ دریافت خواهید کرد. اگر مجوز طرح ویژه پلتفرم نقشه‌های گوگل (Google Maps Platform Premium Plan) دارید، لطفاً از اعتبارنامه‌های طرح ویژه پلتفرم نقشه‌های گوگل خود برای رفع این خطا استفاده کنید. به راهنمای احراز هویت طرح ویژه مراجعه کنید.
`UnauthorizedURLForClientIdMapError`	این نشانی اینترنتی (URL) مجاز به استفاده از شناسه کلاینت نقشه‌های گوگل (Google Maps Client ID) ارائه شده نیست.	شناسه کلاینت طرح ویژه یا Maps APIs for Work که در بارگذاری اسکریپت موجود است، نامعتبر، منقضی شده یا آدرس فعلی که API جاوا اسکریپت Maps را بارگذاری می‌کند، به فهرست URLهای مجاز اضافه نشده است. به ثبت URL های مجاز مراجعه کنید.

NotLoadingAPIFromGoogleMapsError

API جاوا اسکریپت Maps باید مستقیماً از سرورهای گوگل دانلود شود.

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

به بارگذاری API جاوا اسکریپت نقشه‌ها مراجعه کنید.

TOSViolationMapError

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

درخواست شما به دلیل عدم رعایت شرایط خدمات پلتفرم نقشه‌های گوگل، پس از چندین ایمیل اطلاع‌رسانی، مسدود شده است. برای اعتراض به مسدودیت و بررسی پیاده‌سازی خود، لطفاً این فرم را تکمیل کنید. ظرف چند روز کاری از طریق ایمیل پاسخ دریافت خواهید کرد.

اگر مجوز طرح ویژه پلتفرم نقشه‌های گوگل (Google Maps Platform Premium Plan) دارید، لطفاً از اعتبارنامه‌های طرح ویژه پلتفرم نقشه‌های گوگل خود برای رفع این خطا استفاده کنید. به راهنمای احراز هویت طرح ویژه مراجعه کنید.

UnauthorizedURLForClientIdMapError

این نشانی اینترنتی (URL) مجاز به استفاده از شناسه کلاینت نقشه‌های گوگل (Google Maps Client ID) ارائه شده نیست.

شناسه کلاینت طرح ویژه یا Maps APIs for Work که در بارگذاری اسکریپت موجود است، نامعتبر، منقضی شده یا آدرس فعلی که API جاوا اسکریپت Maps را بارگذاری می‌کند، به فهرست URLهای مجاز اضافه نشده است.

به ثبت URL های مجاز مراجعه کنید.

کدهای خطای API جاوا اسکریپت نقشه‌ها

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

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

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

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

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

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

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

برای باز کردن ابزارهای توسعه‌دهنده، نماد منو > ابزارهای بیشتر > ابزارهای توسعه‌دهنده را انتخاب کنید.
برای باز کردن کنسول جاوا اسکریپت، کلید ESC را روی صفحه کلید خود فشار دهید. کلید ESC کنسول جاوا اسکریپت را تغییر وضعیت می‌دهد. اگر کنسول را بستید، دوباره کلید ESC را فشار دهید تا باز شود.

اگر هنگام بارگذاری API جاوا اسکریپت Maps هرگونه خطا یا هشداری رخ دهد، به صورت یک یا چند خط در کنسول ظاهر می‌شود. یک پیام خطا یا هشدار دارای قالب زیر است:

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 که مبتنی بر Internet Explorer بودند، دیگر پشتیبانی نمی‌شوند.

اگر کد شما هنوز کار نمی‌کند

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

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