عیب یابی

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

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

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

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

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

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

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

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

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

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

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

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

کلیدهای 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 به عنوان پارامتر 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 خود جایگزین کنید. 
      <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، روی دکمه زیر کلیک کنید. اگر راه‌اندازی هدایت‌شده را نمی‌بینید، دستورالعمل‌های کامل را در «شروع با پلتفرم Google Maps» دنبال کنید.
شروع کنید

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

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

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

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

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

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

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

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

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

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

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

اگر کد شما کار نمی کند:

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

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