reviews دریافت کلید نسخه نمایشی Maps: با «کلید نسخه نمایشی Maps» برخی‌از ویژگی‌های Maps JavaScript API و «کیت میانای کاربر جاها» را بدون هزینه امتحان کنید—اطلاعات صورت‌حساب لازم نیست.
Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.
عیب‌یابی
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
خطاهای کلید میانای API و صورت‌حساب
در شرایط خاصی، ممکن است نقشه تاریک‌شده یا تصویر «نمای خیابان» «منفی»
با ته‌نقش نوشتاری «فقط برای اهداف توسعه» نمایش داده شود.
این رفتار معمولاً نشان‌دهنده وجود مشکل در کلید API یا صورت‌حساب است.
برای استفاده از محصولات Google Maps Platform، باید صورت‌حساب در حسابتان فعال باشد،
و همه درخواست‌ها باید شامل کلید میانای برنامه‌سازی کاربردی معتبر باشد. جریان زیر به عیب‌یابی این مشکل کمک می‌کند:
آیا از کلید میانای API استفاده می‌کنید؟
مطمئن نیستم. چگونه می‌توانم بررسی کنم که آیا از کلید میانای API استفاده می‌کنم؟
کلید میانای برنامه‌سازی کاربردی به‌عنوان پارامتر key در نشانی وبی که برای بار کردن
Maps JavaScript API استفاده می‌شود ارسال می‌شود. در اینجا چند گزینه برای بررسی اینکه آیا از کلید میانای برنامه‌سازی کاربردی استفاده می‌کنید یا نه ارائه شده است:
از افزونه Chrome
Google Maps Platform API Checker استفاده کنید. این کار به شما امکان می‌دهد تعیین کنید که آیا وب‌سایتتان به‌درستی از میاناهای برنامه‌سازی کاربردی Maps دارای پروانه Google استفاده می‌کند یا نه.
اگر از کتابخانه یا افزونه‌ای برای بار کردن Maps JavaScript API استفاده می‌کنید،
تنظیمات آن کتابخانه را بررسی کنید و به‌دنبال گزینه کلید API بگردید.
خطاهای مرورگر را بررسی کنید.
اگر پیام‌های زیر را می‌بینید، از کلید میانای برنامه‌سازی کاربردی به‌درستی استفاده نمی‌کنید:
اگر به کد منبع برنامه‌تان دسترسی دارید، به‌دنبال برچسب
<script> بگردید که برای بار کردن Maps JavaScript API استفاده می‌شود.
هنگام بار کردن Maps JavaScript API، YOUR_API_KEY
را در کد زیر با کلید API خود جایگزین کنید.
ترافیک شبکه تولیدشده توسط وب‌سایتتان را در مرورگر بررسی کنید.
در Chrome، این مورد را می‌توان بااستفاده از برگه
DevToolsشبکه مشاهده کرد.
در اینجا درخواست‌های شبکه را که توسط وب‌سایت شما انجام شده است مشاهده خواهید کرد. درخواست‌های انجام‌شده بااستفاده از
Maps JavaScript API تحت مسیر maps/api/js خواهد بود.
در اینجا می‌توانید تأیید کنید که آیا درخواست‌ها از پارامتر key استفاده می‌کنند یا نه.
فیلتر کردن ترافیک شبکه براساس maps/api/js هنگام مشاهده برگه شبکه می‌تواند مفید باشد.
عالی! بیایید ادامه دهیم و بررسی کنیم که آیا حساب صورت‌حساب به پروژه‌تان پیوست شده است یا نه.
آیا حساب صورت‌حساب به پروژه‌تان پیوست شده است؟
مطمئن نیستم. چگونه می‌توانم بررسی کنم که آیا حساب صورت‌حساب به پروژه من پیوست شده است یا نه؟
به
صفحه صورت‌حساب در کنسول Google Cloud بروید و پروژه‌ای را که کلید میانای API شما تحت آن ایجاد شده است انتخاب کنید.
برای تأیید اینکه کلید با پروژه مرتبط است:
به بخش اعتبارنامه‌ها بروید که از نوار کناری سمت راست در زیر
پلاتفرم Google Maps > اعتبارنامه‌ها قابل‌دسترسی است.
بررسی کنید کلید میانای API که درحال‌حاضر در وب‌سایتتان استفاده می‌کنید در فهرست باشد.
اگر این‌طور نیست، به پروژه دیگری بروید و اعتبارنامه‌ها را در آنجا بررسی کنید.
اگر نمی‌توانید پروژه کلید میانای API خود را پیدا کنید، ممکن است دسترسی به این پروژه را ازدست داده باشید.
از دیگران در سازمانتان کمک بخواهید. اگر پروژه اصلی پیدا نشد، باید:
پروژه جدیدی ایجاد کنید. این کار را می‌توانید با انتخاب پروژه جدید
از فهرست پروژه‌ها، یا با انتخاب ایجاد پروژه ازطریق
صفحه مدیر منابع انجام دهید.
کلید میانای API جدیدی ایجاد کنید. این کار را می‌توانید در صفحه اطلاعات اعتباری انجام دهید.
پس‌از رفتن به آنجا، روی ایجاد اطلاعات کاربری کلیک کنید و سپس کلید میانای API را انتخاب کنید.
وقتی پروژه‌تان را در کنسول Cloud پیدا کردید،
با رفتن به بخش صورت‌حساب در منو سمت راست، بررسی کنید که آیا حساب صورت‌حساب پیوست شده است یا نه.
اگر برای هرکدام از میاناهای برنامه‌سازی کاربردی‌تان حد روزانه تنظیم کرده‌اید، که برای جلوگیری از افزایش‌های غیرمنتظره رایج است،
می‌توانید این مشکل را با افزایش حد روزانه برطرف کنید.
یک API را از فهرست انتخاب کنید، سپس روی برگه سهمیه‌ها کلیک کنید.
آیا کلید میانای API شما محدودیت نشانی IP دارد؟
کلیدهای API با محدودیت نشانی‌های IP فقط با سرویس‌های وبی قابل‌استفاده هستند که
برای استفاده از سمت سرور درنظر گرفته شده‌اند (مانند
Geocoding API
و دیگر میاناهای برنامه‌سازی کاربردی سرویس وب).
Most of these web services have equivalent services within the Maps JavaScript API (for example, see the
Geocoding Service).
برای استفاده از سرویس‌های سمت کارخواه Maps JavaScript API، باید کلید API جداگانه‌ای ایجاد کنید که
می‌توان آن را با محدودیت ارجاع‌دهنده‌های HTTP ایمن کرد (به
دریافت، افزودن، و محدود کردن کلید API مراجعه کنید).
اگر کدتان کار نمی‌کند:
برای کمک به شما در راه‌اندازی و اجرای کد نقشه‌هایتان، برندان کنی و مانو مارکس
برخی اشتباهات رایج و نحوه رفع آن‌ها را در این ویدیو نشان می‌دهند.
غلط املایی را بررسی کنید. به‌خاطر داشته باشید که جاوا اسکریپت زبانی
حروف‌حساس است.
موارد پایه را بررسی کنید - برخی‌از رایج‌ترین مشکلات در ایجاد نقشه اولیه رخ می‌دهد. برای مثال:
تأیید کنید که ویژگی‌های zoom
و center را در گزینه‌های نقشه
مشخص کرده‌اید.
مطمئن شوید که عنصر div را که نقشه در آن در صفحه ظاهر می‌شود اعلام کرده‌اید.
مطمئن شوید که عنصر div برای نقشه دارای ارتفاع CSS صریح غیرصفر (برای مثال، height: 400px) باشد. به‌طور پیش‌فرض، عناصر div با ارتفاع ۰ ایجاد می‌شوند و بنابراین نامرئی هستند.
تاریخ آخرین بهروزرسانی 2026-10-30 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2026-10-30 بهوقت ساعت هماهنگ جهانی."],[],["Using the Maps JavaScript API requires a valid API key and enabled billing. Issues like a darkened map typically stem from these. Verify API key usage via browser checks, source code, or network traffic. Ensure the project linked to your API key has an active billing account. Check for invalid payment methods or exceeded API daily limits. If restricted by IP address, create a key with HTTP referrers. Troubleshoot by checking for typos, verifying map element properties, or using a JavaScript debugger.\n"]]
