پرسشگان پلاتفرم Google Maps

شروع به کار

شرایط خدمات را درک کنید

حدود استفاده و صورت‌حساب (سهمیه)

استفاده از «پلاتفرم Google Maps»

خطاها و عیب‌یابی

خدمات پلاتفرم Google Maps

Maps JavaScript API

کیت توسعه نرم‌افزار Google Maps برای iOS

کیت توسعه نرم‌افزار Google Maps برای Android

امضای نشانی وب

شروع به کار

«پلاتفرم Google Maps» چیست؟

«پلاتفرم Google Maps» مجموعه‌ای از میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار است که به توسعه‌دهندگان امکان می‌دهد Google Maps را در برنامه‌های تلفن همراه و صفحه‌های وب جاسازی کنند یا داده‌ها را از Google Maps بازیابی کنند. چندین پیشنهاد ویژه وجود دارد. بسته به نیازهایتان، ممکن است از یک یا ترکیبی از این «میاناهای برنامه‌سازی کاربردی» و «کیت‌های توسعه نرم‌افزار» استفاده کنید:

‫Maps:

مسیرها:

مکان‌ها:

محیط:

چگونه کار با «پلاتفرم Google Maps» را شروع کنم؟

به شروع به کار با پلاتفرم Google Maps مراجعه کنید.

به کدام API نیاز دارم؟

برای دریافت کمک در یافتن «میانای برنامه‌سازی کاربردی» مناسب براساس الزامات عملکردی‌تان، به Capabilities Explorer (کاوشگر قابلیت‌ها) نگاهی بیندازید.

چگونه استفاده از میاناهای برنامه‌سازی کاربردی را در سایتم شروع کنم؟

راهنماهای «نمای کلی»، «توسعه‌دهنده»، و «شروع به کار» را برای میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار خاصی که به آن علاقه دارید ببینید. برای مثال، راهنماهای کیت توسعه نرم‌افزار Maps برای Android یا Maps JavaScript API را بررسی کنید.

«پلاتفرم Google Maps» کدام کشورها را پوشش می‌دهد؟

تیم Google Maps به‌طور مداوم داده‌های نقشه جدید منتشر می‌کند و پوشش بین‌المللی ما را افزایش می‌دهد. برای اطلاع از جدیدترین اطلاعات پوشش، به داده‌های پوشش Google Mapsمراجعه کنید. می‌توانید داده‌ها را با چارگوش فیلتر در بالای صفحه فیلتر کنید. داده‌های پوشش ممکن است درصورت تغییر قراردادهای صدور پروانه با ارائه‌دهندگان داده تغییر کند.

همچنین ببینید:

آیا می‌توانم بدون استفاده از محصولات «پلاتفرم Google Maps»، Google Maps را در سایتم قرار دهم؟

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

چگونه برنامه‌های Maps را در دستگاه‌های همراه ارائه کنم؟

برای گنجاندن نقشه در برنامه Android، از کیت توسعه نرم‌افزار Maps ویژه Android استفاده کنید.

برای گنجاندن نقشه در برنامه iOS، از کیت توسعه نرم‌افزار Google Maps برای iOS استفاده کنید.

میانای برنامه‌سازی کاربردی جاوا اسکریپت Maps برای برآورده کردن نیازهای دستگاه‌های همراه توسعه یافته است و برای برنامه‌های مرورگری که هم رایانه و هم دستگاه‌هایی را که مرورگر وب با پیاده‌سازی کامل جاوا اسکریپت دارند (مثل Apple iPhone) هدف‌یابی می‌کنند مناسب است.

برای برنامه‌هایی که دستگاه‌های نامناسب برای استفاده از Maps JavaScript API را هدف‌یابی می‌کنند، Maps Static API تصاویر نقشه را در قالب‌های GIF،‏ JPG، و PNG، ازجمله نشانگرها و چندخطی‌ها ارائه می‌دهد. توجه داشته باشید که استفاده از Maps Static API خارج از برنامه‌های مبتنی بر مرورگر نیازمند این است که تصویر نقشه به Google Maps پیوند داده شود.

‫Maps JavaScript API و Maps Embed API از کدام مرورگرهای وب پشتیبانی می‌کنند؟

‫Maps JavaScript API و Maps Embed API از مرورگرهای وب زیر پشتیبانی می‌کنند:

رایانه
  • نسخه کنونی Microsoft Edge (‏Windows)، به‌جز حالت IE.
  • دو نسخه پایدار اصلی آخر Firefox (‏Windows،‏ macOS،‏ Linux).
  • دو نسخه اصلی پایدار آخر Chrome (‏Windows،‏ macOS،‏ Linux).
  • دو نسخه پایدار اصلی آخر Safari (‏macOS).
Android
  • نسخه کنونی Chrome در Android 4.1 و نسخه‌های بالاتر.
  • ‫Chrome WebView در Android نسخه ۴.۴ و بالاتر.
iOS
  • ‫Safari تلفن همراه در نسخه‌های اصلی فعلی و قبلی iOS.
  • ‫UIWebView و WKWebView در نسخه‌های اصلی کنونی و قبلی iOS.
  • نسخه فعلی Chrome برای iOS.
آیا می‌توانم نقشه‌ها را از Maps JavaScript API چاپ کنم؟

چاپ کردن از «میانای برنامه‌سازی کاربردی جاوا اسکریپت Maps» پشتیبانی نمی‌شود. دلیل آن این است که پشتیبانی از چاپ در مرورگرهای پرکاربرد یکسان نیست.

چگونه می‌توانم وقتی تغییراتی در محصولات «پلاتفرم Google Maps» ایجاد می‌شود مطلع شوم؟

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

چگونه با پشتیبانی فنی تماس بگیرم؟

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

پشتیبانی فنی چه زمانی دردسترس است؟
تیم پشتیبانی به‌جز تعطیلات منطقه‌ای برای مشکلات «سرویس غیرقابل استفاده» به‌صورت ۲۴×۵ (روزهای هفته از دوشنبه ۹ صبح به‌وقت توکیو تا جمعه ۵ بعدازظهر به‌وقت اقیانوس آرام) دردسترس است.
چگونه می‌توانم دسترسی به «حساب Google» خود را بازیابی کنم؟

اگر دسترسی به «حساب Google» خود را ازدست داده‌اید (برای نمونه joe@mycompany.com یا joe@gmail.com)، می‌توانید با بازیابی یا بازنشانی گذرواژه، دسترسی به حساب را بازیابی کنید. به مقاله نحوه بازیابی «حساب Google» یا Gmail در «راهنمای حساب Google» مراجعه کنید.

چگونه می‌توانم دسترسی به یک پروژه خاص را بازیابی کنم؟

اگر دسترسی به پروژه‌ای را که در آن پیاده‌سازی Google Maps Platform را مدیریت می‌کنید ازدست دادید، می‌توانید آن را بازیابی کنید.

اگر به «حساب Google» مرتبط با پروژه خود دسترسی دارید:

اگر به «حساب Google» منسوب به پروژه خود دسترسی ندارید:

آیا می‌توانم از «کیت توسعه نرم‌افزار Maps و مکان‌ها برای iOS» در رایانه‌های Mac مبتنی بر Arm استفاده کنم؟

توسعه در Macهای جدید مبتنی بر Arm امکان‌پذیر است، اما این کار مستلزم ساختن و اجرا کردن در دستگاه iOS فیزیکی است. این محدودیت موقتی است و درحال بررسی افزودن پشتیبانی بیشتر برای توسعه در شبیه‌سازها هستیم.

شرایط خدمات را درک کنید

شرایط خدمات محصولات «پلاتفرم Google Maps» چیست؟

«شرایط خدمات پلاتفرم Google Maps» در اینجا دردسترس است:

https://cloud.google.com/maps-platform/terms

آیا سایت من «شرایط خدمات پلاتفرم Google Maps» را برآورده می‌کند؟

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

بااین‌حال، برخی‌از موارد استفاده از «پلاتفرم Google Maps» وجود دارد که ما نمی‌خواهیم آن‌ها را ببینیم. برای مثال، نقشه‌هایی که مکان‌های خرید داروهای غیرقانونی در یک شهر یا هر فعالیت غیرقانونی دیگری را مشخص می‌کنند. ما همچنین به حریم خصوصی افراد احترام می‌گذاریم، بنابراین نباید از «پلاتفرم Google Maps» برای شناسایی اطلاعات خصوصی درباره افراد استفاده شود.

قبل‌از توسعه و راه‌اندازی برنامه‌تان، باید با مشاور خود مشورت کنید تا مطمئن شوید برنامه‌تان با شرایط خدمات پلاتفرم Google Maps مطابقت دارد. مهندسان Google فقط می‌توانند کمک فنی ارائه دهند و صلاحیت ارائه مشاوره حقوقی را ندارند. ‫Google این حق را برای خود محفوظ می‌دارد که استفاده شما از سرویس را در هر زمانی تعلیق یا فسخ کند، بنابراین شرایط Maps APIs را به‌دقت بخوانید.

آیا می‌توانم مستقیماً به کاشی‌های نقشه و تصاویر ماهواره‌ای دسترسی داشته باشم؟

شما نمی‌توانید ازطریق هیچ سازوکاری به‌جز «پلاتفرم Google Maps» (مانند ایجاد API نقشه‌برداری خودتان یا استفاده از اسکریپت بارگیری انبوه کاشی) به کاشی‌های نقشه یا تصاویر ماهواره‌ای دسترسی داشته باشید. اگر برنامه شما خارج از «پلاتفرم Google Maps» به کاشی‌ها دسترسی پیدا کند، دسترسی آن به کاشی‌ها مسدود خواهد شد. برای جزئیات بیشتر، شرایط خدمات پلاتفرم Google Maps را ببینید.

آیا می‌توانم از محصولات «پلاتفرم Google Maps» برای پیگیری برنامه‌ها استفاده کنم؟

هیچ محدودیتی برای نمایش داده‌های هم‌زمان (ردیابی) با محصولات «پلاتفرم Google Maps» وجود ندارد، به‌شرطی که برنامه از «شرایط خدمات پلاتفرم Google Maps» پیروی کند.

آیا می‌توانم از Google Maps در برنامه غیروب خود استفاده کنم؟

بله، اکنون می‌توان از محصولات «پلاتفرم Google Maps» در برنامه‌های غیروب استفاده کرد، به‌شرطی که از دیگر محدودیت‌های «شرایط خدمات پلاتفرم Google Maps» پیروی کنند.

«میانای برنامه‌سازی کاربردی جاوا اسکریپت Maps» فقط زمانی پشتیبانی می‌شود که در یکی از مرورگرهای پشتیبانی‌شده اجرا شود.

آیا می‌توانم از محصولات «پلاتفرم Google Maps» در سایتی که با گذرواژه محافظت می‌شود استفاده کنم؟

بله، می‌توان از سرویس‌های Google Maps، «مسیرها»، «مکان‌ها»، و «محیط زیست» با برنامه‌های دارای دسترسی خصوصی استفاده کرد. برای جزئیات بیشتر، شرایط خدمات پلاتفرم Google Maps را ببینید.

آیا می‌توانم برنامه‌ای بسازم که داده‌های «پلاتفرم Google Maps» را در سندی بگنجاند؟

اگر برنامه‌تان سندی را تولید می‌کند، چه به‌صورت الکترونیکی و چه به‌صورت چاپی، هیچ داده‌ای از Google Maps Platform، ازجمله تصاویر، نباید در سند گنجانده شود. برای جزئیات بیشتر، بخش شرایط خدمات پلاتفرم Google Maps «بدون خراشیدن» را ببینید.

چگونه می‌توانم از گنجاندن محتوایم در نتایج «جستجوی Google» انصراف دهم؟

دیگر این داده‌ها را جمع‌آوری نمی‌کنیم. استفاده از پارامتر indexing منسوخ شده است و تأثیری ندارد. دیگر لازم نیست به‌طور صریح انصراف دهید، اما توصیه می‌کنیم این پارامتر را در اولین فرصت مناسب حذف کنید.

برای برداشتن صفحه یا سایتتان از نتایج جستجو، دستورالعمل‌های ارائه‌شده در مرکز راهنمایی ما را دنبال کنید.

آیا می‌توانم بااستفاده از Maps Static API تصویر نقشه تولید کنم و آن را در وب‌سایتم ذخیره و ارائه کنم؟

نمی‌توانید نسخه‌های تصاویر تولیدشده بااستفاده از Maps Static API را در وب‌سایتتان ذخیره و ارائه کنید. همه صفحه‌های وبی که به تصاویر ثابت نیاز دارند باید ویژگی src برچسب HTML img یا ویژگی CSS background-image برچسب HTML div را مستقیماً به Maps Static API پیوند دهند تا همه تصاویر نقشه در محتوای HTML صفحه وب نمایش داده شوند و مستقیماً توسط Google به کاربران نهایی ارائه شوند.

حدود استفاده و صورت‌حساب

چگونه صورت‌حساب را برای پروژه‌ام راه‌اندازی کنم؟
شروع به کار با پلاتفرم Google Maps را ببینید.
«دوره آزمایشی رایگان Google Cloud» چیست و کاربران «دوره آزمایشی رایگان» چگونه به حساب پولی ارتقا می‌دهند؟

«دوره آزمایشی رایگان Google Cloud» برنامه‌ای ۹۱ روزه است که به کاربران جدید امکان می‌دهد بدون هیچ تعهد مالی، محبوب‌ترین محصولات Google Cloud، ازجمله میاناهای برنامه‌سازی کاربردی Google Maps Platform (GMP) را امتحان کنند. ثبت‌نام برای «دوره آزمایشی رایگان» حساب صورت‌حساب «دوره آزمایشی رایگان» ایجاد می‌کند که ازقبل با ۳۰۰ دلار اعتبار رایگان «خوشامدگویی» بارگذاری شده است و می‌توانید آن را در GMP خرج کنید.

اگر قبل‌از گذشت ۹۱ روز به «حساب صورت‌حساب پولی» ارتقا ندهید یا اگر ۳۰۰ دلار اعتبار رایگان را خرج کنید، حساب صورت‌حساب «دوره آزمایشی رایگان» شما بسته خواهد شد و همه پروژه‌ها و منابع مرتبط با آن متوقف خواهد شد. برای حفظ منابعی که درطول «دوره آزمایشی رایگان» ایجاد می‌کنید و ادامه کار بدون وقفه سرویس‌هایتان، به «حساب صورت‌حساب پولی» ارتقا دهید. درباره دوره آزمایشی رایگان بیشتر بخوانید.

آیا «پلاتفرم Google Maps» حد استفاده (سهمیه) دارد؟

هیچ محدودیت حداکثر روزانه‌ای برای تعداد درخواست‌هایی که می‌توانید به محصولات «پلاتفرم Google Maps» ارسال کنید وجود ندارد و تنها محدودیت‌های استفاده مربوط به حداکثر تعداد پُرسمان در دقیقه (QPM) است.

جدول زیر حد استفاده برای هر API را نشان می‌دهد. می‌توانید محدودیت‌های سهمیه را در Cloud Console مشاهده و اصلاح کنید.

میانای برنامه‌سازی کاربردی حد استفاده
اعتبارسنجی نشانی ۶٬۰۰۰ کیوپیم
نمای هوایی: ویدیو جستجو ‫۱۸۰ پرسش در دقیقه و ۱۰۰٬۰۰۰ پرسش در روز
نمای هوایی: پرداز زدن ویدیو ‫۱۰۰ QPM و ۱۰۰ QPD
کیفیت هوا ۶٬۰۰۰ کیوپیم
Maps JavaScript API: نقشه‌های سه‌بعدی ‫۳۰٬۰۰۰ کیوپی‌ام
Maps JavaScript API: نقشه‌های پویا ۳۰۰۰۰
ارتفاع ۶٬۰۰۰ کیوپیم
زمین‌کدیابی ۳٬۰۰۰ کیوپیم
موقعیت جغرافیایی ۶٬۰۰۰ کیوپیم
Maps Grounding Lite: جستجوی مکان‌ها، جستجوی آب‌وهوا، محاسبه مسیرها ‫۳۰۰ پرسش در دقیقه برای هر ابزار
مبانی‌مندی با پلاتفرم Google Maps Lite: حل کردن نام‌ها، حل کردن نشانی‌های وب Maps ‫۶۰۰ پرسش‌دردقیقه برای هر روش
Map Tiles API: کاشی‌های نقشه دوبُعدی ۶٬۰۰۰ QPM و ۱۵٬۰۰۰ QPD
Map Tiles API: کاشی‌های «نمای خیابان» ۶٬۰۰۰ QPM و ۱۵٬۰۰۰ QPD
Map Tiles API: کاشی‌های سه‌بعدی واقع‌نما ‫۱۲٬۰۰۰ پرسش در دقیقه و ۱۰٬۰۰۰ درخواست ریشه در روز.
پیمایش: تنظیم درخواست‌های مقصد ‫۳۰٬۰۰۰ کیوپی‌ام
مکان‌ها ۶٬۰۰۰ کیوپیم
Places Aggregate ‫۱٬۲۰۰ QPM
گرده ۶٬۰۰۰ پرسش در دقیقه
جاده‌ها ‫۳۰٬۰۰۰ کیوپی‌ام
مسیرها: محاسبه مسیرها ۳٬۰۰۰ کیوپیم
مسیرها: محاسبه ماتریس مسیر ‫۳٬۰۰۰ EPM
خورشیدی ‫۶۰۰ QPM
نقشه‌های ایستا ‫۳۰٬۰۰۰ کیوپی‌ام
Street View Image API ‫۳۰٬۰۰۰ کیوپی‌ام
منطقه زمانی ‫۳۰٬۰۰۰ کیوپی‌ام
آب‌وهوا ۶٬۰۰۰ کیوپیم

برای کنترل هزینه‌ها، می‌توانید استفاده از API را پایش کنید و برای همه درخواست‌های ارسال‌شده به هر API صورت‌حساب‌دار محدودیت‌های روزانه تنظیم کنید.

محصولات «پلاتفرم Google Maps» باید مطابق با شرایط خدمات پلاتفرم Google Maps استاندارد مستقر شوند.

هزینه مصرف چگونه محاسبه می‌شود؟

برای نمای کلی قیمت‌گذاری محصولات «پلاتفرم Google Maps»، به فهرست قیمت‌گذاری مراجعه کنید.

برای کسب اطلاعات بیشتر درباره نحوه صدور صورت‌حساب «میاناهای برنامه‌سازی کاربردی پلاتفرم Google Maps»، به نمای کلی قیمت‌گذاری و صورت‌حساب پلاتفرم Google Maps مراجعه کنید.

بار کردن نقشه در Google Maps Platform چگونه شمارش می‌شود؟

وقتی هریک از موارد زیر رخ دهد، هزینه یک بار بار کردن نقشه کسر می‌شود:

  • صفحه وب یا برنامه‌ای بااستفاده از Maps JavaScript API نقشه را نمایش می‌دهد.
  • برنامه‌ای تصویر نقشه‌ای واحد را از Maps Static API درخواست می‌کند.

هزینه تمام‌نماهای «نمای خیابان» جدا از بار کردن نقشه محاسبه می‌شود:

  • برای هر درخواست به Street View Static API برای جاسازی یک پانورامای ثابت (غیرتعاملی) «نمای خیابان»، هزینه پانورامای ثابت «نمای خیابان» دریافت می‌شود.
  • برای هر نمونه‌سازی از شیء تمام‌نما در Maps JavaScript API،‏ Maps SDK for Android، یا Maps SDK for iOS، هزینه تمام‌نمای پویای «نمای خیابان» کسر می‌شود.

پس‌از اینکه صفحه وب یا برنامه‌ای نقشه، یا تصویر نقشه ایستا، یا پانورامای «نمای خیابان» را بارگیری کرد، هرگونه تعامل کاربر با آن، مانند حرکت دادن، بزرگ‌نمایی، یا عوض کردن لایه‌های نقشه، باعث تولید بارگیری‌های اضافی نقشه نمی‌شود یا بر محدودیت‌های استفاده تأثیر نمی‌گذارد.

افزودن نشانگر باعث تولید بار نقشه اضافی نمی‌شود، اما ممکن است هزینه‌هایی درخصوص نحوه تعیین مکان سنجاقک ایجاد کند (مثل بار کردن یا بار کردن مجدد کلاس google.maps.Map()).

چگونه بر مصرف خودم نظارت کنم؟

می‌توانید استفاده از هر API را در کنسول Google Cloud پایش کنید.

  1. پروژه‌ای را که حاوی «میانای برنامه‌سازی کاربردی» موردنظر برای مرور است انتخاب کنید.
  2. از فهرست «میاناهای برنامه‌سازی کاربردی» در «داشبورد»، روی نام میانای برنامه‌سازی کاربردی کلیک کنید.
  3. در نزدیکی بالای صفحه، روی سنجه‌ها یا سهمیه‌ها کلیک کنید.

برای دیدن گزارش ترافیک و اطلاعات صورت‌حساب برای کل پروژه، این مراحل را دنبال کنید:

  1. اگر قبلاً این کار را انجام نداده‌اید، صورت‌حساب را راه‌اندازی کنید.
  2. به صفحه صورت‌حساب در «کنسول Cloud» بروید.
  3. پروژه‌ای را انتخاب کنید.
  4. در نوار کناری سمت راست، روی گزارش‌ها کلیک کنید. از فیلترهای موجود در نوار کناری سمت راست برای مشاهده گزارش‌های حساب صورت‌حساب خود استفاده کنید.

برای کسب اطلاعات بیشتر، گزارش‌دهی پلاتفرم Google Maps و همچنین پایش پلاتفرم Google Maps و تنظیم حد سهمیه را ببینید.

اگر از محدودیت‌های نرخ درخواست (QPM) فراتر بروم چه اتفاقی می‌افتد؟

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

اگر از محدودیت‌های QPM درخواست فراتر بروید یا به هر نحوی از سرویس سوءاستفاده کنید، درخواست‌ها پیام خطای خاصی برمی‌گردانند. اگر همچنان از محدودیت‌ها فراتر بروید، ممکن است دسترسی شما به «پلاتفرم Google Maps» مسدود شود.

توجه: میاناهای برنامه‌سازی کاربردی سرویس وب زیر دارای سرویس سمت مشتری معادل در Maps JavaScript API هستند: بلندی، مکان‌رمزگذاری.

از حد استفاده فراتر رفته‌اید

اگر از حد مجاز استفاده فراتر بروید، OVER_QUERY_LIMITکد وضعیت به‌عنوان پاسخ دریافت می‌کنید.

این پیام به این معنی است که سرویس وب از ارائه پاسخ‌های عادی متوقف شده است و تا زمانی که استفاده بیشتر مجاز شود، فقط کد وضعیت OVER_QUERY_LIMIT را برمی‌گرداند. اگر خطا به‌دلیل ارسال درخواست‌های بیش‌ازحد در دقیقه توسط برنامه شما دریافت شده باشد، این سناریو می‌تواند در چند ثانیه اتفاق بیفتد.

اگر به‌طور منظم از حدود استفاده QPM خود فراتر می‌روید، با بهینه‌سازی برنامه‌ها برای استفاده کارآمدتر از محصولات Google Maps Platform، استفاده را کاهش دهید یا درخواست کنید سهمیه شما افزایش یابد. برای اطلاعات بیشتر، راهنمای بهینه‌سازی را ببینید.

سایت من ترافیک زیادی دارد. آیا می‌توانم از محصولات «پلاتفرم Google Maps» استفاده کنم؟

بله. بااین‌حال توصیه می‌کنیم با حدود استفاده برای هریک از «پلاتفرم Google Maps» که برنامه شما به آن متکی است آشنا شوید.

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

مصرف چگونه محاسبه و صورت‌حساب می‌شود؟

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

هزینه استفاده از «پلاتفرم Google Maps» چقدر است؟

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

آیا قیمت‌گذاری به ارزهای دیگر دردسترس است؟

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

صورت‌حساب را راه‌اندازی کرده‌ام. چگونه قبض خود را مشاهده کنم؟

‫Google در ابتدای هر ماه هزینه فعالیت ماه قبل را بااستفاده از روش پرداخت مشخص‌شده از شما کسر می‌کند. برای جزئیات صورت‌حساب خود، به صورت‌حساب پلاتفرم Google Maps مراجعه کنید.

منابع تکمیلی:

اگر استفاده‌ام به‌طور غیرمنتظره افزایش یابد، چگونه از صورت‌حساب سنگین جلوگیری کنم؟

«پلاتفرم Google Maps» روش‌هایی برای تنظیم محدودیت‌های درخواست روزانه و تنظیم محدودیت‌های قابل‌پرداخت روزانه ارائه می‌دهد. می‌توانید حداکثر حد روزانه استفاده را برای محافظت دربرابر افزایش‌های غیرمنتظره تعیین کنید. همچنین می‌توانید هشدارهای بودجه را تنظیم کنید تا وقتی هزینه‌های حساب صورت‌حساب به آستانه‌ای که تنظیم کرده‌اید رسید، اعلان‌های ایمیلی دریافت کنید.

تعیین سقف برای حداکثر حد صورت‌حساب روزانه:

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

تنظیم و مدیریت هشدارهای بودجه:

هشدارهای بودجه راه‌اندازی کنید تا وقتی هزینه‌های حساب صورت‌حساب به آستانه‌ای که تنظیم کرده‌اید رسید، اعلان‌های ایمیلی به سرپرستان صورت‌حساب ارسال شود. وقتی هزینه‌های تخمینی در حساب صورت‌حساب از ۵۰٪، ۹۰٪، و ۱۰۰٪ آستانه فراتر رود، اعلان‌های ایمیلی برای سرپرستان صورت‌حساب ارسال می‌شود.

پیامی دریافت کردم که می‌گوید پروژه من به «حساب انتقال Google Maps Platform» پیوند داده شده است، اما به آن حساب دسترسی ندارم. چه کار باید انجام دهم؟

«حساب انتقال پلاتفرم Google Maps» برای کمک به برخی‌از مشتریان برای انتقال به طرح قیمت‌گذاری پرداخت به‌ازای مصرف ایجاد شده است. این حساب انتقال به Google امکان داد به این مشتریان اعتبار یک‌باره‌ای ارائه دهد تا بتوانند تا سقف سطح بدون هزینه به استفاده از «پلاتفرم Google Maps» ادامه دهند. پس‌از فراتر رفتن از این حد، حساب صورت‌حساب بسته خواهد شد و دسترسی به سرویس را ازدست خواهید داد. برای جلوگیری از اختلال در سرویس، از شما می‌خواهیم حساب صورت‌حساب خودتان را تنظیم کنید و همچنان از سقف مصرف رایگان ماهانه لذت ببرید. برای تغییر حساب صورت‌حساب برای پروژه:

  1. ایجاد حساب صورت‌حساب جدید (اگر ازقبل حساب صورت‌حساب دارید، می‌توانید از این مرحله رد شوید).
  2. حساب صورت‌حساب را با پروژه خود منسوب کنید.
چرا حد مجاز سهمیه من روی ۱ درخواست در روز تنظیم شده است؟ چگونه می‌توانم این حد را افزایش دهم؟

اگر حساب صورت‌حسابی برای پروژه‌تان ایجاد و پیوست نکرده باشید، «میاناهای برنامه‌سازی کاربردی پلاتفرم Maps» شما به ۱ درخواست در روز محدود خواهد شد. با ایجاد و پیوست کردن حساب صورت‌حساب می‌توانید سهمیه بالاتری دریافت کنید. برای انجام این کار، شروع به کار با پلاتفرم Google Maps را ببینید.

پس‌از ایجاد و پیوست کردن حساب صورت‌حساب، حد سهمیه روزانه شما برداشته خواهد شد. می‌توانید تصمیم بگیرید که در «کنسول Cloud» حدی برای جلوگیری از هزینه‌های غیرمنتظره تعیین کنید.

اعلان نقض صورت‌حساب دریافت کردم. چگونه این مشکل را حل کنم؟

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

استفاده از «پلاتفرم Google Maps»

برای محصولات مختلف Maps از کدام کلیدها یا اطلاعات اعتباری باید استفاده کنم؟

هر بار که از محصولات «پلاتفرم Google Maps» استفاده می‌کنید، باید کلید API را برای اعتبارسنجی درخواستتان اضافه کنید. «پلاتفرم Google Maps» برای برنامه‌های Android،‏ iOS، یا وب، و برای سرویس‌های وب HTTP دردسترس است.

کلید میانای برنامه‌سازی کاربردی:

  • کلید API یک شناسه یکتا است که شما بااستفاده از کنسول Cloud تولید می‌کنید.
  • نمونه بار کردن API با کلید: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

امضای دیجیتال:

  • امضای دیجیتال بااستفاده از رمز امضای نشانی وب که Google به شما ارائه کرده است تولید می‌شود. امضاهای دیجیتال با Maps Static API و Street View Static API استفاده می‌شوند.

محدودیت‌ها:

جدول زیر محدودیت‌های کلید/اطلاعات اعتباری و برنامه را برای هریک از «میاناهای برنامه‌سازی کاربردی/کیت‌های توسعه نرم‌افزار Google Maps Platform» نشان می‌دهد.

API/SDK محدودیت برنامه و اطلاعات اعتباری
کیت توسعه نرم‌افزار Maps برای Android کلید API با محدودیت Android۱
کیت توسعه نرم‌افزار مکان‌ها، ویژه Android کلید API با محدودیت Android۱
کیت توسعه نرم‌افزار پیمایش برای Android کلید API با محدودیت Android۱
کیت توسعه نرم‌افزار Maps برای iOS کلید میانای برنامه‌سازی کاربردی با محدودیت iOS۱
کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS کلید میانای برنامه‌سازی کاربردی با محدودیت iOS۱
کیت توسعه نرم‌افزار پیمایش برای iOS کلید میانای برنامه‌سازی کاربردی با محدودیت iOS۱
Maps JavaScript API کلید API با محدودیت ارجاع‌دهنده HTTP۱
Map Tiles API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Maps Datasets API کد OAuth
Aerial View API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Maps Static API کلید API با محدودیت ارجاع‌دهنده HTTP۱ + امضای دیجیتال۲
Street View Static API کلید API با محدودیت ارجاع‌دهنده HTTP۱ + امضای دیجیتال۲
Maps Embed API کلید API با محدودیت ارجاع‌دهنده HTTP۱
Address Validation API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Elevation API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Geocoding API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Geolocation API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Places API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Places Aggregate API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Roads API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
میانای برنامه‌سازی کاربردی مسیرها کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Time Zone API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Air Quality API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Pollen API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Solar API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Weather API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
۱ محدودیت‌های کلید API اختیاری هستند، اما اکیداً توصیه می‌کنیم برای امنیت بیشتر، همه کلیدهای API را محدود کنید.
۲ بسته به استفاده، ممکن است برای Maps Static API و Street View Static API امضای دیجیتال لازم باشد. صرف‌نظر از میزان استفاده، اکیداً توصیه می‌کنیم برای اصالت‌سنجی درخواست‌هایتان از هم کلید API و هم امضای دیجیتال استفاده کنید.
چگونه نوع محدودیت کلید خود را از یک ارجاع‌دهنده HTTP به محدودیت نشانی IP تغییر دهم؟

مهم: اگر از هریک از میاناهای برنامه‌سازی کاربردی سرویس وب با کلید API که محدودیت‌های ارجاع‌دهنده دارد استفاده می‌کنید، درخواست‌هایتان با پیام خطای «کلیدهای API هنگام استفاده با این میانای برنامه‌سازی کاربردی نمی‌توانند محدودیت‌های ارجاع‌دهنده داشته باشند» ناموفق خواهد بود. باید به استفاده از کلید API با محدودیت‌های نشانی IP تغییر دهید.

قبل‌از اینکه نوع محدودیت کلید میانای برنامه‌سازی کاربردی را از «ارجاع‌دهنده HTTP» به «نشانی IP» تغییر دهید، مطمئن شوید که همه میاناهای برنامه‌سازی کاربردی که از کلید میانای برنامه‌سازی کاربردی استفاده می‌کنند از نوع محدودیت «نشانی IP» پشتیبانی می‌کنند. میاناهای برنامه‌سازی کاربردی از نوع محدودیت یکسان می‌توانند از کلید محدودشده یکسان استفاده کنند. اگر نیاز دارید بیش‌از یک محدودیت را اعمال کنید، کلید جداگانه‌ای با محدودیت موردنیاز اضافه کنید. ببینید چگونه کلید API جدید اضافه کنید.

درباره محدودیت‌های کلید API مرتبط با محصولات «پلاتفرم Google Maps» بیشتر بدانید.

برای تبدیل کلید میانای برنامه‌سازی کاربردی با محدودیت ارجاع‌دهنده HTTP به محدودیت نشانی IP، کارهای زیر را انجام دهید:

  1. به صفحه اطلاعات اعتباری در کنسول Cloud بروید.
  2. پروژه‌ای را که حاوی کلید API موردنظر برای ویرایش است انتخاب کنید.
  3. در صفحه اطلاعات اعتباری، از فهرست کلیدهای API، نام کلید API را برای ویرایش جزئیات کلید انتخاب کنید.
  4. در بخش محدودیت کلید صفحه، «نشانی‌های IP (سرورهای وب، کارهای cron، و غیره)» را انتخاب کنید و نشانی‌های IP سرور مناسب را درج کنید، سپس روی «ذخیره» کلیک کنید.
چگونه کلید API جدید دریافت کنم؟
شروع به کار با پلاتفرم Google Maps را ببینید.
چگونه می‌توانم تغییرات معرفی‌شده در هر نسخه از میاناهای برنامه‌سازی کاربردی Google Maps را پیدا کنم؟

اطلاعات تغییر نسخه برای بسیاری از «میاناهای برنامه‌سازی کاربردی Maps» در پیوندهای زیر دردسترس است:

همچنین می‌توانید بااستفاده از «پیگیری‌کننده مشکلات پلاتفرم Google Maps» در این نشانی بررسی کنید که اشکال خاصی در کدام نسخه از «پلاتفرم Google Maps» معرفی و برطرف شده است:

https://issuetracker.google.com/bookmark-groups/76561

چگونه می‌توانم پس‌از بار شدن صفحه، میانای برنامه‌سازی کاربردی را به‌صورت ناهم‌زمان در صفحه بار کنم؟

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

چگونه می‌توانم محصولات «پلاتفرم Google Maps» را به زبانی غیراز انگلیسی نمایش دهم؟

به‌طور پیش‌فرض، میانای برنامه‌سازی کاربردی تلاش می‌کند مناسب‌ترین زبان را براساس مکان کاربر یا تنظیمات مرورگر بار کند. برخی‌از APIها به شما امکان می‌دهند هنگام درخواست، زبان را به‌طور صریح تنظیم کنید. اطلاعات بیشتر درباره نحوه تنظیم زبان در مستندات هر API دردسترس است:

زبان‌های پشتیبانی‌شده:

Google اغلب زبان‌های پشتیبانی‌شده را به‌روز می‌کند. این فهرست ممکن است جامع نباشد و مشمول تغییر است.

کد زبان زبان کد زبان زبان
af آفریکانس ja ژاپنی
sq آلبانیایی kn کنادا
am آمهاریک kk قزاقی
ar عربی km خمر
hy ارمنی ko کره‌ای
az آذربایجانی ky قرقیزی
eu باسک lo لائوسی
be Belarusian lv لتونیایی
bn بنگالی lt لیتوانیایی
bs بوسنیایی mk مقدونی
bg بلغاری ms مالایی
my برمه‌ای ml مالایالام
ca کاتالان mr ماراتی
zh چینی mn مغولی
zh-CN ‫چینی (ساده)‏ ne نپالی
zh-HK چینی (هنگ کنگ) no نروژی
zh-TW چینی (سنتی) pl لهستانی
ساعت کرواتی pt پرتغالی
cs چک pt-BR پرتغالی (برزیل)
da دانمارکی pt-PT پرتغالی (پرتغال)
nl هلندی pa پنجابی
fa انگلیسی ro رومانیایی
en-AU انگلیسی (استرالیایی) ru روسی
en-GB انگلیسی (پادشاهی متحد) sr صربی (سیریلیک)
et استونیایی sr-Latn صربی (الفبای لاتین)
fa فارسی si سینهالی
fi فنلاندی sk اسلوواک
fil فیلیپینی sl Slovenian
fr فرانسوی es اسپانیایی
fr-CA فرانسوی (کانادا) es-419 اسپانیایی (امریکای لاتین)
gl گالیسی sw سواحیلی
ka گرجستانی sv سوئدی
de آلمانی ta تامیل
el یونانی te تلوگو
gu گجراتی th تایلندی
iw عبری tr ترکی
hi هندی uk اوکراینی
hu مجارستانی ur اردو
is ایسلندی uz ازبکی
id اندونزیایی vi ویتنامی
it ایتالیایی zu زولو

در این برنامه نمونه می‌توانید ببینید نقشه به هریک از زبان‌های فهرست‌شده در بالا چگونه خواهد بود.

آیا می‌توان ازطریق HTTPS (امنیت لایه انتقال) به «پلاتفرم Google Maps» دسترسی داشت؟

همه «پلاتفرم Google Maps» می‌توانند و باید ازطریق HTTPS قابل‌دسترسی باشند. برای اینکه برنامه‌هایتان در آینده نیز کار کنند، اکیداً توصیه می‌کنیم که از TLS 1.3 برای HTTPS استفاده کنید. اگرچه نسخه‌های قدیمی‌تر «امنیت لایه انتقال» همچنان پشتیبانی می‌شوند، توصیه می‌کنیم به نسخه‌های قدیمی منسوخ‌شده «امنیت لایه انتقال» ۱.۰ و ۱.۱ تکیه نکنید.

پروتکل منسوخ‌شده SSL دیگر پشتیبانی نمی‌شود.

برای اطلاعات بیشتر، پرسشگان انتقال «مرجع صدور گواهینامه ریشه پلاتفرم Google Maps» و پرسشگان «خدمات اطمینان Google» را ببینید.

چگونه می‌توانم اشکال را گزارش کنم یا ویژگی جدیدی را در «پلاتفرم Google Maps» درخواست کنم؟

اگر با رفتاری مواجه شدید که فکر می‌کنید ممکن است اشکال باشد، ابتدا آن را در انجمن مربوطه مطرح کنید. این کار به توسعه‌دهندگان دیگر امکان می‌دهد اشکال را درستی‌سنجی کنند و مشکلات احتمالی کد شما را برطرف کنند.

برای درخواست ویژگی، ابتدا آن را در انجمن مربوطه مطرح کنید تا مطمئن شوید که راه‌حلی که نیازهای شما را برآورده کند، ازقبل دردسترس نیست.

پس‌از اینکه مطمئن شدید اشکال جدیدی را شناسایی کرده‌اید یا اینکه عملکرد موجود محصولات Google Maps Platform نمی‌تواند نیازهای شما را برآورده کند، اشکال یا درخواست ویژگی خود را بااستفاده از Google Maps Platform Issue Tracker گزارش کنید.

پیش‌از افزودن اشکال یا درخواست ویژگی به «پیگیری اشکال»، حتماً بررسی کنید که اشکال یا ویژگی موردنظر قبلاً اضافه نشده باشد. اگر این‌طور است، می‌توانید مشکل را ستاره‌دار کنید تا علاقه خود را ثبت کنید و از به‌روزرسانی‌ها مطلع شوید.

میاناهای برنامه‌سازی کاربردی «پلاتفرم Google Maps» چگونه از کوکی‌های سایت استفاده می‌کنند؟

«کیت توسعه نرم‌افزار Maps ویژه Android» و «کیت توسعه نرم‌افزار Maps ویژه iOS» از کوکی‌ها تحت شرایط خط‌مشی رازداری Google استفاده می‌کنند، مثلاً برای محاسبه کاربران فعال روزانه و ۷ روزه و جلوگیری از سوءاستفاده از سرویس. این کوکی‌ها با هیچ «حساب Google» واردشده به سیستم مرتبط نیستند و همراه با بقیه اطلاعات جمع‌آوری‌شده از فراخوانی‌های API ثبت نمی‌شوند.

نمی‌توانم پاسخ سؤالم را پیدا کنم. با چه کسی باید تماس بگیرم؟

تیم «روابط توسعه‌دهندگان Google» در Stack Overflow حضور دارد — سایت پرسش و پاسخ با ویرایش مشارکتی برای برنامه‌نویسان. این مکان جای بسیار خوبی برای پرسیدن سؤالات فنی درباره توسعه و نگهداری برنامه‌های Google Maps است. اطلاعات بیشتر درباره پرسیدن سؤال در Stack Overflow در صفحه پشتیبانی دردسترس است.

برای دریافت بهترین نتایج هنگام درخواست کمک، موارد زیر را درنظر داشته باشید:

  • در گفتگوهای فعلی جستجو کنید. احتمالاً فرد دیگری با مشکل مشابهی مواجه شده و راه حلی برای آن پیدا کرده است.
  • درصورت امکان، پیوندی به سایتتان ارسال کنید. فقط اگر کد به‌صورت آنلاین قابل‌مشاهده نیست، تکه‌کد پست کنید.
  • همه اطلاعات مربوطه ازجمله نسخه‌های مرورگر، خطاها، و همه حقایق دیگری را که ممکن است در عیب‌یابی این مشکل مفید باشد ارائه دهید.

خطاها و عیب‌یابی

این خطا به چه معنا است؟

اگر هنگام بار کردن یا اجرای Google Maps APIs با خطا مواجه شدید، برای یافتن توضیحات کدهای خطا، پیوندهای زیر را ببینید:

نقشه‌های من تیره‌تر از حد معمول نمایش داده می‌شود. چه اتفاقی افتاده؟

تحت شرایط خاصی، نقشه تیره یا تصویر «منفی» «نمای خیابان» که با نوشتار «فقط برای اهداف توسعه» ته‌نقش‌گذاری شده است، ممکن است نمایش داده شود. این رفتار معمولاً نشان‌دهنده مشکلاتی در کلید API یا صورت‌حساب است. برای استفاده از محصولات Google Maps Platform، باید حساب صورت‌حساب داشته باشید و همه درخواست‌ها باید کلید API معتبر داشته باشند. جریان زیر به عیب‌یابی این مشکل کمک می‌کند:


چگونه کدهای خطای OVER_DAILY_LIMIT یا OVER_QUERY_LIMIT را برطرف کنم؟
این کدهای خطا ممکن است به هریک از دلایل زیر برگردانده شوند:
  • کلید API در درخواست وجود ندارد.
  • کلید API ارائه‌شده نامعتبر است.
  • پروژه حساب صورت‌حساب پیوست‌شده ندارد.
  • از سقف استفاده خودتحمیلی فراتر رفته‌اید.
  • روش پرداخت ارائه‌شده دیگر معتبر نیست (برای مثال، کارت اعتباری منقضی شده است).
  • برای یک API معین، از محدودیت‌های سهمیه فراتر رفته‌اید.

برای استفاده از محصولات Google Maps Platform، باید حساب صورت‌حساب داشته باشید و همه درخواست‌ها باید کلید API معتبر داشته باشند. برای رفع این مشکل، مراحل زیر را انجام دهید:

چگونه کدهای خطای kGMSPlacesRateLimitExceeded یا 9005 PLACES_API_RATE_LIMIT_EXCEEDED را برطرف کنم؟
اگر kGMSPlacesRateLimitExceeded یا 9005 PLACES_API_RATE_LIMIT_EXCEEDED را می‌بینید، ممکن است از نسخه منسوخ‌شده «کیت توسعه نرم‌افزار مکان‌ها ویژه Android» یا «کیت توسعه نرم‌افزار مکان‌ها ویژه iOS» استفاده می‌کنید. در https://goo.gle/places-sdk-deprecation، اطلاعات بیشتری کسب کنید و کیت‌های توسعه نرم‌افزار جدید را پیدا کنید.
چگونه خطای «این IP، سایت، یا برنامه تلفن همراه برای استفاده از این کلید API مجاز نیست» را برطرف کنم؟

سناریوهای مختلفی وجود دارد که ممکن است باعث این خطا شود:

  • محدودیت‌های نشانی IP (سرور) را در کلید API خود فعال کرده‌اید، و نشانی IP غیرمجازی درحال تلاش برای درخواست است.
  • محدودیت‌های ارجاع‌دهنده HTTP (وب‌سایت) را در کلید API خود فعال کرده‌اید، و یک ارجاع‌دهنده غیرمجاز درحال تلاش برای درخواست است.
  • با تنظیم نام بسته و اثر انگشت، استفاده از برنامه‌های Android خود را محدود کرده‌اید و برنامه Android غیرمجازی درحال تلاش برای درخواست است.
  • با مشخص کردن شناسه‌های بسته، درخواست‌های برنامه‌های iOS را محدود کرده‌اید و برنامه iOS ناشناسی درحال تلاش برای ارسال درخواست است.
  • قبلاً اگر از هریک از میاناهای برنامه‌سازی کاربردی سرویس وب با کلید میانای برنامه‌سازی کاربردی دارای محدودیت‌های ارجاع‌دهنده HTTP استفاده می‌کردید، ممکن بود این خطا را دریافت کنید. درخواست‌های این میاناهای برنامه‌سازی کاربردی باید با کلید میانای برنامه‌سازی کاربردی با محدودیت‌های نشانی IP شناسایی شوند. نوع محدودیت کلید خود را از محدودیت ارجاع‌دهنده HTTP به محدودیت نشانی IP تغییر دهید. برای کسب اطلاعات بیشتر درباره محدود کردن کلیدهای میانای برنامه‌سازی کاربردی، روال‌های مطلوب کلید میانای برنامه‌سازی کاربردی را ببینید.

مشاهده و ویرایش کردن اطلاعات اعتباری کلید API

برای مشاهده کلیدهای API و مدیریت محدودیت‌ها، مراحل زیر را انجام دهید:

  1. به صفحه اطلاعات اعتباری در کنسول Cloud بروید.
  2. پروژه‌ای را که حاوی کلید API موردنظر برای بازبینی است انتخاب کنید.
  3. برای مشاهده جزئیات اطلاعات اعتباری، ازجمله محدودیت‌های تنظیم‌شده برای کلید، از فهرست کلیدهای API، روی نام کلید کلیک کنید.
  4. اطلاعات اعتباری کامل کلید API انتخاب‌شده، ازجمله هرگونه محدودیت تنظیم‌شده برای کلید، نمایش داده می‌شود. از اینجا، محدودیت‌ها را می‌توان درصورت نیاز تغییر داد، حذف کرد، یا به‌روز کرد.
چگونه خطای «کلیدهای میانای برنامه‌سازی کاربردی با محدودیت‌های ارجاع‌دهنده نمی‌توانند با این میانای برنامه‌سازی کاربردی استفاده شوند» را برطرف کنم؟

از هریک از میاناهای برنامه‌سازی کاربردی سرویس وب با کلید میانای برنامه‌سازی کاربردی محدودشده به ارجاع‌دهنده HTTP استفاده می‌کنید. به‌دلایل امنیتی، میاناهای برنامه‌سازی کاربردی سرویس وب باید از کلیدهای میانای برنامه‌سازی کاربردی محدودشده به نشانی‌های IP استفاده کنند. نوع محدودیت کلید خود را از محدودیت ارجاع‌دهنده HTTP به محدودیت نشانی IP تغییر دهید، یا اگر کلید شما ازقبل با Maps JavaScript API استفاده می‌شود، کلید API جدیدی ایجاد کنید.

خدمات پلاتفرم Google Maps

باید نشانی‌ها را به جفت‌های عرض جغرافیایی/طول جغرافیایی تبدیل کنم. آیا می‌توانم این کار را با «پلاتفرم Google Maps» انجام دهم؟

بله، این فرایند «زمین‌کدگذاری» نام دارد. ‫Maps JavaScript API شامل کلاسی برای انجام سرویس زمین‌کدیابی است. کلاس این است: google.maps.Geocoder.

یا اینکه Google Geocoding API را نیز ارائه می‌دهد که میانای REST را ارائه می‌دهد که می‌تواند در قالب‌های JSON و XML پاسخ دهد.

کدام کشورها از زمین‌کدگذاری پشتیبانی می‌کنند؟

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

دقت مکان‌های زمین‌کدگذاری‌شده ممکن است در هر کشور متفاوت باشد، بنابراین باید درنظر داشته باشید که از فیلد location_type برگشتی استفاده کنید تا مشخص کنید آیا مطابقت کافی برای اهداف برنامه شما پیدا شده است یا نه. دردسترس بودن داده‌های زمین‌کدگذاری به قراردادهای ما با ارائه‌دهندگان داده بستگی دارد، بنابراین ممکن است تغییر کند.

چرا «کدبندهای جغرافیایی پلاتفرم Google Maps» مکان‌های متفاوتی نسبت به Google Maps ارائه می‌دهند؟

کدبند جغرافیایی API و کدبند جغرافیایی Google Maps گاهی اوقات از مجموعه‌های داده مختلفی استفاده می‌کنند (بسته به کشور). «میانای برنامه‌سازی کاربردی» کدبند جغرافیایی گاهی با داده‌های جدید به‌روزرسانی می‌شود، بنابراین می‌توانید انتظار داشته باشید که نتایج با گذشت زمان تغییر کنند یا بهبود یابند.

چگونه باید پُرسمان‌های زمین‌کدیاب خود را قالب‌بندی کنم تا تعداد درخواست‌های موفق را به حداکثر برسانم؟

کدبند جغرافیایی برای تبدیل نشانی‌های خیابان به مختصات جغرافیایی طراحی شده است. بنابراین توصیه می‌کنیم درخواست‌های کدبند جغرافیایی را مطابق با دستورالعمل‌های زیر قالب‌بندی کنید تا احتمال موفقیت‌آمیز بودن پُرسمان را به حداکثر برسانید:

  • نشانی‌ها را مطابق با قالب استفاده‌شده توسط خدمات پستی ملی کشور مربوطه مشخص کنید.
  • عناصر نشانی اضافی مثل نام کسب‌وکار، شماره واحد، شماره طبقه، یا شماره سوئیت که در نشانی تعریف‌شده توسط سرویس پستی کشور مربوطه وجود ندارد را مشخص نکنید. انجام این کار ممکن است منجر به پاسخ‌هایی با ZERO_RESULTS شود.
  • کدهای پلاس را همان‌طور که در اینجا نشان داده شده است قالب‌بندی کنید (علامت‌های به‌علاوه به %2B و فاصله‌ها به %20 تبدیل می‌شوند):
    • کد جهانی کد منطقه ۴ نویسه‌ای و کد محلی ۶ نویسه‌ای یا طولانی‌تر است (‫849VCWC8+R9 849VCWC8%2BR9 است).
    • کد مرکب کد محلی ۶ کاراکتری یا طولانی‌تری است که مکان صریحی دارد (CWC8+R9 Mountain View, CA, USA‏ CWC8%2BR9%20Mountain%20View%20CA%20USA است).
  • درصورت امکان، به‌جای نام ساختمان از شماره خیابان محل استفاده کنید.
  • درصورت امکان، به‌جای مشخص کردن خیابان‌های متقاطع، از نشانی شماره خیابان استفاده کنید.
  • «راهنمایی‌هایی» مثل نشانگرهای مکانی اطراف ارائه نکنید.
چگونه باید نشانی ایالات متحده را در بزرگراه شماره‌دار برای زمین‌کدیابی قالب‌بندی کنم؟

زمین‌کدیاب «پلاتفرم Google Maps» ملزم می‌کند که بزرگراه‌های شماره‌دار ایالات متحده در نشانی‌ها به‌صورت زیر مشخص شوند:

  • جاده‌های شهرستان: "Co Road NNN" که در آن NNN شماره جاده است. برای نمونه: "Co Road 82"
  • بزرگراه‌های ایالتی: "State NNN" که در آن ایالت نام کامل ایالت و NNN شماره بزرگراه است. برای نمونه، "California 82"
  • بزرگراه‌های ایالات متحده: "US NNN" که در آن NNN شماره بزرگراه است. برای مثال "US 101"
  • بین ایالتی‌های ایالات متحده: "Interstate NNN" که در آن NNN شماره بین ایالتی است. برای مثال: "Interstate 280"
چه زمانی باید از کلاس کدبند جغرافیایی API استفاده کنم و چه زمانی باید از «خدمات کدبندی جغرافیایی HTTP» استفاده کنم؟

به سند استراتژی‌های «زمین‌کدگذاری» مراجعه کنید که مزایا و محدودیت‌های استراتژی‌های مختلف زمین‌کدگذاری را به‌تفصیل شرح می‌دهد.

چگونه با «پلاتفرم Google Maps» مسیرهای رانندگی ارائه دهم؟

سرویس «محاسبه مسیرها» در Routes API به شما امکان می‌دهد مسیرهای رانندگی را برای سفرهای تک‌مرحله‌ای و چندمرحله‌ای ارائه دهید. گزینه‌های مسیریابی به شما کمک می‌کند مسیرها را با حالت سفر (رانندگی)، یک یا مجموعه‌ای از مسیرها، و محدودیت‌ها (بدون جاده‌های عوارضی) شکل دهید. این سرویس‌ها در قالب‌های زیر دردسترس هستند:

میانای درخواست/پاسخ HTTP (استفاده‌شده در تلفن همراه و سایر برنامه‌ها) با «کیت توسعه نرم‌افزار Maps برای Android» و سایر سرویس‌های وب Google Maps سازگار است.

مسیرهای رانندگی در کدام کشورها دردسترس است؟

برای دیدن کشورهایی که از مسیرهای رانندگی در محصولات «پلاتفرم Google Maps» پشتیبانی می‌کنند، به داده‌های پوشش Google Maps مراجعه کنید. دردسترس بودن داده‌های مسیرهای رانندگی به قراردادهای ما با ارائه‌دهندگان داده بستگی دارد و ممکن است تغییر کند.

در کدام کشورها مسیرهای حمل‌ونقل عمومی دردسترس است؟

میانای برنامه‌سازی کاربردی «مسیرها» از همه شرکای «حمل‌ونقل عمومی Google»، به‌جز «شرکت پذیرایی و گردشگری راه‌آهن هند» و شرکای ژاپنی، پشتیبانی می‌کند.

کدام ویژگی‌های KML و GeoRSS در Maps JavaScript API پشتیبانی می‌شوند؟

کلاس KmlLayer در Maps JavaScript API به توسعه‌دهندگان امکان می‌دهد فایل‌های KML/KMZ و GeoRSS را روی نقشه رونهاد کنند. برای مستندات و نمونه‌ها، کلاس KmlLayer را ببینید.

محدودیت‌های اندازه و پیچیدگی KML که می‌توان بااستفاده از کلاس KmlLayer در Maps JavaScript API نمایش داد چیست؟

محدودیت‌های اندازه و پیچیدگی در نمایش KML بااستفاده از کلاس KmlLayer در نمای کلی KmlLayer مستند شده است.

چگونه فایل‌های KML را که در سایت‌های اینترانت میزبانی می‌شوند در نقشه پرداز کنم؟

کلاس KmlLayer که رونهادهای KML را در Maps JavaScript API تولید می‌کند از سرویس میزبانی‌شده Google برای بازیابی و تجزیه فایل‌های KML برای پردازش استفاده می‌کند. درنتیجه، نمایش فایل‌های KML که در نشانی وب دردسترس عموم میزبانی نمی‌شوند یا برای دسترسی به آن‌ها اصالت‌سنجی لازم است امکان‌پذیر نیست.

اگر نیاز دارید برنامه‌هایی بسازید که از فایل‌های KML میزبانی‌شده در سایت‌های اینترانت استفاده می‌کنند، توصیه می‌کنیم که KML را در سمت مشتری بااستفاده از کتابخانه‌های JavaScript طرف سوم پردازش کنید. ازآنجایی‌که فایل KML توسط مرورگر تجزیه‌وتحلیل می‌شود، عملکرد ممکن است کمتر از استفاده از کلاس KmlLayer باشد.

حداکثر تعداد نشانگرها یا رأس‌های مسیر پشتیبانی‌شده توسط «میانای برنامه‌سازی کاربردی Maps Static» چقدر است؟

«ای‌پی‌آی استاتیک Maps» از تعداد نامحدودی نشانگر یا رأس مسیر پشتیبانی می‌کند. هنگام استفاده از نمادهای سفارشی، حداکثر پنج نماد یکتا را می‌توان در هر درخواست مشخص کرد، اما هرکدام را می‌توان چندین بار در نقشه استفاده کرد.

توجه داشته باشید که نشانی‌های وب Maps Static API می‌تواند حداکثر تقریباً ۸٬۱۹۲ نویسه داشته باشد که تعداد نشانگرها و رأس‌های مسیر را که براساس تعداد جایگاه‌های اعشاری استفاده‌شده هنگام مشخص کردن هر جفت طول/عرض جغرافیایی قابل‌تعیین است محدود می‌کند. برای اطلاعات درباره اینکه چگونه تعداد ارقام اعشاری استفاده‌شده با دقت در Earth مرتبط است، به مقاله ویکی‌پدیا درباره درجات اعشاری مراجعه کنید.

چرا نمی‌توانم به محصولات «پلاتفرم Google Maps» برای کشورهای خاصی دسترسی داشته باشم؟

از «میاناهای برنامه‌سازی کاربردی Maps» نباید در قلمروهای ممنوعه استفاده شود. به شرایط خدمات نیز مراجعه کنید.

چگونه می‌توانم مشکلی را در نقشه پایه Google گزارش کنم؟
برای اطلاعات اشتباه یا ناقص نقشه، مثل موارد زیر، ازطریق Google Maps بازخورد ارسال کنید:
  • نشانی‌ها یا مکان‌های نشانگر اشتباه است
  • نام‌های نادرست جاده
  • اطلاعات نادرست درباره جاده‌های یک‌طرفه و دوطرفه
  • جاده‌ای که درست رسم نشده است
  • جاده‌های بسته
  • جاده‌هایی که وجود ندارند

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

اگر محتوای «نقشه‌ها» باید به‌دلایل قانونی برداشته شود، درخواست قانونی ارسال کنید.

برای درخواست‌های حساس به زمان یا حیاتی، پرونده پشتیبانی با جزئیات مشخص درباره آنچه باید اصلاح شود ثبت کنید.

عملکرد سرویس‌های مورداستفاده با Maps JavaScript API چگونه پایش می‌شود؟

برخی‌از ویژگی‌های سمت مشتری برای گزارش موفقیت یا عدم موفقیت به‌منظور محاسبه SLO (هدف سطح خدمات) ابزاربندی شده‌اند. این اطلاعات در تماس‌هایی که اطلاعات SLO را ثبت می‌کنند در ساعت maps.googleapis.com/maps_api_js_slo/log به Google ارسال می‌شود. این اطلاعات شامل وضعیت موفقیت، تأخیر، و نسخه/کانال Maps JavaScript API درحال استفاده می‌شود. تماس‌ها ممکن است برای بهبود عملکرد دسته‌بندی شوند. ممکن است لازم باشد maps.googleapis.com را در خط‌مشی امنیتی محتوا مجاز کنید تا این تماس‌ها در سطح مرورگر مسدود نشوند. برای مثال: Content-Security-Policy: default-src 'self' maps.googleapis.com; با سرایندهای HTTP، یا <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> با «برچسب‌های فراداده HTML».

Maps JavaScript API

پس‌از بار شدن Maps JavaScript API، تا چه مدت کار خواهد کرد؟

باید صفحه‌ای را که «میانای برنامه‌سازی کاربردی جاوا اسکریپت در Maps» را بار می‌کند حداقل هر ۵ روز یک‌بار بازآوری کنید.

کیت توسعه نرم‌افزار Google Maps برای iOS

چگونه خطای kGMSPlacesRateLimitExceeded را برطرف کنم؟
اگر این خطا را می‌بینید، ممکن است از نسخه منسوخ‌شده «کیت توسعه نرم‌افزار مکان‌ها ویژه iOS» استفاده می‌کنید. نسخه ۲.۷.۰ «کیت توسعه نرم‌افزار مکان‌ها ویژه iOS» غیرفعال شده است و دیگر دردسترس نیست. برای استفاده از جدیدترین نسخه، برنامه‌تان را به‌روز کنید. برای جزئیات، راهنمای انتقال را ببینید.
هنگام اشکال‌زدایی با دستگاه iOS 8.x، با خرابی مواجه می‌شوم. چه کاری باید انجام دهم؟

اگر هنگام اشکال‌زدایی با دستگاه‌های دارای iOS 8.x با مشکل مواجه شدید، این مراحل را برای غیرفعال کردن ضبط قاب GPU در طرح XCode که اجرا می‌کنید دنبال کنید:

  1. در XCode، محصول، طرح، مدیریت طرح‌ها را انتخاب کنید.
  2. طرحی را انتخاب کنید و ویرایش… را انتخاب کنید.
  3. گزینه ضبط قاب GPU را روی غیرفعال تنظیم کنید. توجه داشته باشید که این گزینه ممکن است برای همه دستگاه‌ها وجود نداشته باشد.
گزینه «ضبط قاب GPU در Xcode» در صفحه «دستگاه iOS عمومی»
تأثیر صفحه‌های گرد و عریض بر «کیت توسعه نرم‌افزار Google Maps برای iOS» چیست؟

از iPhone X به بعد، شکل صفحه نمایش iPhone دارای گوشه‌های گرد، یک بریدگی در بالا برای محفظه حسگر دستگاه، و یک نشانگر در پایین صفحه برای دسترسی به صفحه اصلی است. از زمان کیت توسعه نرم‌افزار iOS 11.0،‏ Apple میانای برنامه‌سازی کاربردی «منطقه امن» را اضافه کرد که به توسعه‌دهندگان اجازه می‌دهد عناصر را در منطقه‌ای قرار دهند که از بریده شدن توسط شکل جدید صفحه نمایش ایمن باشد.

«کیت توسعه نرم‌افزار Google Maps برای iOS» عناصر دیداری و کنترل‌های زیادی دارد، مثل انتخابگر داخلی و پیوند گزارش مشکل. با نسخه ۲.۴، این عناصر دیداری و کنترل‌ها ممکن است توسط شکل جدید صفحه بریده شوند. در حالت افقی، انتخابگر طبقه داخلی ممکن است توسط بریدگی یا نشانگر دکمه صفحه اصلی بریده شود.

با انتشار Google Maps iOS SDK 2.5، این مشکلات چیدمان به‌طور خودکار برطرف می‌شوند. وقتی از برنامه شما در iPhone X یا مدل‌های جدیدتر استفاده می‌شود، حاشیه GMSMapView و GMSPanoramaView افزایش می‌یابد تا عناصر دیداری برش داده نشوند.

به‌طور پیش‌فرض، همیشه حاشیه شما را اضافه خواهیم کرد. «کیت توسعه نرم‌افزار Google Maps برای iOS» فرض می‌کند که حاشیه برای ایجاد حاشیه از داخل ناحیه امن درنظر گرفته شده است. اگر واسط خود را با این فرض طراحی کنید که همه چیز در ناحیه امن قرار دارد، این کار بدون هیچ تلاش اضافه‌ای انجام خواهد شد.

اگر واسطی طراحی کرده‌اید که با تنظیم پیش‌فرض ما کار نمی‌کند، دارایی جدیدی به GMSMapView اضافه کرده‌ایم که paddingAdjustmentBehavior نام دارد. از GMSMapView برای انتخاب یکی از سه رفتار تنظیمات حاشیه‌ای استفاده کنید: «همیشه» (پیش‌فرض)، «خودکار»، و «هرگز».

اگر GMSMapView برای استفاده از رفتار حاشیه‌گذاری «همیشه» تنظیم شده باشد، همیشه حاشیه‌های ناحیه ایمن را به حاشیه‌گذاری اضافه می‌کند. این تنظیم به شما امکان می‌دهد رابط کاربری خود را با این فرض طراحی کنید که همه جای آگهی از لبه‌های ناحیه امن است. این مقدار پیش‌فرض است.

اگر GMSMapView روی استفاده از عملکرد حاشیه‌گذاری «خودکار» تنظیم شده باشد، همیشه مقدار بزرگ‌تر از حاشیه‌گذاری یا ناحیه امن را انتخاب می‌کند. این تنظیم به شما امکان می‌دهد از لبه صفحه حاشیه اضافه کنید و درعین‌حال مطمئن شوید که همه عناصر در ناحیه امن باقی می‌مانند.

اگر GMSMapView روی استفاده از رفتار بالشتک «هرگز» تنظیم شده باشد، هرگز حاشیه‌های ناحیه امن را به بالشتک اضافه نخواهد کرد. این رفتار مربوط به قبل‌از انتشار نسخه ۲.۵ است و اگر حاشیه شما ازقبل ناحیه امن را درنظر گرفته باشد یا اگر رفتارهای دیگر ما با میانای شما خوب عمل نکند، ممکن است مفید باشد. مسئولیت شما است که مطمئن شوید نشان‌واره Google و اطلاعیه‌های حق نشر همیشه طبق آنچه در شرایط خدمات پلاتفرم Google Maps مشخص شده است قابل‌مشاهده باشند.

درمقابل، GMSPanoramaView ویژگی اختیاری حاشیه ندارد. این یعنی هیچ حاشیه‌ای برای تنظیم وجود ندارد و GMSPanoramaView همیشه هر حاشیه ضروری را اعمال می‌کند تا همه عناصر دیداری در ناحیه ایمن قرار گیرند.

کیت توسعه نرم‌افزار Google Maps برای Android

چگونه خطای 9005 PLACES_API_RATE_LIMIT_EXCEEDED را برطرف کنم؟
اگر این خطا را می‌بینید، ممکن است از نسخه منسوخ‌شده «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» استفاده می‌کنید. نسخه «خدمات Google Play» از «کیت توسعه نرم‌افزار مکان‌ها، ویژه Android» خاموش شده است و دیگر دردسترس نیست. برای استفاده از جدیدترین نسخه، برنامه‌تان را به‌روز کنید. برای جزئیات، راهنمای انتقال را ببینید.
برنامه من به‌جای نقشه فقط کاشی‌های خاکستری خالی نشان می‌دهد. چگونه می‌توانم این مشکل را حل کنم؟

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

  1. مطمئن شوید که adb را نصب کرده‌اید. اگر ندارید، می‌توانید راهنمای راهنمای Android adb را دنبال کنید.
  2. برنامه‌ای را که مشکل را نشان می‌دهد در دستگاه یا شبیه‌ساز Android نصب کنید. اگر از شبیه‌ساز Android استفاده می‌کنید، مطمئن شوید تنظیمات شبیه‌ساز شامل «فروشگاه Play» باشد.
  3. در پایانه «استودیو Android»،‏ adb logcat -e "Google Maps Android API" را اجرا کنید. این کار فقط خطوطی را چاپ می‌کند که پیام گزارش با «Google Maps Android API» مطابقت داشته باشد (درصورت تمایل، می‌توانید گزارش را با افزودن > logcat.txt در فایل نوشتاری برون‌برد کنید)
  4. مشکل را در دستگاهتان بازتولید کنید و خطاهای رایج را بررسی کنید، مثلاً:
    • «کلید میانای برنامه‌سازی کاربردی» اشتباه/ناخواسته در «مانیفست» ارجاع داده شده است.
    • صدور صورت‌حساب در «پروژه» فعال نیست.
    • کیت توسعه نرم‌افزار در میاناهای برنامه‌سازی کاربردی پروژه فعال نیست.
    • اثر انگشت SHA-1 نادرست به محدودیت‌های «کلید میانای برنامه‌سازی کاربردی» اضافه شده است.
    • وابستگی‌های «خدمات Google Play» در فایل build.gradle گنجانده نشده است.
آیا شتاب سخت‌افزاری برای «کیت توسعه نرم‌افزار Google Maps ویژه Android» الزامی است؟
بله، hardwareAccelerated باید در فایل AndroidManifest.xml برنامه‌تان روی true تنظیم شود تا از بروز مشکل در بار کردن نقشه جلوگیری شود.
برای کسب اطلاعات بیشتر، صفحه شتاب سخت‌افزاری را در اسناد توسعه‌دهنده Android ببینید.

امضای نشانی وب

آیا می‌توانم نشانی‌های وب را بااستفاده از جاوا اسکریپت امضا کنم؟

به‌شدت توصیه می‌کنیم از امضای نشانی‌های وب بااستفاده از جاوا اسکریپت خودداری کنید زیرا این کار باعث می‌شود رمز امضای نشانی وب شما برای کاربران نهایی آشکار شود. بنابراین امضاها باید فقط توسط عناصر سمت سرور تولید شوند.

چرا پاسخ «۴۰۳ ممنوع» HTTP را برای درخواست‌های سرویس وب Maps API دریافت می‌کنم؟

پاسخ HTTP 403 نشان‌دهنده مشکل اجازه است، احتمالاً به این دلیل که امضای این درخواست تأیید نشده است. دلیل آن ممکن است یکی از موارد زیر باشد:

  1. امضایی مشخص شده است اما برای این درخواست صحیح نیست.
  2. درخواست کلید میانای برنامه‌سازی کاربردی «طرح ممتاز پلاتفرم Google Maps» را مشخص می‌کند اما امضا را مشخص نمی‌کند، و سرویسی که فراخوانده می‌شود ملزم می‌کند درخواست‌هایی که بااستفاده از کلید میانای برنامه‌سازی کاربردی انجام می‌شوند امضای معتبری داشته باشند.
  3. امضایی مشخص شده است اما کلید API طرح ممتاز Google Maps Platform مرتبط مشخص نشده است.