عیب یابی

یادآوری: برای استفاده از Maps JavaScript API:

• همه درخواست‌های Maps JavaScript API باید شامل یک کلید API باشند. ما دیگر از دسترسی بدون کلید پشتیبانی نمی کنیم.
• شما باید صورتحساب هر یک از پروژه های خود را فعال کنید .

کلید 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 خود به درستی استفاده نمی کنید:
• هشدار API جاوا اسکریپت Google Maps: 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>

• ترافیک شبکه ایجاد شده توسط وب سایت خود را در مرورگر بررسی کنید. در کروم، این مورد را می توان با استفاده از تب DevTools Network مشاهده کرد. در اینجا درخواست های شبکه ای را که توسط وب سایت خود ارائه شده است مشاهده خواهید کرد. درخواست‌های ارسال شده با استفاده از Maps JavaScript API در مسیر maps/api/js قرار خواهند گرفت. در اینجا می توانید تأیید کنید که آیا درخواست ها از پارامتر key استفاده می کنند. فیلتر کردن ترافیک شبکه بر اساس maps/api/js هنگام مشاهده برگه Network ممکن است مفید باشد.

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

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

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

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

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

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

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

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

هنگامی که پروژه خود را در Cloud Console پیدا کردید، با رفتن به بخش صورتحساب در منوی سمت چپ، بررسی کنید که آیا یک حساب صورت‌حساب ضمیمه شده است.

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

به صفحه فعال کردن صورتحساب در Cloud Console بروید و یک حساب صورتحساب به پروژه خود اضافه کنید. برای اطلاعات بیشتر، شروع به کار با Google Maps Platform را ببینید.

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

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

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

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

آیا بیش از حد مجاز روزانه در API وجود دارد؟

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

می توانید محدودیت های روزانه خود را با رفتن به داشبورد APIs & Services در Cloud Console بررسی کنید. یک بار آنجا:

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