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

شروع به کار

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

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

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

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

سرویس‌های پلاتفرم Google Maps

Maps JavaScript API

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

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

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

شروع به کار

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

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

نقشه‌ها:

مسیرها:

مکان‌ها:

محیط زیست:

چگونه کار با Google Maps Platform را شروع کنم؟

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

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

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

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

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

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

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

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

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

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

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

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

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

Maps JavaScript API برای پاسخگویی به نیازهای دستگاه‌های همراه توسعه یافته است و برای برنامه‌های مرورگر مناسب است که هم رایانه و هم دستگاه‌هایی را هدف قرار می‌دهند که مرورگر وب با پیاده‌سازی کامل JavaScript دارند، مانند 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 (سیستم‌عامل Mac).
Android
  • نسخه فعلی Chrome در Android 4.1 و بالاتر.
  • Chrome WebView در Android نسخه ۴.۴ و بالاتر.
iOS
  • Mobile Safari در نسخه‌های اصلی فعلی و قبلی iOS.
  • UIWebView و WKWebView در نسخه‌های اصلی فعلی و قبلی iOS.
  • نسخه کنونی Chrome برای iOS.
آیا می‌توانم نقشه‌ها را از Maps JavaScript API چاپ کنم؟

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

چگونه می‌توانم از تغییرات محصولات Google Maps Platform مطلع شوم؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تا زمانی که سایتتان با شرایط خدمات Google Maps Platform مطابقت داشته باشد، می‌توانید از Google Maps Platform در برنامه‌هایتان استفاده کنید.

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

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

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

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

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

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

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

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

‫Maps JavaScript API فقط زمانی پشتیبانی می‌شود که در یکی از مرورگرهای پشتیبانی‌شده اجرا شود.

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

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

آیا می‌توانم برنامه‌ای ایجاد کنم که داده‌های Google Maps Platform را در سند اضافه کند؟

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

چگونه می‌توانم از گنجاندن محتوایم در نتایج «جستجوی 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 Platform ارسال کنید وجود ندارد و تنها محدودیت‌های استفاده مربوط به حداکثر تعداد پُرسمان در دقیقه (QPM) است.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

چگونه مصرفم را پایش کنم؟

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

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

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

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

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

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

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

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

توجه: میاناهای برنامه‌سازی کاربردی سرویس وب زیر دارای سرویس معادل سمت کارخواه هستند که در Maps JavaScript API دردسترس است: Elevation،‏ Geocoding.

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

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

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

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

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

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

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

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

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

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

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

آیا قیمت‌گذاری به واحدهای پولی دیگر دردسترس است؟

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

محدودیت‌ها:

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

میانای برنامه‌سازی کاربردی/کیت توسعه نرم‌افزار محدودیت اعتبارنامه و برنامه
کیت توسعه نرم‌افزار Google Maps برای Android کلید میانای برنامه‌سازی کاربردی با محدودیت Android۱
کیت توسعه نرم‌افزار مکان‌ها، ویژه Android کلید میانای برنامه‌سازی کاربردی با محدودیت Android۱
کیت توسعه نرم‌افزار پیمایش برای Android کلید میانای برنامه‌سازی کاربردی با محدودیت Android۱
کیت توسعه نرم‌افزار Google Maps برای iOS کلید میانای برنامه‌سازی کاربردی با محدودیت iOS۱
کیت توسعه نرم‌افزار مکان‌ها، ویژه iOS کلید میانای برنامه‌سازی کاربردی با محدودیت iOS۱
کیت توسعه نرم‌افزار پیمایش برای iOS کلید میانای برنامه‌سازی کاربردی با محدودیت iOS۱
Maps JavaScript API کلید میانای برنامه‌سازی کاربردی با محدودیت ارجاع‌دهنده HTTP۱
Map Tiles API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Maps Datasets API کد OAuth
Aerial View API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Maps Static API کلید میانای برنامه‌سازی کاربردی با محدودیت ارجاع‌دهنده HTTP۱ + امضای دیجیتال۲
Street View Static API کلید میانای برنامه‌سازی کاربردی با محدودیت ارجاع‌دهنده HTTP۱ + امضای دیجیتال۲
Maps Embed 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۱
میانای برنامه‌سازی کاربردی Routes کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Time Zone API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Air Quality API کلید میانای API با محدودیت نشانی IP۱
Pollen API کلید میانای برنامه‌سازی کاربردی با محدودیت نشانی IP۱
Solar API کلید میانای API با محدودیت نشانی IP۱
Weather API کلید میانای API با محدودیت نشانی IP۱
۱ محدودیت‌های کلید میانای API اختیاری است، اما اکیداً توصیه می‌کنیم برای امنیت بیشتر، همه کلیدهای میانای API را محدود کنید.
۲ بسته به میزان استفاده، ممکن است برای Maps Static API و Street View Static API امضای دیجیتال لازم باشد. صرف‌نظر از میزان استفاده، اکیداً توصیه می‌کنیم که برای اصالت‌سنجی درخواست‌هایتان هم از کلید میانای برنامه‌سازی کاربردی و هم از امضای دیجیتال استفاده کنید.
چگونه نوع محدودیت کلید را از ارجاع‌دهنده HTTP به محدودیت نشانی IP تغییر دهم؟

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

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

درباره محدودیت‌های کلید میانای برنامه‌سازی کاربردی مرتبط با محصولات Google Maps Platform بیشتر بدانید.

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

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

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

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

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

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

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

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

به‌طور پیش‌فرض، 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 (TLS) به «پلاتفرم Google Maps» دسترسی پیدا کرد؟

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

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

برای اطلاعات بیشتر، به پرسشگان انتقال CA ریشه Google Maps Platform و پرسشگان Google Trust Services مراجعه کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

مشاهده و ویرایش اعتبارنامه کلید میانای برنامه‌سازی کاربردی

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

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

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

سرویس‌های پلاتفرم Google Maps

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

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

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

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

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

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

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

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

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

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

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

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

  • جاده‌های ایالتی: "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» مسیرهای رانندگی ارائه دهم؟

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

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

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

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

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

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

حداکثر تعداد نشانگرها یا رئوس مسیر که Maps Static API پشتیبانی می‌کند چقدر است؟

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

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

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

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

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

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

اگر محتوای 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 JavaScript API را بار می‌کند حداقل هر ۵ روز یک‌بار بازآوری کنید.

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

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

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

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

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

کیت توسعه نرم‌افزار 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 Platform مشخص شده است.

درمقابل، GMSPanoramaView ویژگی حاشیه داخلی اختیاری ندارد. This means that there is no padding to adjust and GMSPanoramaView will always apply any necessary padding so that all visual elements are within the safe area.

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

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

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

  1. مطمئن شوید adb را نصب کرده‌اید. اگر نه، می‌توانید راهنمای Android adb guide را دنبال کنید.
  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 باید روی true در فایل AndroidManifest.xml برنامه‌تان تنظیم شود تا از بروز مشکل در بار کردن نقشه جلوگیری شود.
برای اطلاعات بیشتر، به صفحه شتاب سخت‌افزاری در مستندات توسعه‌دهنده Android مراجعه کنید.

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

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

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

چرا برای درخواست‌های سرویس وب Maps API پاسخ «HTTP 403 Forbidden» دریافت می‌کنم؟

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

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