پیام های خطا، پیام های خطا

با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

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

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

عیب یابی

تحت شرایط خاص، ممکن است یک نقشه تاریک یا تصویر "منفی" نمای خیابان، با متن "فقط برای اهداف توسعه" نشان داده شود. این رفتار معمولاً مشکلات مربوط به کلید API یا صورت‌حساب را نشان می‌دهد. برای استفاده از محصولات Google Maps Platform، صورت‌حساب باید در حساب شما فعال باشد و همه درخواست‌ها باید دارای یک کلید 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 های مجاز مراجعه کنید.

کدهای خطای 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 در برخی مرورگرهای دیگر است.

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

  1. برای باز کردن Developer Tools، نماد منو > More Tools > Developer Tools را انتخاب کنید.
  2. برای باز کردن کنسول جاوا اسکریپت، کلید 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 پشتیبانی می‌شود.

  • اگر از اینترنت اکسپلورر (IE) استفاده می کنید، به آخرین نسخه IE ارتقا دهید. با توجه به پایان پشتیبانی از نسخه های قدیمی IE ، می توانید از هر یک از مرورگرهای جایگزین پشتیبانی شده توسط Maps JavaScript API نیز استفاده کنید.
  • اگر در حال توسعه یک برنامه بومی ویندوز هستید که در نمای وب اجرا می شود، با استفاده از نسخه اینترنت اکسپلورر که توسط Maps JavaScript API پشتیبانی می شود، به احتمال زیاد مرورگر شما در حال بازگشت به حالتی است که به طور پیش فرض از Internet Explorer 7 استفاده می کند. شما می توانید این رفتار پیش فرض را به روش های زیر لغو کنید:
    • با استفاده از هدر متا IE X-UA-Compatible یک حالت سند قدیمی را مشخص کنید (اصلاح توصیه شده).
      <meta http-equiv="x-ua-compatible" content="IE=edge">
    • رجیستری را برای استفاده از کلیدهای رجیستری FEATURE_BROWSER_EMULATION مخصوص برنامه کاربردی به روز کنید.

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

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

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