تحت شرایط خاص، ممکن است یک نقشه تاریک یا تصویر "منفی" نمای خیابان، با متن "فقط برای اهداف توسعه" نشان داده شود. این رفتار معمولاً مشکلات مربوط به کلید 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 خود به درستی استفاده نمی کنید:
اگر به کد منبع برنامه خود دسترسی دارید، به دنبال تگ <script> باشید که برای بارگیری Maps JavaScript API استفاده می شود. هنگام بارگیری Maps JavaScript API، YOUR_API_KEY در کد زیر را با کلید API خود جایگزین کنید.
ترافیک شبکه ایجاد شده توسط وب سایت خود را در مرورگر بررسی کنید. در کروم، این مورد را می توان با استفاده از تب DevToolsNetwork مشاهده کرد. در اینجا درخواست های شبکه ای را که توسط وب سایت خود ارائه شده است مشاهده خواهید کرد. درخواست‌های ارسال شده با استفاده از Maps JavaScript API در مسیر maps/api/js قرار خواهند گرفت. در اینجا می توانید تأیید کنید که آیا درخواست ها از پارامتر key استفاده می کنند. فیلتر کردن ترافیک شبکه بر اساس maps/api/js هنگام مشاهده برگه Network ممکن است مفید باشد.
نه، من از کلید API استفاده نمی کنم.
برای دریافت کلید API، روی دکمه زیر کلیک کنید. اگر راه‌اندازی هدایت‌شده را نمی‌بینید، دستورالعمل‌های کامل را در «شروع با پلتفرم Google Maps» دنبال کنید. شروع کنید
بله، من از یک کلید API استفاده می کنم.
عالیه بیایید ادامه دهیم و بررسی کنیم که آیا یک حساب صورتحساب به پروژه شما متصل است یا خیر.
آیا یک حساب صورتحساب به پروژه شما پیوست شده است؟
من مطمئن نیستم. چگونه می توانم بررسی کنم که آیا حساب صورتحساب به پروژه من پیوست شده است؟
به صفحه صورتحساب در کنسول Google Cloud بروید و پروژه ای را که بر اساس آن کلید API شما ایجاد شده است انتخاب کنید. برای تأیید اینکه کلید با پروژه مرتبط است:
به بخش Credentials بروید، که از نوار سمت چپ زیر Google Maps Platform > Credentials قابل دسترسی است.
بررسی کنید که کلید API که در حال حاضر در وب‌سایت خود استفاده می‌کنید فهرست شده باشد. اگر اینطور نیست، به پروژه دیگری بروید و اعتبار را در آنجا بررسی کنید.
اگر نمی توانید پروژه را برای کلید API خود پیدا کنید، ممکن است دسترسی به این پروژه را از دست داده باشید. از دیگران در سازمان خود کمک بخواهید. اگر پروژه اصلی نمی تواند مکان یابی شود، باید:
یک پروژه جدید ایجاد کنید. این کار را می توان با انتخاب پروژه جدید از لیست پروژه ها یا با انتخاب ایجاد پروژه از طریق صفحه مدیریت منابع انجام داد.
یک کلید API جدید ایجاد کنید. این کار را می توان در صفحه اعتبارنامه انجام داد. پس از آن روی Create credentials کلیک کنید و سپس کلید API را انتخاب کنید.
هنگامی که پروژه خود را در کنسول Cloud قرار دادید، با رفتن به بخش صورتحساب در منوی سمت چپ، بررسی کنید که آیا یک حساب صورتحساب ضمیمه شده است.
اگر محدودیت روزانه برای هر یک از API های خود تعیین کرده اید، که برای جلوگیری از افزایش غیرمنتظره معمول است، می توانید با افزایش محدودیت روزانه خود ، این مشکل را حل کنید.
می توانید محدودیت های روزانه خود را با رفتن به داشبورد APIs & Services در کنسول Cloud بررسی کنید. یک بار آنجا:
در صورت درخواست، پروژه ای را انتخاب کنید.
یک API را از لیست انتخاب کنید، سپس روی برگه Quotas کلیک کنید.
آیا کلید API شما دارای محدودیت آدرس IP است؟
کلیدهای API با محدودیت آدرس‌های IP را فقط می‌توان با سرویس‌های وب استفاده کرد که برای استفاده از سمت سرور در نظر گرفته شده‌اند (مانند API Geocoding و سایر APIهای وب سرویس ). اکثر این سرویس‌های وب دارای سرویس‌های معادل در Maps JavaScript API هستند (به عنوان مثال، سرویس کدگذاری جغرافیایی را ببینید). برای استفاده از خدمات سمت سرویس گیرنده Maps JavaScript API، باید یک کلید API جداگانه ایجاد کنید که می تواند با محدودیت ارجاع دهنده HTTP ایمن شود (به دریافت، افزودن و محدود کردن یک کلید API مراجعه کنید).
اگر کد شما کار نمی کند:
برندان کنی و مانو مارکس برای کمک به شما در راه‌اندازی کد نقشه‌های خود، در این ویدیو به برخی از اشتباهات رایج و نحوه رفع آنها اشاره می‌کنند.
به دنبال اشتباهات تایپی باشید به یاد داشته باشید که جاوا اسکریپت یک زبان حساس به حروف بزرگ و کوچک است.
اصول اولیه را بررسی کنید - برخی از رایج ترین مشکلات با ایجاد نقشه اولیه رخ می دهد. مانند:
تأیید کنید که ویژگی های zoom و center را در گزینه های نقشه خود مشخص کرده اید.
اطمینان حاصل کنید که یک عنصر div را اعلام کرده اید که در آن نقشه روی صفحه ظاهر می شود.
اطمینان حاصل کنید که عنصر div برای نقشه دارای ارتفاع است. به طور پیش فرض، عناصر div با ارتفاع 0 ایجاد می شوند و بنابراین نامرئی هستند.
از یک اشکال‌زدای جاوا اسکریپت برای کمک به شناسایی مشکلات استفاده کنید، مانند آنچه در ابزارهای برنامه‌نویس Chrome موجود است. با جستجوی خطا در کنسول جاوا اسکریپت شروع کنید.
سوالات را به Stack Overflow ارسال کنید. دستورالعمل‌هایی درباره نحوه ارسال سؤالات عالی در صفحه پشتیبانی موجود است.
،
کلید 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 خود به درستی استفاده نمی کنید:
اگر به کد منبع برنامه خود دسترسی دارید، به دنبال تگ <script> باشید که برای بارگیری Maps JavaScript API استفاده می شود. هنگام بارگیری Maps JavaScript API، YOUR_API_KEY در کد زیر را با کلید API خود جایگزین کنید.
ترافیک شبکه ایجاد شده توسط وب سایت خود را در مرورگر بررسی کنید. در کروم، این مورد را می توان با استفاده از تب DevToolsNetwork مشاهده کرد. در اینجا درخواست های شبکه ای را که توسط وب سایت خود ارائه شده است مشاهده خواهید کرد. درخواست‌های ارسال شده با استفاده از Maps JavaScript API در مسیر maps/api/js قرار خواهند گرفت. در اینجا می توانید تأیید کنید که آیا درخواست ها از پارامتر key استفاده می کنند. فیلتر کردن ترافیک شبکه بر اساس maps/api/js هنگام مشاهده برگه Network ممکن است مفید باشد.
نه، من از کلید API استفاده نمی کنم.
برای دریافت یک کلید API، روی دکمه زیر کلیک کنید. اگر راه‌اندازی هدایت‌شده را نمی‌بینید، دستورالعمل‌های کامل را در «شروع با پلتفرم Google Maps» دنبال کنید. شروع کنید
بله، من از یک کلید API استفاده می کنم.
عالیه بیایید ادامه دهیم و بررسی کنیم که آیا یک حساب صورتحساب به پروژه شما متصل است یا خیر.
آیا یک حساب صورتحساب به پروژه شما پیوست شده است؟
من مطمئن نیستم. چگونه می توانم بررسی کنم که آیا حساب صورتحساب به پروژه من پیوست شده است؟
به صفحه صورتحساب در کنسول Google Cloud بروید و پروژه ای را که بر اساس آن کلید API شما ایجاد شده است انتخاب کنید. برای تأیید اینکه کلید با پروژه مرتبط است:
به بخش Credentials بروید، که از نوار سمت چپ زیر Google Maps Platform > Credentials قابل دسترسی است.
بررسی کنید که کلید API که در حال حاضر در وب‌سایت خود استفاده می‌کنید فهرست شده باشد. اگر اینطور نیست، به پروژه دیگری بروید و اعتبار را در آنجا بررسی کنید.
اگر نمی توانید پروژه را برای کلید API خود پیدا کنید، ممکن است دسترسی به این پروژه را از دست داده باشید. از دیگران در سازمان خود کمک بخواهید. اگر پروژه اصلی نمی تواند مکان یابی شود، باید:
یک پروژه جدید ایجاد کنید. این کار را می توان با انتخاب پروژه جدید از لیست پروژه ها یا با انتخاب ایجاد پروژه از طریق صفحه مدیریت منابع انجام داد.
یک کلید API جدید ایجاد کنید. این کار را می توان در صفحه اعتبارنامه انجام داد. پس از آن روی Create credentials کلیک کنید و سپس کلید API را انتخاب کنید.
هنگامی که پروژه خود را در کنسول Cloud قرار دادید، با رفتن به بخش صورتحساب در منوی سمت چپ، بررسی کنید که آیا یک حساب صورتحساب ضمیمه شده است.
اگر محدودیت روزانه برای هر یک از API های خود تعیین کرده اید، که برای جلوگیری از افزایش غیرمنتظره معمول است، می توانید با افزایش محدودیت روزانه خود ، این مشکل را حل کنید.
می توانید محدودیت های روزانه خود را با رفتن به داشبورد APIs & Services در کنسول Cloud بررسی کنید. یک بار آنجا:
در صورت درخواست، پروژه ای را انتخاب کنید.
یک API را از لیست انتخاب کنید، سپس روی برگه Quotas کلیک کنید.
آیا کلید API شما دارای محدودیت آدرس IP است؟
کلیدهای API با محدودیت آدرس‌های IP را فقط می‌توان با سرویس‌های وب استفاده کرد که برای استفاده از سمت سرور در نظر گرفته شده‌اند (مانند API Geocoding و سایر APIهای وب سرویس ). اکثر این سرویس‌های وب دارای سرویس‌های معادل در Maps JavaScript API هستند (به عنوان مثال، سرویس کدگذاری جغرافیایی را ببینید). برای استفاده از خدمات سمت سرویس گیرنده Maps JavaScript API، باید یک کلید API جداگانه ایجاد کنید که می تواند با محدودیت ارجاع دهنده HTTP ایمن شود (به دریافت، افزودن و محدود کردن یک کلید API مراجعه کنید).
اگر کد شما کار نمی کند:
برندان کنی و مانو مارکس برای کمک به شما در راه‌اندازی کد نقشه‌های خود، در این ویدیو به برخی از اشتباهات رایج و نحوه رفع آنها اشاره می‌کنند.
به دنبال اشتباهات تایپی باشید به یاد داشته باشید که جاوا اسکریپت یک زبان حساس به حروف بزرگ و کوچک است.
اصول اولیه را بررسی کنید - برخی از رایج ترین مشکلات با ایجاد نقشه اولیه رخ می دهد. مانند:
تأیید کنید که ویژگی های zoom و center را در گزینه های نقشه خود مشخص کرده اید.
اطمینان حاصل کنید که یک عنصر div را اعلام کرده اید که در آن نقشه روی صفحه ظاهر می شود.
اطمینان حاصل کنید که عنصر div برای نقشه دارای ارتفاع است. به طور پیش فرض، عناصر div با ارتفاع 0 ایجاد می شوند و بنابراین نامرئی هستند.
از یک اشکال‌زدای جاوا اسکریپت برای کمک به شناسایی مشکلات استفاده کنید، مانند آنچه در ابزارهای برنامه‌نویس Chrome موجود است. با جستجوی خطا در کنسول جاوا اسکریپت شروع کنید.
سوالات را به Stack Overflow ارسال کنید. دستورالعمل‌هایی درباره نحوه ارسال سؤالات عالی در صفحه پشتیبانی موجود است.
تاریخ آخرین به‌روزرسانی 2025-05-09 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-05-09 بهوقت ساعت هماهنگ جهانی."],[[["To use the Google Maps JavaScript API, you must include an API key and enable billing for your project."],["If you see a darkened map or a negative Street View image watermarked with \"for development purposes only\", you might have an issue with your API key or billing."],["Troubleshooting steps involve verifying your API key implementation, checking billing account attachment, ensuring billing method validity, and reviewing daily usage limits and IP restrictions."],["This page offers solutions to common billing and API errors, and links to resources for further assistance."]]],["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"]]
