سوالات متداول پلتفرم نقشه های گوگل

شروع به کار

• پلتفرم نقشه های گوگل چیست؟
• چگونه می توانم با Google Maps Platform شروع کنم؟
• به کدام API نیاز دارم؟
• چگونه می توانم از API ها در سایت خود استفاده کنم؟
• پلتفرم نقشه های گوگل کدام کشورها را پوشش می دهد؟
• آیا می توانم بدون استفاده از محصولات پلتفرم نقشه های گوگل، نقشه های گوگل را در سایت خود قرار دهم؟
• چگونه برنامه های Maps را در دستگاه های تلفن همراه ارائه کنم؟
• Maps JavaScript API و Maps Embed API از کدام مرورگرهای وب پشتیبانی می کند؟
• آیا می توانم نقشه ها را از Maps JavaScript API چاپ کنم؟
• وقتی تغییراتی در محصولات پلتفرم Google Maps ایجاد می شود، چگونه می توانم مطلع شوم؟
• چگونه با پشتیبانی فنی تماس بگیرم؟
• چه زمانی پشتیبانی فنی در دسترس است؟
• چگونه می توانم دسترسی به حساب Google خود را بازیابی کنم؟
• چگونه می توانم دسترسی به یک پروژه خاص را بازیابی کنم؟
• آیا می توانم از Maps and Places SDK برای iOS در Mac های مبتنی بر Arm استفاده کنم؟

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

• شرایط خدمات برای محصولات پلتفرم Google Maps چیست؟
• آیا سایت من شرایط خدمات پلتفرم Google Maps را رعایت می کند؟
• آیا می توانم مستقیماً به کاشی های نقشه و تصاویر ماهواره ای دسترسی داشته باشم؟
• آیا می توانم از محصولات پلتفرم نقشه های گوگل برای ردیابی برنامه ها استفاده کنم؟
• آیا می توانم از محصولات Google Maps Platform در برنامه غیر وب خود استفاده کنم؟
• آیا می توانم از محصولات پلتفرم نقشه های گوگل در سایتی استفاده کنم که دارای رمز عبور است؟
• آیا می توانم برنامه ای ایجاد کنم که شامل داده های پلتفرم نقشه های گوگل در یک سند باشد؟
• چگونه می توانم از گنجاندن محتوای خود در نتایج جستجوی Google انصراف دهم؟
• آیا می توانم با استفاده از Maps Static API که از وب سایت خود ذخیره و ارائه می کنم یک تصویر نقشه ایجاد کنم؟

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

• چگونه صورتحساب پروژه خود را تنظیم کنم؟
• چگونه مشتریان Google Cloud Free Tier به یک حساب پولی ارتقا می‌دهند؟
• آیا پلتفرم نقشه گوگل محدودیت استفاده دارد؟
• هزینه استفاده چگونه محاسبه می شود؟
• بارهای نقشه در پلتفرم Google Maps چگونه محاسبه می شود؟
• چگونه بر میزان استفاده از سهمیه خود نظارت کنم؟
• اگر از محدودیت های استفاده تجاوز کنم چه اتفاقی می افتد؟
• سایت من ترافیک زیادی می گیرد. آیا می توانم از محصولات پلتفرم نقشه های گوگل استفاده کنم؟
• اگر وب سایت یا برنامه من به طور ناگهانی محبوب شود، آیا نقشه های من کار نمی کنند؟
• میزان مصرف چگونه محاسبه و صورتحساب می شود؟
• هزینه استفاده از پلتفرم نقشه های گوگل چقدر است؟
• آیا قیمت گذاری به ارزهای دیگر موجود است؟
• من صورتحساب را تنظیم کرده ام. چگونه صورتحساب خود را مشاهده کنم؟
• اگر مصرف من به طور غیرمنتظره افزایش یابد، چگونه می توانم از یک صورت حساب بزرگ جلوگیری کنم؟
• پیامی دریافت کردم مبنی بر اینکه پروژه من به "حساب انتقال پلتفرم Google Maps" مرتبط است، اما من به آن حساب دسترسی ندارم. چه کار کنم؟
• چرا محدودیت سهمیه من روی 1 درخواست در روز تنظیم شده است؟ چگونه می توانم این حد را افزایش دهم؟
• من یک اخطار نقض صورت حساب دریافت کردم. چگونه این را حل کنم؟

از پلتفرم نقشه های گوگل استفاده کنید

• برای محصولات مختلف پلتفرم Google Maps از کدام کلیدها یا اعتبارنامه ها استفاده کنم؟
• چگونه می توانم نوع محدودیت کلید خود را از یک ارجاع دهنده HTTP به یک محدودیت آدرس IP تغییر دهم؟
• چگونه یک کلید API جدید دریافت کنم؟
• چگونه می توانم تغییرات ایجاد شده در هر نسخه از پلتفرم نقشه های گوگل را پیدا کنم؟
• چگونه می توانم پس از بارگیری صفحه، API را به صورت ناهمزمان در صفحه بارگذاری کنم؟
• چگونه می توانم محصولات Google Maps Platform را برای نمایش به زبانی غیر از انگلیسی دریافت کنم؟
• آیا می توان از طریق HTTPS (TLS) به پلتفرم نقشه های گوگل دسترسی داشت؟
• چگونه می توانم یک اشکال را گزارش کنم یا یک ویژگی جدید را در پلتفرم Google Maps درخواست کنم؟
• چگونه API های پلتفرم نقشه های گوگل از کوکی های سایت استفاده می کنند؟
• من نمی توانم پاسخ سوال خود را پیدا کنم. با چه کسی تماس بگیرم؟

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

• این خطا به چه معناست؟
• نقشه های من تیره تر از حد معمول به نظر می رسند. چه اتفاقی می افتد؟
• چگونه کدهای خطا OVER_DAILY_LIMIT یا OVER_QUERY_LIMIT را برطرف کنم؟
• چگونه کدهای خطا را حل کنم: kGMSPlacesRateLimitExceeded یا 9005 PLACES_API_RATE_LIMIT_EXCEEDED ؟
• چگونه خطا را برطرف کنم: "این IP، سایت یا برنامه تلفن همراه مجاز به استفاده از این کلید API نیست."؟
• چگونه این خطا را حل کنم: "کلیدهای API با محدودیت های ارجاع دهنده نمی توانند با این API استفاده شوند."؟

خدمات پلتفرم نقشه های گوگل

• من باید آدرس ها را به جفت طول و عرض جغرافیایی تبدیل کنم. آیا می توانم این کار را با پلتفرم نقشه های گوگل انجام دهم؟
• ژئوکدینگ در کدام کشورها موجود است؟
• چرا ژئوکدرهای پلتفرم نقشه های گوگل مکان های متفاوتی نسبت به نقشه های گوگل ارائه می دهند؟
• چگونه باید پرس و جوهای ژئوکدر خود را قالب بندی کنم تا تعداد درخواست های موفق را به حداکثر برسانم؟
• چگونه باید یک آدرس ایالات متحده را در یک بزرگراه شماره گذاری شده برای کدگذاری جغرافیایی فرمت کنم؟
• چه زمانی باید از کلاس geocoder API استفاده کنم و چه زمانی باید از سرویس HTTP Geocoding استفاده کنم؟
• چگونه مسیرهای رانندگی را با پلتفرم Google Maps ارائه کنم؟
• مسیرهای رانندگی در کدام کشورها موجود است؟
• مسیرهای ترانزیت در کدام کشورها موجود است؟
• کدام ویژگی‌های KML و GeoRSS در Maps JavaScript API پشتیبانی می‌شوند؟
• محدودیت‌های اندازه و پیچیدگی KML که می‌توان با استفاده از کلاس KmlLayer از Maps JavaScript API نمایش داد چیست؟
• چگونه فایل‌های KML را که در سایت‌های اینترانت میزبانی می‌شوند بر روی نقشه رندر کنم؟
• حداکثر تعداد نشانگرها یا رئوس مسیرهای پشتیبانی شده توسط Maps Static API چقدر است؟
• چرا نمی توانم به محصولات پلتفرم Google Maps برای برخی از کشورها دسترسی داشته باشم؟
• چگونه مشکلی را در نقشه پایه گوگل گزارش کنم؟
• چگونه عملکرد سرویس‌های مورد استفاده با Maps JavaScript API نظارت می‌شود؟

Maps JavaScript API

• Maps JavaScript API چه مدت پس از بارگیری کار می کند؟

Google Maps SDK برای iOS

• چگونه خطا را حل کنم: kGMSPlacesRateLimitExceeded ؟
• هنگام اشکال زدایی با دستگاه iOS 8.x دچار خرابی می شوم. چه کار کنم؟
• تأثیر صفحه‌های گرد و عریض‌تر در Google Maps iOS SDK چیست؟

Google Maps SDK برای اندروید

• چگونه خطا را برطرف کنم: 9001 Operation failed due to exceeding the quota usage limit ؟
• برنامه من فقط کاشی های خاکستری خالی را به جای نقشه نشان می دهد. چگونه می توانم این را حل کنم؟

امضای URL

• آیا می توانم URL ها را با استفاده از جاوا اسکریپت امضا کنم؟
• چرا یک پاسخ HTTP 403 Forbidden به درخواست‌های سرویس وب Maps API خود دریافت می‌کنم؟

شروع به کار

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

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

نقشه ها:

• Maps JavaScript API
• Maps SDK برای اندروید
• Maps SDK برای iOS
• Map Tiles API
• Aerial View API
• Maps Static API
• API استاتیک نمای خیابان
• URL های نقشه ها
• Maps Embed API
• Maps Datasets API

مسیرها:

• Routes API
• Roads API
• Route Optimization API
• Navigation SDK برای اندروید
• Navigation SDK برای iOS

مکان ها:

• Places API
• مکان‌های SDK برای Android
• مکان‌های SDK برای iOS
• کتابخانه مکان‌ها، Maps JavaScript API
• Places Aggregate API
• Address Validation API
• API کدگذاری جغرافیایی
• API مکان جغرافیایی
• API منطقه زمانی

محیط زیست:

• API کیفیت هوا
• Pollen API
• API خورشیدی

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

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

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

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

چگونه می توانم از API ها در سایت خود استفاده کنم؟

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

پلتفرم نقشه های گوگل کدام کشورها را پوشش می دهد؟

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

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

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

آیا می توانم بدون استفاده از محصولات پلتفرم نقشه های گوگل، نقشه های گوگل را در سایت خود قرار دهم؟

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

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

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

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

Maps JavaScript API برای پاسخگویی به دستگاه‌های تلفن همراه توسعه یافته است و برای برنامه‌های مرورگر که هم روی دسکتاپ و هم دستگاه‌هایی که شامل یک مرورگر وب با پیاده‌سازی کامل جاوا اسکریپت هستند، مناسب است، مانند 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 (ویندوز)، به استثنای حالت اینترنت اکسپلورر.
• دو آخرین نسخه اصلی پایدار فایرفاکس (ویندوز، macOS، لینوکس).
• دو آخرین نسخه اصلی پایدار کروم (ویندوز، macOS، لینوکس).
• دو آخرین نسخه اصلی پایدار سافاری (macOS).

اندروید

• نسخه فعلی Chrome در Android نسخه 4.1 و بالاتر.
• Chrome WebView در Android 4.4 و بالاتر.

iOS

• سافاری موبایل در نسخه های اصلی فعلی و قبلی iOS.
• UIWebView و WKWebView در نسخه های اصلی فعلی و قبلی iOS.
• نسخه فعلی کروم برای iOS.

آیا می توانم نقشه ها را از Maps JavaScript API چاپ کنم؟

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

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

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

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

برای اطلاعات در مورد گزینه های پشتیبانی موجود ، به پشتیبانی و منابع پلتفرم نقشه های Google مراجعه کنید.

چه زمانی پشتیبانی فنی در دسترس است؟

تیم پشتیبانی 24×5 (روزهای هفته از دوشنبه 9 صبح به وقت توکیو تا جمعه 5 بعد از ظهر به وقت اقیانوس آرام) به استثنای تعطیلات منطقه ای برای مشکلات "خدمات غیرقابل استفاده" در دسترس است.

چگونه می توانم دسترسی به حساب Google خود را بازیابی کنم؟

اگر دسترسی به حساب Google خود را از دست دادید (به عنوان مثال [e-mail] یا [e-mail])، می توانید با بازیابی یا تنظیم مجدد رمز عبور، دسترسی به حساب را بازیابی کنید. به مقاله نحوه بازیابی حساب Google یا Gmail خود در راهنمای حساب Google مراجعه کنید.

• توجه: برای بازیابی دسترسی به حساب G Suite، از سرپرست سازمان خود بخواهید حساب را حذف کند .

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

اگر دسترسی به پروژه ای را که در آن پیاده سازی پلتفرم Google Maps خود را مدیریت می کنید از دست دادید، می توانید سعی کنید آن را بازیابی کنید.

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

• اگر مالک پروژه را می شناسید و به حساب Google خود دسترسی دارید: از مالک پروژه بخواهید شما را به عنوان مالک پروژه یا ویرایشگر پروژه اضافه کند .
  • اگر پروژه شما بخشی از یک سازمان است: با مدیران سازمان خود تماس بگیرید و از آنها بخواهید که شما را به عنوان مالک پروژه اضافه کنند .
• اگر هیچ یک از مالکان پروژه فعلی را نمی‌شناسید: اگر نمی‌دانید مالک پروژه کیست، یا مالک پروژه در دسترس نیست، با تیم پشتیبانی تماس بگیرید تا گزینه‌های اضافی برای بازیابی پروژه را بررسی کنید.

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

• اگر دسترسی به حساب Google خود را از دست دادید: سعی کنید نام کاربری یا رمز عبور حساب خود را بازیابی کنید .
• اگر نمی توانید دسترسی به حساب Google خود را بازیابی کنید: یک حساب Google جدید ایجاد کنید، سپس با مالک پروژه موجود تماس بگیرید و از او بخواهید حساب Google جدید شما را به پروژه اضافه کند .

آیا می توانم از Maps and Places SDK برای 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 فقط می توانند کمک فنی ارائه دهند و صلاحیت ارائه مشاوره حقوقی را ندارند. Google این حق را برای خود محفوظ می دارد که در هر زمانی استفاده شما از این سرویس را تعلیق یا خاتمه دهد، بنابراین شرایط Maps APIs را به دقت بخوانید.

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

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

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

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

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

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

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

آیا می توانم از محصولات پلتفرم نقشه های گوگل در سایتی استفاده کنم که دارای رمز عبور است؟

بله، خدمات Google Maps، Routes، Places و Environment را می توان با برنامه های کاربردی دسترسی خصوصی استفاده کرد. برای جزئیات بیشتر به شرایط خدمات پلتفرم Google Maps مراجعه کنید.

آیا می توانم برنامه ای ایجاد کنم که شامل داده های پلتفرم نقشه های گوگل در یک سند باشد؟

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

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

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

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

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

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

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

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

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

چگونه مشتریان Google Cloud Free Tier به یک حساب پولی ارتقا می‌دهند؟

برنامه Google Cloud Free Tier یک دوره آزمایشی بدون هزینه با اعتبار 300 دلاری برای استفاده با هر سرویس Google Cloud، از جمله APIهای پلتفرم Google Maps (GMP) به مشتریان ارائه می دهد. پس از پایان دوره آزمایشی رایگان، برای ادامه استفاده از این خدمات، باید به یک حساب پولی ارتقا دهید . برای ارتقاء به یک حساب پولی، از کنسول Cloud دیدن کنید.

آیا پلتفرم نقشه گوگل محدودیت استفاده دارد؟

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

نکات: برای درخواست‌های ماتریس مسیر محاسبه، محدودیت بر حسب عناصر در دقیقه (EPM) است، که در آن تعداد عناصر در یک درخواست برابر است: (تعداد مبدا ضربدر تعداد مقصد).

برای Navigation SDK، هر مقصد در یک درخواست به عنوان یک درخواست جداگانه محاسبه می شود.

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

API	محدودیت استفاده
اعتبار سنجی آدرس	6000 QPM
نمای هوایی: جستجوی ویدیو	180 QPM و 100000 QPD
نمای هوایی: رندر ویدیو	100 QPM و 100 QPD
کیفیت هوا	6000 QPM
Maps JavaScript API: نقشه های سه بعدی	30000 QPM
Maps JavaScript API: Dynamic Maps	30000 QPM
ارتفاع	6000 QPM
ژئوکدینگ	3000 QPM
موقعیت جغرافیایی	6000 QPM
Map Tiles API: 2D Map Tiles	6000 QPM و 15000 QPD
Map Tiles API: کاشی‌های نمای خیابان	6000 QPM و 15000 QPD
Map Tiles API: کاشی های سه بعدی فوتورئالیستی	12000 QPM و 10000 درخواست ریشه در روز.
ناوبری: درخواست های مقصد را تنظیم کنید	30000 QPM
مکان ها	6000 QPM
مجموع مکان ها	1200 QPM
گرده	6000 QPM
جاده ها	30000 QPM
مسیرها: محاسبه مسیرها	3000 QPM
مسیرها: محاسبه مسیر ماتریس	3000 EPM
خورشیدی	600 QPM
نقشه های ایستا	30000 QPM
API تصویر نمای خیابان	30000 QPM
منطقه زمانی	30000 QPM

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

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

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

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

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

بارهای نقشه در پلتفرم Google Maps چگونه محاسبه می شود؟

زمانی که هر یک از موارد زیر رخ می دهد، یک بار نقشه واحد شارژ می شود:

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

هزینه پانورامای نمای خیابان به طور جداگانه از بارهای نقشه دریافت می شود:

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

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

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

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

می‌توانید استفاده از APIهای جداگانه را در کنسول Google Cloud نظارت کنید.

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

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

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

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

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

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

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

توجه: APIهای وب سرویس زیر دارای یک سرویس مشابه در سمت سرویس گیرنده هستند که در Maps JavaScript API موجود است: Elevation ، Geocoding .

از محدودیت های استفاده فراتر رفت

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

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

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

سایت من ترافیک زیادی می گیرد. آیا می توانم از محصولات پلتفرم نقشه های گوگل استفاده کنم؟

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

اگر وب سایت یا برنامه من به طور ناگهانی محبوب شود، آیا نقشه های من کار نمی کنند؟

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

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

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

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

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

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

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

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

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

منابع اضافی:

• نحوه مشاهده تاریخچه هزینه و پرداخت خود را بیاموزید.
• نحوه دریافت فاکتور یا رسید پرداخت را بیاموزید.
• نحوه تنظیم و مدیریت هشدارهای صورتحساب را بیاموزید.

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

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

محدود کردن حداکثر سقف قابل پرداخت روزانه:

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

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

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

هشدارهای بودجه را برای ارسال اعلان‌های ایمیلی به سرپرستان صورت‌حساب زمانی که هزینه‌های حساب صورت‌حساب به آستانه‌ای که شما تعیین کرده‌اید رسید، تنظیم کنید . زمانی که هزینه‌های تخمینی حساب صورت‌حساب از 50%، 90% و 100% آستانه فراتر رفت، اعلان‌های ایمیل به مدیران صورت‌حساب ارسال می‌شود.

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

پیامی دریافت کردم مبنی بر اینکه پروژه من به "حساب انتقال پلتفرم Google Maps" مرتبط است، اما من به آن حساب دسترسی ندارم. چه کار کنم؟

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

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

چرا محدودیت سهمیه من روی 1 درخواست در روز تنظیم شده است؟ چگونه می توانم این حد را افزایش دهم؟

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

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

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

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

از پلتفرم نقشه های گوگل استفاده کنید

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

هر بار که از محصولات پلتفرم Google Maps استفاده می کنید، باید یک کلید API برای تأیید درخواست خود اضافه کنید. پلتفرم نقشه های گوگل برای برنامه های اندروید، iOS یا وب و برای سرویس های وب HTTP در دسترس است.

کلید API:

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

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

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

محدودیت ها:

• محدودیت‌های کلید API اختیاری هستند، اما ما قویاً توصیه می‌کنیم برای امنیت بیشتر، همه کلیدهای API را محدود کنید. برای جزئیات بیشتر به بهترین شیوه های امنیتی API مراجعه کنید.
• می توانید یک محدودیت برنامه را به کلید API اضافه کنید. پس از محدود شدن، یک کلید فقط روی پلتفرم هایی کار می کند که از آن نوع محدودیت پشتیبانی می کنند. چهار نوع محدودیت برنامه موجود است. APIهایی که یک نوع محدودیت را اعمال می کنند می توانند از همان کلید محدود استفاده کنند.
  • آدرس های IP (سرورهای فردی) - برای استفاده با API های سرویس وب .
  • ارجاع دهنده های HTTP (وب سایت ها) - برای استفاده با API های وب .
  • محدودیت برنامه Android (بر اساس نام بسته و اثر انگشت) - برای استفاده با Maps SDK برای Android .
  • محدودیت برنامه iOS (توسط شناسه بسته iOS) - برای استفاده با Maps SDK برای iOS .
• همچنین می توانید یک محدودیت API به کلید API اضافه کنید. برای اطلاعات بیشتر، به دریافت، افزودن و محدود کردن یک کلید API مراجعه کنید.

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

API/SDK	اعتبارنامه و محدودیت درخواست
Maps SDK برای اندروید	کلید API با محدودیت اندروید ^1
مکان‌های SDK برای Android	کلید API با محدودیت اندروید ^1
Navigation SDK برای اندروید	کلید API با محدودیت اندروید ^1
Maps SDK برای iOS	کلید API با محدودیت iOS ^1
مکان‌های SDK برای iOS	کلید API با محدودیت iOS ^1
Navigation SDK برای iOS	کلید API با محدودیت iOS ^1
Maps JavaScript API	کلید API با محدودیت ارجاع HTTP ^1
Map Tiles API	کلید API با محدودیت آدرس IP ^1
Maps Datasets API	نشانه OAuth
Aerial View API	کلید API با محدودیت آدرس IP ^1
Maps Static API	کلید API با محدودیت ارجاع HTTP ^1 + امضای دیجیتال ^2
API استاتیک نمای خیابان	کلید API با محدودیت ارجاع HTTP ^1 + امضای دیجیتال ^2
Maps Embed API	کلید API با محدودیت ارجاع HTTP ^1
Address Validation API	کلید API با محدودیت آدرس IP ^1
Elevation API	کلید API با محدودیت آدرس IP ^1
API کدگذاری جغرافیایی	کلید API با محدودیت آدرس IP ^1
API مکان جغرافیایی	کلید API با محدودیت آدرس IP ^1
Places API	کلید API با محدودیت آدرس IP ^1
Places Aggregate API	کلید API با محدودیت آدرس IP ^1
Roads API	کلید API با محدودیت آدرس IP ^1
Routes API	کلید API با محدودیت آدرس IP ^1
API منطقه زمانی	کلید API با محدودیت آدرس IP ^1
API کیفیت هوا	کلید API با محدودیت آدرس IP ^1
Pollen API	کلید API با محدودیت آدرس IP ^1
API خورشیدی	کلید API با محدودیت آدرس IP ^1

¹ محدودیت های کلید API اختیاری است، اما ما قویاً توصیه می کنیم برای امنیت بیشتر، همه کلیدهای API را محدود کنید.

² بسته به نوع استفاده، ممکن است برای Maps Static API و Street View Static API به امضای دیجیتال نیاز باشد. صرف نظر از استفاده، ما اکیداً توصیه می کنیم که از کلید API و امضای دیجیتال برای احراز هویت درخواست های خود استفاده کنید.

چگونه می توانم نوع محدودیت کلید خود را از یک ارجاع دهنده HTTP به یک محدودیت آدرس IP تغییر دهم؟

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

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

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

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

1. به صفحه Credentials کنسول Cloud بروید.
2. پروژه ای را انتخاب کنید که حاوی کلید API است که می خواهید ویرایش کنید.
3. در صفحه Credentials ، از لیست کلیدهای API، نام کلید API را برای ویرایش جزئیات کلید انتخاب کنید.
4. در قسمت Key limitation صفحه، «آدرس های IP (سرورهای وب، cron jobs و غیره)» را انتخاب کنید و آدرس های IP سرور مناسب را وارد کنید، سپس روی ذخیره کلیک کنید.

چگونه یک کلید API جدید دریافت کنم؟

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

چگونه می توانم تغییرات ایجاد شده در هر نسخه از APIهای Google Maps را پیدا کنم؟

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

• API کدگذاری جغرافیایی
• Maps JavaScript API
• Routes API
• Maps SDK برای اندروید
• مکان‌های SDK برای Android
• Navigation SDK برای اندروید
• Maps SDK برای iOS
• مکان‌های SDK برای iOS
• Navigation SDK برای iOS
• Places API
• Places Aggregate API
• Address Validation API
• Aerial View API
• API کیفیت هوا
• Pollen API
• API خورشیدی
• Map Tiles API
• Maps Datasets API

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

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

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

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

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

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

• Maps JavaScript API
• API کدگذاری جغرافیایی
• Routes API
• Places API
• Maps Static API

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

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

کد زبان	زبان	کد زبان	زبان
af	آفریقایی	ja	ژاپنی
مربع	آلبانیایی	kn	کانادا
هستم	آمهری	kk	قزاقستان
ar	عربی	کیلومتر	خمر
هی	ارمنی	ko	کره ای
az	آذربایجانی	ky	قرقیزستان
اتحادیه اروپا	باسکی	اینجا	لائوس
باشد	بلاروسی	lv	لتونی
bn	بنگالی	آن	لیتوانیایی
bs	بوسنیایی	mk	مقدونی
bg	بلغاری	ام‌اس	مالایی
من	برمه ای	میلی لیتر	مالایایی
حدود	کاتالان	آقای	مراتی
zh	چینی	دقیقه	مغولی
zh-CN	چینی (ساده شده)	ne	نپالی
zh-HK	چینی (هنگ کنگ)	نه	نروژی
zh-TW	چینی (سنتی)	pl	لهستانی
ساعت	کروات	pt	پرتغالی
cs	چک	pt-BR	پرتغالی (برزیل)
دا	دانمارکی	pt-PT	پرتغالی (پرتغال)
nl	هلندی	pa	پنجابی
en	انگلیسی	ro	رومانیایی
en-AU	انگلیسی (استرالیایی)	ru	روسی
en-GB	انگلیسی (بریتانیا کبیر)	sr	صربی (سیریلیک)
et	استونیایی	sr-Latn	صربی (خط لاتین)
فا	فارسی	سی	سینهالی
فی	فنلاندی	sk	اسلواکی
فایل	فیلیپینی	sl	اسلوونیایی
fr	فرانسوی	es	اسپانیایی
fr-CA	فرانسوی (کانادا)	es-419	اسپانیایی (آمریکای لاتین)
gl	گالیسیایی	sw	سواحیلی
کا	گرجی	sv	سوئدی
de	آلمانی	تا	تامیل
el	یونانی	شما	تلوگو
گو	گجراتی	هفتم	تایلندی
iw	عبری	tr	ترکی
سلام	هندی	انگلستان	اوکراینی
هو	مجارستانی	ur	اردو
است	ایسلندی	uz	ازبکستان
شناسه	اندونزیایی	vi	ویتنامی
آن را	ایتالیایی	zu	زولو

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

آیا می توان از طریق HTTPS (TLS) به پلتفرم نقشه های گوگل دسترسی داشت؟

همه پلتفرم های نقشه های گوگل می توانند و باید از طریق HTTPS قابل دسترسی باشند. برای اثبات برنامه های خود در آینده، ما قویاً توصیه می کنیم از TLS 1.3 برای HTTPS استفاده کنید. اگرچه نسخه‌های قدیمی‌تر TLS هنوز پشتیبانی می‌شوند، توصیه می‌کنیم به نسخه‌های قدیمی TLS قدیمی 1.0 و 1.1 اعتماد نکنید.

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

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

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

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

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

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

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

چگونه Google Maps Platform API ها از کوکی های سایت استفاده می کنند؟

نقشه SDK را برای Android و نقشه SDK برای iOS از کوکی های مشمول سیاست حفظ حریم خصوصی Google ، مانند محاسبه کاربران فعال روزانه و 7 روزه و پیشگیری از سوء استفاده از خدمات استفاده کنید. این کوکی ها با هیچ حساب Google در Google همراه نیستند و با بقیه اطلاعات جمع آوری شده از تماس های API ثبت نشده اند.

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

تیم روابط توسعه دهنده Google حضور در Onlowow Stack را حفظ می کند-یک سؤال و پاسخ به ویرایش مشترک برای برنامه نویسان. این یک مکان عالی برای پرسیدن سوالات فنی در مورد توسعه و نگهداری برنامه های Google Maps است. اطلاعات بیشتر در مورد پرسیدن سوالات در مورد Overflow در صفحه پشتیبانی در دسترس است.

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

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

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

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

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

• Maps JavaScript API
• Maps Static API
• Maps Datasets API
• API استاتیک نمای خیابان
• Maps Embed API
• Elevation API
• API کدگذاری جغرافیایی
• API مکان جغرافیایی
• Routes API
• Roads API
• API منطقه زمانی
• Places API
• Address Validation API

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

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

آیا از کلید API استفاده می کنید؟

من مطمئن نیستم. چگونه می توانم بررسی کنم که آیا از یک کلید API استفاده می کنم؟

یک کلید API به عنوان پارامتر key در URL که برای بارگیری نقشه های API JavaScript استفاده می شود ، منتقل می شود. در اینجا چند گزینه برای بررسی اینکه آیا از یک کلید API استفاده می کنید ، آورده شده است:

• از پسوند Chrome API Checker Platform Google Maps استفاده کنید. این امر به شما امکان می دهد تعیین کنید که آیا وب سایت شما به درستی API های دارای مجوز Google را اجرا می کند یا خیر.
• اگر از یک کتابخانه یا افزونه برای بارگیری نقشه های JavaScript API استفاده می کنید ، تنظیمات آن کتابخانه را بررسی کرده و به دنبال گزینه کلید API باشید.
• خطاها را در مرورگر خود بررسی کنید. اگر پیام های زیر را مشاهده می کنید ، از کلید API خود به درستی استفاده نمی کنید:
• Google Maps JavaScript API هشدار: Noapikeys
• Google Maps JavaScript API خطای API: MissingKeyMaperror

برای توسعه دهندگان وب:

• اگر به کد منبع برنامه خود دسترسی دارید ، به دنبال برچسب <script> باشید که برای بارگیری نقشه های JavaScript API استفاده می شود. هنگام بارگیری نقشه های JavaScript API ، YOUR_API_KEY در کد زیر با کلید API خود جایگزین کنید.

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>

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

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

برای به دست آوردن یک کلید API ، روی دکمه زیر کلیک کنید. اگر یک راه اندازی هدایت شده را مشاهده نمی کنید ، دستورالعمل های کامل را در شروع کار با Google Maps Platform دنبال کنید.
شروع کنید

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

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

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

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

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

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

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

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

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

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

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

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

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

آیا محدودیت روزانه خود تحمیل شده در API وجود دارد؟

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

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

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

آیا کلید API شما محدودیت آدرس IP دارد؟

کلیدهای API با محدودیت آدرس IP فقط با سرویس های وب که برای استفاده از سمت سرور در نظر گرفته شده است (مانند API GeoCoding و سایر API های سرویس وب ) استفاده می شود. بیشتر این سرویس های وب دارای خدمات معادل در نقشه های JavaScript API هستند (برای مثال ، به سرویس GeoCoding مراجعه کنید). برای استفاده از نقشه های Side Client Client JavaScript API ، باید یک کلید API جداگانه ایجاد کنید که با محدودیت مراجعه کننده HTTP قابل ایمن باشد (مراجعه کنید ، اضافه کنید ، اضافه کنید و یک کلید API را محدود کنید ).

چگونه می توانم کدهای خطا را حل کنم: OVER_DAILY_LIMIT یا OVER_QUERY_LIMIT ؟

این کدهای خطا به هر یک از دلایل زیر قابل بازگشت است:

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

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

• یک حساب صورتحساب تنظیم کنید .
• یک کلید جدید API دریافت کنید .
• درپوش استفاده خود را تنظیم کنید تا حد سهمیه روزانه خود را افزایش دهید (در صورت لزوم).

چگونه می توان کدهای خطا را برطرف کرد: kGMSPlacesRateLimitExceeded یا 9005 PLACES_API_RATE_LIMIT_EXCEEDED ؟

اگر می بینید kGMSPlacesRateLimitExceeded یا 9005 PLACES_API_RATE_LIMIT_EXCEEDED ، ممکن است از نسخه مستهجن از مکان های SDK برای Android یا مکان های SDK برای iOS استفاده کنید. بیشتر بدانید و SDK های جدید را در https://goo.gle/places-sdk-deprecation پیدا کنید.

چگونه می توانم خطای را حل کنم: "این IP ، سایت یا برنامه موبایل مجاز به استفاده از این کلید API نیست."

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

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

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

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

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

چگونه می توانم خطای را حل کنم: "کلیدهای API با محدودیت های ارجاع با این API قابل استفاده نیستند."

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

Google Maps Services Platform

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

بله ، این فرایند "GeoCoding" نامیده می شود. نقشه های JavaScript API شامل کلاس برای انجام یک سرویس جغرافیایی است. کلاس: Google.maps.geocoder .

از طرف دیگر ، Google همچنین API GeoCoding را ارائه می دهد ، که یک رابط REST ارائه می دهد که می تواند در قالب های JSON و XML پاسخ دهد.

GeoCoding در کدام کشورها موجود است؟

برای دیدن کشورهایی که توسط GeoCoders پلت فرم Google Maps پشتیبانی می شوند ، با داده های پوشش Google Maps مشورت کنید.

صحت مکانهای جغرافیایی ممکن است در هر کشور متفاوت باشد ، بنابراین شما باید از قسمت برگشتی مکان بازگشت_تایپ استفاده کنید تا مشخص شود که آیا یک مسابقه به اندازه کافی خوب برای اهداف برنامه شما پیدا شده است یا خیر. در دسترس بودن داده های GeoCoding به قراردادهای ما با ارائه دهندگان داده بستگی دارد ، بنابراین در معرض تغییر است.

چرا Google Maps GeoCoders پلتفرم مکانهای مختلفی نسبت به نقشه های Google ارائه می دهد؟

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

چگونه باید نمایش داده های GeoCoder خود را برای به حداکثر رساندن تعداد درخواست های موفق قالب بندی کنم؟

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

• آدرس ها را مطابق با فرمت استفاده شده توسط سرویس ملی پستی کشور مورد نظر مشخص کنید.
• عناصر آدرس اضافی مانند نام تجاری ، شماره واحد ، شماره کف یا شماره مجموعه را که در آدرس موجود نیست ، مطابق با سرویس پستی کشور مورد نظر مشخص نکنید. انجام این کار ممکن است منجر به پاسخ با ZERO_RESULTS شود.
• قالب به علاوه کدهای همانطور که در اینجا نشان داده شده است (به علاوه علائم URL به %2B تبدیل شده و فضاها URL به %20 تبدیل شده اند):
  • کد جهانی یک کد منطقه 4 کاراکتر و 6 کاراکتر یا کد محلی طولانی تر است (849VCWC8+R9 849VCWC8%2BR9 است).
  • کد مرکب یک کد 6 کاراکتر یا طولانی تر با مکان صریح است (CWC8+R9 Mountain View ، CA ، USA CWC8%2BR9%20Mountain%20View%20CA%20USA ) است.
• در صورت امکان از شماره خیابان یک فرضیه استفاده کنید.
• در اولویت برای مشخص کردن خیابان های صلیب در صورت امکان از آدرس شماره خیابان استفاده کنید.
• "نکات" مانند نقاط دیدنی در نزدیکی را ارائه ندهید.

چگونه باید آدرس ایالات متحده را در یک بزرگراه شماره گذاری شده برای GeoCoding قالب بندی کنم؟

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

• جاده های شهرستان: "Co Road NNN " که NNN شماره جاده است. به عنوان مثال "Co Road 82"
• بزرگراه های ایالتی: " State NNN " که در آن ایالت نام کامل دولت است و NNN شماره بزرگراه است. به عنوان مثال "California 82"
• بزرگراه های ایالات متحده: "US NNN " که در آن شماره بزرگراه است. به عنوان مثال "US 101"
• Interstates ایالات متحده: "Interstate NNN " که NNN شماره بین المللی است. به عنوان مثال "Interstate 280"

چه موقع باید از کلاس GeoCoder API استفاده کنم و چه زمانی باید از سرویس GeoCoding HTTP استفاده کنم؟

به سند مراجعه کنید: استراتژی های GeoCoding ، که جزئیات و محدودیت های استراتژی های مختلف جغرافیایی را شرح می دهد.

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

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

رابط درخواست/پاسخ HTTP (استفاده شده در موبایل و سایر برنامه ها) با نقشه SDK برای Android و سایر خدمات وب Google Maps سازگار است.

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

برای دیدن کشورهایی که با استفاده از مسیرهای رانندگی در Google Maps Platform Products پشتیبانی می شوند ، با داده های پوشش Google Maps مشورت کنید. در دسترس بودن داده های جهت رانندگی به قراردادهای ما با ارائه دهندگان داده بستگی دارد و در معرض تغییر است.

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

API Routes از همه شرکای Google Transit پشتیبانی می کند ، به جز شرکت پذیرایی و گردشگری راه آهن هند و شرکت های ژاپن.

کدام ویژگی های KML و Georss در نقشه های API JavaScript پشتیبانی می شوند؟

کلاس Kmllayer در نقشه های JavaScript API به توسعه دهندگان این امکان را می دهد تا پرونده های KML/KMZ و Georss را در بالای نقشه پوشش دهند. برای اسناد و نمونه ها ، به کلاس Kmllayer مراجعه کنید.

محدودیت های اندازه و پیچیدگی KML که می تواند با استفاده از کلاس Kmllayer از نقشه های JavaScript API نمایش داده شود چیست؟

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

چگونه می توانم پرونده های KML را که در سایت های اینترانت میزبان هستند ، ارائه دهم؟

کلاس KmlLayer که در نقشه های JavaScript API پوشش KML ایجاد می کند ، از یک سرویس میزبان Google برای بازیابی و تجزیه پرونده های KML برای ارائه استفاده می کند. در نتیجه ، نمایش پرونده های KML که در URL میزبانی نشده اند که در دسترس عموم باشد ، یا نیاز به تأیید اعتبار برای دسترسی ندارد ، امکان پذیر نیست.

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

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

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

توجه داشته باشید که URL های API استاتیک نقشه ها می توانند حداکثر تقریباً 8192 کاراکتر را شامل شوند که تعداد نشانگرها و راس های مسیر را محدود می کند که می توانند بر اساس تعداد مکان های اعشاری مورد استفاده در هنگام مشخص کردن هر جفت عرض جغرافیایی مشخص شوند. برای کسب اطلاعات در مورد چگونگی ارتباط تعداد اعشاری مورد استفاده با صحت روی زمین ، به مقاله ویکی پدیا در مورد درجه های اعشاری مراجعه کنید.

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

API MAPS ممکن است در سرزمین های ممنوعه استفاده نشود. همچنین به شرایط خدمات مراجعه کنید.

چگونه می توانم مشکلی را در پایه Google گزارش کنم؟

ارسال بازخورد از طریق نقشه های Google برای اطلاعات اشتباه یا گمشده نقشه مانند:

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

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

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

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

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

برخی از ویژگی های سمت مشتری برای گزارش موفقیت یا عدم موفقیت به منظور محاسبه SLO (هدف سطح خدمات) استفاده شده است. این اطلاعات در maps.googleapis.com/maps_api_js_slo/log در تماس هایی که اطلاعات SLO را وارد می کنند ، به Google ارسال می شود. این اطلاعات شامل وضعیت موفقیت ، تأخیر و نسخه/کانال نقشه های API JavaScript در حال استفاده است. تماس ها ممکن است برای عملکرد انجام شود. ممکن است لازم باشد در سیاست امنیت محتوای خود 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

نقشه های JavaScript API پس از بارگیری چه مدت کار می کنند؟

شما باید صفحه ای را که حداقل یک بار 5 روز یک بار نقشه های JavaScript را بارگیری می کند ، تازه کنید.

Google Maps SDK برای iOS

چگونه می توانم خطا را حل کنم: kGMSPlacesRateLimitExceeded ؟

اگر این خطا را مشاهده می کنید ، ممکن است از نسخه مستهجن مکان های SDK برای iOS استفاده کنید. نسخه 2.7.0 از مکان های SDK برای iOS خاموش شده است و دیگر در دسترس نیست. برنامه خود را به روز کنید تا در اسرع وقت از آخرین نسخه استفاده کنید. برای جزئیات بیشتر به راهنمای مهاجرت مراجعه کنید.

هنگام اشکال زدایی با دستگاه iOS 8.x ، تصادف می کنم. چه کار کنم؟

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

1. در Xcode ، محصول ، طرح ، مدیریت طرح ها را انتخاب کنید.
2. یک طرح را انتخاب کنید و ویرایش را انتخاب کنید ...
3. گزینه GPU Frame Capture را روی Disabled تنظیم کنید. توجه داشته باشید که این گزینه ممکن است برای همه دستگاه ها وجود نداشته باشد.

تأثیر صفحه نمایش های گرد و گسترده تر در Google Maps iOS SDK چیست؟

با شروع آیفون X ، آیفون ها دارای شکل صفحه نمایش هستند که دارای گوشه های گرد ، شکاف در قسمت بالا برای محفظه سنسور دستگاه و یک نشانگر در پایین صفحه برای دسترسی به صفحه اصلی است. از نظر iOS 11.0 SDK ، اپل API منطقه امن را اضافه کرد و به توسعه دهندگان این امکان را می دهد تا عناصر را در منطقه ای قرار دهند که از شکل صفحه نمایش جدید در امان باشد.

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

با انتشار نسخه های Google Maps IOS SDK 2.5 ، این مشکلات طرح بندی به طور خودکار برطرف می شود. هنگامی که برنامه شما در آیفون X یا بعد از آن استفاده می شود ، بالشتک در GMSmapView و Gmspanoramaview افزایش می یابد تا عناصر بصری قطع نشوند.

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

اگر رابط کاربری طراحی کرده اید که با تنظیم پیش فرض ما کار نمی کند ، ما یک ویژگی جدید را به GMSmapview با نام PaddingAdustmentBehavior معرفی کرده ایم. برای انتخاب یکی از سه رفتار تنظیمات تنظیم شده از GMSmapView استفاده کنید: "همیشه" (پیش فرض) ، "اتوماتیک" و "هرگز".

اگر قرار است GmsMapView از رفتار "همیشه" استفاده کند ، همیشه قسمت های امن منطقه را به بالشتک اضافه می کند. این تنظیم به شما امکان می دهد رابط خود را با این فرض که تمام محل قرارگیری از لبه های منطقه امن است ، طراحی کنید. این مقدار پیش فرض است.

اگر GmsMapView از رفتار بالشتک "اتوماتیک" استفاده کند ، همیشه بزرگتر از بالشتک یا قسمت امن منطقه را انتخاب می کند. این تنظیم به شما امکان می دهد تا ضمن اطمینان از اینکه همه عناصر در منطقه امن باقی می مانند ، بالشتک را از لبه صفحه اضافه کنید.

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

در مقابل ، Gmspanoramaview خاصیت بالشتک اختیاری ندارد. این بدان معنی است که هیچ بالینی برای تنظیم وجود ندارد و Gmspanoramaview همیشه از هر نوع بالشتک لازم استفاده می کند تا تمام عناصر بصری در منطقه امن قرار بگیرند.

Google Maps SDK برای Android

چگونه می توانم خطا را برطرف کنم: 9005 PLACES_API_RATE_LIMIT_EXCEEDED ؟

اگر این خطا را مشاهده می کنید ، ممکن است از یک نسخه مستهجن از مکان های SDK برای Android استفاده کنید. نسخه Google Play Services از مکان های SDK برای Android خاموش شده است و دیگر در دسترس نیست. برنامه خود را به روز کنید تا در اسرع وقت از آخرین نسخه استفاده کنید. برای جزئیات بیشتر به راهنمای مهاجرت مراجعه کنید.

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

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

1. اطمینان حاصل کنید که ADB نصب شده است. اگر اینگونه نباشد ، می توانید راهنمای Android ADB را دنبال کنید.
2. برنامه ای را که مشکل را در یک دستگاه یا یک شبیه ساز اندرویدی نشان می دهد نصب کنید. اگر از Android Emulator استفاده می کنید ، اطمینان حاصل کنید که تنظیمات شبیه ساز شامل فروشگاه Play است.
3. در ترمینال Android Studio ، adb logcat -e "Google Maps Android API" را اجرا کنید. این فقط خطوطی را چاپ می کند که در آن پیام ورود به سیستم با "Google Maps Android API" مطابقت دارد (به صورت اختیاری ، می توانید با ضمیمه:> logcat.txt ورود به یک پرونده متنی را وارد کنید.
4. مسئله را در دستگاه خود بازتولید کنید و خطاهای متداول مانند:
• کلید API اشتباه/ناخواسته در مانیفست ارجاع می شود.
• صورتحساب در پروژه فعال نیست.
• SDK در API های پروژه فعال نیست.
• اثر انگشت نادر SHA-1 به محدودیت های اصلی API اضافه می شود.
• وابستگی های سرویس Google Play در پرونده build.gradle گنجانده نشده است.

امضای URL

آیا می توانم URL ها را با استفاده از JavaScript امضا کنم؟

ما اکیداً در مورد امضای URL با استفاده از JavaScript توصیه می کنیم زیرا این امر می تواند راز URL شما را برای کاربران نهایی در معرض نمایش قرار دهد. بنابراین امضاها فقط باید توسط اجزای جانبی سرور ایجاد شوند.

چرا من یک پاسخ ممنوع HTTP 403 به درخواست های سرویس وب API نقشه های خود دریافت می کنم؟

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

1. امضا مشخص شده است اما برای این درخواست نادرست است.
2. این درخواست یک برنامه حق بیمه پلتفرم Google Maps یک کلید API را مشخص می کند اما امضای آن را مشخص نمی کند ، و این سرویس که خوانده می شود نیاز دارد که درخواست های انجام شده با استفاده از یک کلید API شامل یک امضای معتبر باشد.
3. امضای مشخص شده است اما کلید API PLAN PLAM PLAMIUM PLATOM PLATOM PLATOM Google Associated مشخص نشده است.

،

شروع به کار

• پلتفرم Google Maps چیست؟
• چگونه می توانم با سیستم عامل Google Maps شروع کنم؟
• به کدام API نیاز دارم؟
• چگونه می توانم استفاده از API ها را در سایت خود شروع کنم؟
• نقشه های Google Maps کدام کشورها را پوشش می دهد؟
• آیا می توانم Google Maps را بدون استفاده از محصولات Google Maps Platform در سایت خود قرار دهم؟
• چگونه می توانم برنامه های نقشه را در دستگاه های تلفن همراه ارائه دهم؟
• نقشه های API JavaScript API و نقشه های API را در کدام مرورگرهای وب قرار می دهند؟
• آیا می توانم نقشه ها را از نقشه های JavaScript API چاپ کنم؟
• چگونه می توان هنگام تغییر در محصولات پلت فرم Google Maps به من اطلاع داد؟
• چگونه با پشتیبانی فنی تماس بگیرم؟
• چه زمانی پشتیبانی فنی موجود است؟
• چگونه می توانم دسترسی به حساب Google خود را بازیابی کنم؟
• چگونه می توانم دسترسی به یک پروژه خاص را بازیابی کنم؟
• آیا می توانم از نقشه ها و مکان های SDK برای iOS در MAC های مبتنی بر بازو استفاده کنم؟

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

• شرایط خدمات برای Google Maps Platform محصولات چیست؟
• آیا سایت من با شرایط خدمات پلت فرم Google Maps مطابقت دارد؟
• آیا می توانم به طور مستقیم به کاشی های نقشه و تصاویر ماهواره ای دسترسی پیدا کنم؟
• آیا می توانم برای ردیابی برنامه ها از محصولات پلت فرم Google Maps استفاده کنم؟
• آیا می توانم از Google Maps Platform Products در برنامه غیر WEB خود استفاده کنم؟
• آیا می توانم از محصولات Google Maps Platform در سایتی که از رمز عبور محافظت می شود استفاده کنم؟
• آیا می توانم برنامه ای ایجاد کنم که شامل داده های پلتفرم Google Maps در یک سند باشد؟
• چگونه می توانم از شامل محتوای خود در نتایج جستجوی Google خودداری کنم؟
• آیا می توانم با استفاده از API Static Maps که من از وب سایت خود ذخیره و در آن سرو می کنم ، یک تصویر نقشه ایجاد کنم؟

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

• چگونه می توانم صورتحساب را برای پروژه خود تنظیم کنم؟
• چگونه Google Cloud Cloud Free Tier مشتریان به یک حساب پرداخت شده ارتقا می یابد؟
• آیا Google Maps Platform محدودیت استفاده دارد؟
• هزینه استفاده چگونه محاسبه می شود؟
• چگونه بارهای نقشه در پلت فرم Google Maps شمارش می شوند؟
• چگونه می توانم استفاده از سهمیه خود را کنترل کنم؟
• چه اتفاقی می افتد اگر من از محدودیت های استفاده فراتر بروم؟
• سایت من ترافیک زیادی می کند. آیا می توانم از محصولات Google Maps Platform استفاده کنم؟
• اگر وب سایت یا برنامه من به طور ناگهانی محبوب شود ، آیا نقشه های من متوقف می شوند؟
• چگونه استفاده از آن محاسبه و صورتحساب می شود؟
• هزینه استفاده از پلتفرم Google Maps چقدر است؟
• آیا قیمت گذاری در ارزهای دیگر موجود است؟
• من صورتحساب را تنظیم کرده ام. چگونه صورتحساب خود را مشاهده می کنم؟
• اگر استفاده از من به طور غیر منتظره ای افزایش یابد ، چگونه می توانم از یک قبض بزرگ جلوگیری کنم؟
• من پیامی دریافت کردم که می گوید پروژه من به "حساب انتقال پلت فرم Google Maps" مرتبط است ، اما من به آن حساب دسترسی ندارم. چه کار کنم؟
• چرا حد سهمیه من روی 1 درخواست در روز تعیین می شود؟ چگونه می توانم این حد را بالا ببرم؟
• من یک اخطار نقض صورتحساب دریافت کردم. چگونه این را حل کنم؟

از سیستم عامل Google Maps استفاده کنید

• از کدام کلیدها یا اعتبارنامه ها برای محصولات مختلف پلت فرم Google Maps استفاده می کنم؟
• چگونه می توانم نوع محدودیت اصلی خود را از یک مرجع HTTP به محدودیت آدرس IP تغییر دهم؟
• چگونه می توانم یک کلید جدید API دریافت کنم؟
• چگونه می توانم تغییرات معرفی شده در هر نسخه از پلت فرم Google Maps را پیدا کنم؟
• چگونه می توانم بعد از بارگیری صفحه ، API را به صورت ناهمزمان بارگذاری کنم؟
• چگونه می توانم محصولات Google Maps Platform را به زبانی غیر از انگلیسی نمایش دهم؟
• آیا می توان از پلتفرم Google Maps از طریق HTTPS (TLS) دسترسی پیدا کرد؟
• چگونه می توانم یک اشکال را گزارش کنم یا از ویژگی های جدید در پلت فرم Google Maps درخواست کنم؟
• چگونه Google Maps Platform API ها از کوکی های سایت استفاده می کنند؟
• من نمی توانم جواب سوال خود را پیدا کنم. با چه کسی تماس بگیرم؟

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

• این خطا به چه معناست؟
• نقشه های من تاریک تر از حد معمول به نظر می رسند. چه اتفاقی می افتد؟
• چگونه می توان کدهای خطا را OVER_DAILY_LIMIT یا OVER_QUERY_LIMIT حل کرد؟
• چگونه می توان کدهای خطا را برطرف کرد: kGMSPlacesRateLimitExceeded یا 9005 PLACES_API_RATE_LIMIT_EXCEEDED ؟
• چگونه می توانم خطای را حل کنم: "این IP ، سایت یا برنامه موبایل مجاز به استفاده از این کلید API نیست."
• چگونه می توانم خطای را حل کنم: "کلیدهای API با محدودیت های ارجاع با این API قابل استفاده نیستند."

Google Maps Services Platform

• من باید آدرس ها را به جفت های عرض جغرافیایی/طول جغرافیایی تبدیل کنم. آیا می توانم این کار را با سیستم عامل Google Maps انجام دهم؟
• GeoCoding در کدام کشورها موجود است؟
• چرا GeoCoders پلت فرم Google Maps مکان های مختلفی نسبت به Google Maps ارائه می دهد؟
• چگونه باید نمایش داده های GeoCoder خود را برای به حداکثر رساندن تعداد درخواست های موفق قالب بندی کنم؟
• چگونه باید آدرس ایالات متحده را در یک بزرگراه شماره گذاری شده برای GeoCoding قالب بندی کنم؟
• چه موقع باید از کلاس GeoCoder API استفاده کنم و چه زمانی باید از سرویس GeoCoding HTTP استفاده کنم؟
• چگونه می توانم مسیرهای رانندگی را با پلت فرم Google Maps ارائه دهم؟
• در کدام کشورها جهت رانندگی در دسترس هستند؟
• در کدام کشورها مسیرهای ترانزیت در دسترس هستند؟
• کدام ویژگی های KML و Georss در نقشه های API JavaScript پشتیبانی می شوند؟
• محدودیت های اندازه و پیچیدگی KML که می تواند با استفاده از کلاس Kmllayer از نقشه های JavaScript API نمایش داده شود چیست؟
• چگونه می توانم پرونده های KML را که در سایت های اینترانت میزبان هستند ، ارائه دهم؟
• حداکثر تعداد نشانگرها یا راس های مسیر پشتیبانی شده توسط API استاتیک نقشه ها چیست؟
• چرا نمی توانم برای کشورهای خاص به محصولات پلت فرم Google Maps دسترسی پیدا کنم؟
• چگونه می توانم مشکلی را در پایه Google گزارش کنم؟
• چگونه عملکرد برای خدمات مورد استفاده در نقشه های JavaScript API کنترل می شود؟

Maps JavaScript API

• نقشه های JavaScript API پس از بارگیری چه مدت کار می کنند؟

Google Maps SDK برای iOS

• چگونه می توانم خطا را حل کنم: kGMSPlacesRateLimitExceeded ؟
• هنگام اشکال زدایی با دستگاه iOS 8.x ، تصادف می کنم. چه کار کنم؟
• تأثیر صفحه نمایش های گرد و گسترده تر در Google Maps iOS SDK چیست؟

Google Maps SDK برای Android

• چگونه می توانم خطا را حل کنم: 9001 Operation failed due to exceeding the quota usage limit ؟
• برنامه من فقط کاشی های خاکستری خالی را به جای نقشه نشان می دهد. چگونه می توانم این را حل کنم؟

امضای URL

• آیا می توانم URL ها را با استفاده از JavaScript امضا کنم؟
• چرا من یک پاسخ ممنوع HTTP 403 به درخواست های سرویس وب API نقشه های خود دریافت می کنم؟

شروع به کار

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

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

نقشه ها:

• Maps JavaScript API
• Maps SDK برای اندروید
• Maps SDK برای iOS
• Map Tiles API
• Aerial View API
• Maps Static API
• API استاتیک نمای خیابان
• URL های نقشه ها
• Maps Embed API
• Maps Datasets API

مسیرها:

• Routes API
• Roads API
• API بهینه سازی مسیر
• Navigation SDK برای اندروید
• Navigation SDK برای iOS

مکان ها:

• Places API
• مکان‌های SDK برای Android
• مکان‌های SDK برای iOS
• کتابخانه مکان‌ها، Maps JavaScript API
• Places Aggregate API
• Address Validation API
• API کدگذاری جغرافیایی
• API مکان جغرافیایی
• API منطقه زمانی

محیط زیست:

• API کیفیت هوا
• Pollen API
• API خورشیدی

چگونه می توانم با سیستم عامل Google Maps شروع کنم؟

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

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

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

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

به نمای کلی ، توسعه دهنده مراجعه کنید و راهنماهای مربوط به API خاص یا SDK را که به آن علاقه مند هستید شروع کنید. به عنوان مثال ، راهنماهای نقشه SDK را برای Android یا Maps JavaScript API بررسی کنید.

نقشه های Google Maps کدام کشورها را پوشش می دهد؟

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

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

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

آیا می توانم Google Maps را بدون استفاده از محصولات Google Maps Platform در سایت خود قرار دهم؟

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

چگونه می توانم برنامه های نقشه را در دستگاه های تلفن همراه ارائه دهم؟

برای ترکیب نقشه ها در یک برنامه Android ، از MAPS SDK برای Android استفاده کنید.

برای ترکیب نقشه ها در یک برنامه iOS ، از نقشه SDK برای iOS استفاده کنید.

نقشه های JavaScript API برای تهیه دستگاه های تلفن همراه تهیه شده است و برای برنامه های مرورگر که در هر دو دسک تاپ و دستگاه هایی که شامل یک مرورگر وب با اجرای کامل JavaScript مانند اپل آیفون است ، مناسب است.

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

نقشه های API JavaScript API و نقشه های API را در کدام مرورگرهای وب قرار می دهند؟

نقشه های API و نقشه های جاوا اسکریپت API از مرورگرهای وب زیر پشتیبانی می کنند:

دسکتاپ

• نسخه فعلی Microsoft Edge (ویندوز) ، به استثنای حالت IE.
• The two latest major stable versions of Firefox (Windows, macOS, Linux).
• The two latest major stable versions of Chrome (Windows, macOS, Linux).
• The two latest major stable versions of Safari (macOS).

اندروید

• The current version of Chrome on Android 4.1+.
• Chrome WebView on Android 4.4+.

iOS

• Mobile Safari on the current and previous major versions of iOS.
• UIWebView and WKWebView on the current and previous major versions of iOS.
• The current version of Chrome for iOS.

Can I print maps from the Maps JavaScript API?

Printing from the Maps JavaScript API is not supported. This is because printing support is inconsistent across commonly used browsers.

How can I be notified when there are changes to Google Maps Platform products?

You should subscribe to the Google Maps Platform Blog for news updates across the various Google Geo developer offerings.

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

See Google Maps Platform Support and Resources for information about available support options.

When is technical support available?

The support team is available 24x5 (weekdays from Monday 9 AM Tokyo time to Friday 5 PM Pacific time) excluding regional holidays for "service unusable" issues.

How can I recover access to my Google Account?

If you lost access to your Google Account (eg [e-mail] or [e-mail]), you can try restoring the account access by retrieving or resetting your password. Visit the How to recover your Google Account or Gmail article in Google Account Help.

• Note: To restore access to a G Suite account, ask your Organization administrator to undelete the account .

How can I recover access to a specific project?

If you lost access to the project where you manage your Google Maps Platform implementation, you can try to recover it.

If you have access to your project-associated Google Account:

• If you know the Project Owner and have access to your Google Account: Ask the Project Owner to add you as a Project Owner or Project Editor .
  • If your project is part of an Organization: Contact your Organization admins and ask them to add you as a Project Owner .
• If you don't know any of the current Project Owners: If you don't know who the Project Owner is, or the Project Owner is unavailable, contact the support team to explore additional options to recover the project.

If you don't have access to your project-associated Google Account:

• If you lost access to your Google Account: try to recover your username or password for your account.
• If you cannot recover access to your Google Account: Create a new Google Account, then contact an existing project owner and ask them to add your new Google Account to the project .

Can I use the Maps and Places SDK for iOS on Arm-based Macs?

Developing on the new Arm-based Macs is possible, however, it requires building and running on a physical iOS device. This is a temporary limitation while we look into adding more support for developing on simulators.

Understand the terms of service

What are the terms of service for Google Maps Platform products?

The Google Maps Platform Terms of Service are available at:

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

Does my site meet the Google Maps Platform Terms of Service?

You can use Google Maps Platform within your applications as long as your site meets the Google Maps Platform Terms of Service .

However, there are some uses of Google Maps Platform that we just don't want to see. For example, maps that identify the places to buy illegal drugs in a city or any other illegal activity. We also respect people's privacy, so Google Maps Platform shouldn't be used to identify private information about individuals.

You should use your own counsel to determine whether your application complies with the Google Maps Platform Terms of Service before you develop and launch it. Google engineers can only offer technical assistance and are not qualified to offer legal advice. Google reserves the right to suspend or terminate your use of the service at any time, so read the Maps APIs Terms carefully.

Can I directly access map tiles and satellite imagery?

You may not access map tiles or satellite imagery through any mechanism besides Google Maps Platform (such as the creation of your own mapping API or the use of a bulk tile download script). Your application's access to the tiles will be blocked if it accesses them outside of Google Maps Platform. See the Google Maps Platform Terms of Service for more details.

Can I use Google Maps Platform products for tracking applications?

There is no restriction on displaying real-time data (tracking) with Google Maps Platform products provided that the application complies with the Google Maps Platform Terms of Service.

Can I use Google Maps in my non-Web application?

Yes, Google Maps Platform products can now be used in non-Web applications, provided that they adhere to the other restrictions of the Google Maps Platform Terms of Service.

The Maps JavaScript API is only supported when run in one of the supported browsers .

Can I use Google Maps Platform products on a site that is password protected?

Yes, Google Maps, Routes, Places, and Environment services can be used with private-access applications. See the Google Maps Platform Terms of Service for more details.

Can I create an application that includes Google Maps Platform data in a document?

If your application generates a document, either in electronic or printed form, no data from Google Maps Platform, including images, may be included in the document. See the Google Maps Platform Terms of Service "No Scraping" section for more details.

How can I opt out of including my content in Google Search results?

We are no longer collecting this data. The use of the indexing parameter has been deprecated and has no effect. You no longer need to opt out explicitly, but we encourage you to remove this parameter at your earliest convenience.

To remove your page or site from search results, follow the instructions provided in our help center.

Can I generate a map image using the Maps Static API which I store and serve from my website?

You may not store and serve copies of images generated using the Maps Static API from your website. All web pages that require static images must link the src attribute of an HTML img tag or the CSS background-image attribute of an HTML div tag directly to the Maps Static API so that all map images are displayed within the HTML content of the web page and served directly to end users by Google.

Usage limits and billing

How do I set up billing for my project?

See Get Started with Google Maps Platform .

How do Google Cloud Free Tier customers upgrade to a paid account?

The Google Cloud Free Tier program provides customers a no-charge trial with a $300 credit to use with any Google Cloud service, including Google Maps Platform (GMP) APIs. When the free trial period ends, you must upgrade to a paid account to continue using these services. To upgrade to a paid account, visit the Cloud console .

Does Google Maps Platform have usage limits?

There are no maximum daily limits on the number of requests you can make to Google Maps Platform products, and the only usage limits are related to the maximum number of queries per minute (QPM).

Notes: For Compute Route Matrix requests, the limit is in elements per minute (EPM), where the number of elements in a request is equal to: (number of origins times number of destinations).

For the Navigation SDKs, each destination in a request is counted as a separate query.

The following table shows the usage limit for each API. You can view and modify quota limits in the Cloud Console .

API	Usage limit
اعتبار سنجی آدرس	6,000 QPM
Aerial View: Lookup Video	180 QPM and 100,000 QPD
Aerial View: Render Video	100 QPM and 100 QPD
کیفیت هوا	6,000 QPM
Maps JavaScript API: 3D Maps	30,000 QPM
Maps JavaScript API: Dynamic Maps	30,000 QPM
ارتفاع	6,000 QPM
ژئوکدینگ	3,000 QPM
موقعیت جغرافیایی	6,000 QPM
Map Tiles API: 2D Map Tiles	6,000 QPM and 15,000 QPD
Map Tiles API: Street View Tiles	6,000 QPM and 15,000 QPD
Map Tiles API: Photorealistic 3D Tiles	12,000 QPM and 10,000 root requests per day.
Navigation: Set destination requests	30,000 QPM
مکان ها	6,000 QPM
مجموع مکان ها	1,200 QPM
گرده	6,000 QPM
جاده ها	30,000 QPM
Routes: Compute Routes	3,000 QPM
Routes: Compute Route Matrix	3,000 EPM
خورشیدی	600 QPM
نقشه های ایستا	30,000 QPM
Street View Image API	30,000 QPM
منطقه زمانی	30,000 QPM

In order to govern expenditures, you can monitor your API usage , and set daily limits to all requests to any billable API.

Google Maps Platform products must be deployed in compliance with the standard Google Maps Platform Terms of Service .

How is usage cost calculated?

For an overview of pricing for Google Maps Platform products, see the pricing list .

To learn more about how Google Maps Platform APIs are billed, see Google Maps Platform billing and pricing overview .

How are map loads counted on Google Maps Platform?

A single map load is charged when any of the following occur:

• A web page or application displays a map using the Maps JavaScript API.
• An application requests a single map image from the Maps Static API.

Street View panoramas are charged separately from map loads:

• A static Street View panorama is charged for each request to the Street View Static API to embed a static (non-interactive) Street View panorama.
• A dynamic Street View panorama is charged for each instantiation of a panorama object in a Maps JavaScript API, Maps SDK for Android, or Maps SDK for iOS application.

After a web page or application loads a map, or a static map image, or a Street View panorama, any user interactions with it, such as panning, zooming, or switching map layers, don't generate additional map loads or affect usage limits.

Adding a marker won't generate additional map loads, but may generate charges around how the pin location was determined (such as loading or reloading the google.maps.Map() class.)

How do I monitor my usage?

You can monitor the usage of individual APIs in the Google Cloud console .

1. Select the project that contains the API you want to review.
2. From the list of APIs on the Dashboard, click the name of the API.
3. Near the top of the page, click Metrics or Quotas .

To see a traffic report and billing information for an entire project, follow these steps:

1. If you haven't already done so, set up billing .
2. Go to the Cloud console billing page .
3. یک پروژه را انتخاب کنید.
4. In the left sidebar, click Reports . Use the filters on the right sidebar to view reports on your billing account.

To learn more, see Google Maps Platform Reporting as well as Google Maps Platform Monitoring and Set a quota limit .

What happens if I exceed the request rate (QPM) limits?

If you exceed the QPM limits of a given Google Maps Platform product, the API will return an error message. If you repeatedly exceed the limits, your access to the API may be temporarily blocked.

If you exceed the request QPM limits or otherwise abuse the service, requests will return a specific error message. If you continue to exceed limits, your access to Google Maps Platform may be blocked.

Note: The following web service APIs have an equivalent client-side service available in the Maps JavaScript API: Elevation , Geocoding .

Usage limits exceeded

If you exceed the usage limits you get an OVER_QUERY_LIMIT status code as a response.

This message means that the web service has stopped providing normal responses and has switched to returning only status code OVER_QUERY_LIMIT until more usage is allowed again. This scenario can happen within a few seconds, if the error was received because your application sent too many requests per minute.

If you regularly exceed your QPM usage limits, consider lowering usage by optimizing applications to use Google Maps Platform products more efficiently, or request to increase your quota. See the Optimization Guide for more information.

My site gets a lot of traffic. Can I use Google Maps Platform products?

بله. However we recommend that you familiarize yourself with the usage limits for any of Google Maps Platform that your application relies on.

If my website or application becomes suddenly popular, will my maps stop working?

Once you have a billing account, if you exceed the free usage cap and you don't have a valid payment method on your billing account (such as a credit card or bank transfer), the API ceases to function until you add a valid payment method.

How will usage be calculated and billed?

Usage is calculated at the end of each day, and priced as shown in the pricing list . At the end of every month, the total usage is charged to the payment method associated with your billing account. For more information, see Google Maps Platform Billing .

How much does it cost to use Google Maps Platform?

See the pricing list for an overview of cost per API. If your application generates requests or map load volumes up to the free usage cap for a given month, your usage is not charged. Usage that exceeds the free usage cap is charged to your billing account. For more details, see Google Maps Platform Billing .

Is pricing available in other currencies?

Additional currencies may be available within the console. When you select a different currency, rates will convert from the USD equivalent listed on our Pricing Sheet .

I've set up billing. How do I view my bill?

Google charges you at the beginning of each month for the previous month's activity, using your specified payment method . For details about your bill, see our Google Maps Platform Billing .

منابع اضافی:

• Learn how to view your cost and payment history .
• Learn how to get an invoice or payment receipt .
• Learn how to set and manage billing alerts .

How do I avoid a large bill if my usage unexpectedly increases?

Google Maps Platform provides ways to set daily request limits and set maximum daily billable limits. You can cap the maximum daily limit on usage to protect against unexpected increases. You can also set budget alerts to receive email notifications when the charges on the billing account reach a threshold you set.

Capping the maximum daily billable limit:

To avoid a large bill, you can set a daily cap on usage to protect against unexpected increases in use. You can change this limit in the Cloud console

Tip: See the Google Maps Platform cost management page for guidance on controlling your spend.

Setting and managing budget alerts:

Set up budget alerts to send email notifications to billing administrators when the charges on the billing account reach a threshold you set. Billing administrators will be sent email notifications when the estimated charges on the billing account exceed 50%, 90%, and 100% of the threshold.

Key Point: Setting a budget does not cap API usage. The purpose of budgets is to let you create alerts so that you know how your spending is trending over time. Alerts prompt you to take action to control your costs, but don't prevent the use of your services when the budget is met or exceeded. If you prefer to set a hard cap on API usage to prevent accruing costs, you can cap API Usage with quota limits .

I got a message saying that my project is linked to the "Google Maps Platform Transition Account", but I don't have access to that account. چه کار کنم؟

The "Google Maps Platform Transition Account" was created to help certain customers transition to our pay-as-you-go pricing plan. This transition account enabled Google to provide these customers with a one-time credit, so that they could continue using Google Maps Platform up to the limit of the no-charge tier. Once this limit is exceeded, the billing account will shut down and you will lose access to the service. To avoid service interruptions, we urge you to set your own billing account, and continue to enjoy the monthly free usage cap per month. To change the billing account for your project:

1. Create a new billing account (if you already have a billing account, you can skip this step).
2. Associate the billing account with your project .

Why is my quota limit set to 1 request per day? How can I raise this limit?

If you have not created and attached a billing account to your project, your Maps Platform APIs will be limited to 1 request per day. You can get higher quota by creating and attaching a billing account. To do this, see Get Started with Google Maps Platform .

Once you have created and attached a billing account, your daily quota limit will be removed. You can decide to set a limit to prevent unexpected spend, in the Cloud console .

I received a billing violation notice. چگونه این را حل کنم؟

You have received this notice because Google has determined that your account has been using multiple billing accounts. This is a violation of Google's terms, as defined in the Google Maps Platform Terms of Service . Under these terms, it is forbidden to create multiple billing accounts. To learn more, see the Billing Account Violation FAQ .

Use Google Maps Platform

Which keys or credentials should I use for different Maps products?

Each time you use Google Maps Platform products, you must include an API key to validate your request. Google Maps Platform is available for Android, iOS or Web apps, and for HTTP web services.

API Key:

• An API key is a unique identifier that you generate using the Cloud console .
• Example of loading an API with a key: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

Digital Signature:

• A digital signature is generated using a URL signing secret provided to you by Google. Digital signatures are used with the Maps Static API and Street View Static API.

محدودیت ها:

• API key restrictions are optional, but we strongly recommend you restrict all API keys for greater security. See API security best practices for more details.
• You can add an application restriction to the API key. Once restricted, a key will only work on platforms that support that type of restriction. Four types of application restrictions are available. APIs enforcing the same restriction type can use the same restricted key.
  • IP addresses (individual servers) - for use with the web service APIs .
  • HTTP referrers (websites) - for use with the web APIs .
  • Android app restriction (by package name and fingerprint) - for use with the Maps SDK for Android .
  • iOS app restriction (by iOS bundle identifier) - for use with the Maps SDK for iOS .
• You can also add an API restriction to the API key. For more information, see Get, add, and restrict an API key .

The table below indicates the key/credential and application restriction for each Google Maps Platform API/SDK.

API/SDK	Credential & Application Restriction
Maps SDK برای اندروید	API key with Android restriction ^1
مکان‌های SDK برای Android	API key with Android restriction ^1
Navigation SDK برای اندروید	API key with Android restriction ^1
Maps SDK برای iOS	API key with iOS restriction ^1
مکان‌های SDK برای iOS	API key with iOS restriction ^1
Navigation SDK برای iOS	API key with iOS restriction ^1
Maps JavaScript API	API key with HTTP referer restriction ^1
Map Tiles API	API key with IP address restriction ^1
Maps Datasets API	نشانه OAuth
Aerial View API	API key with IP address restriction ^1
Maps Static API	API key with HTTP referer restriction ^1 + Digital Signature ^2
API استاتیک نمای خیابان	API key with HTTP referer restriction ^1 + Digital Signature ^2
Maps Embed API	API key with HTTP referer restriction ^1
Address Validation API	API key with IP address restriction ^1
Elevation API	API key with IP address restriction ^1
API کدگذاری جغرافیایی	API key with IP address restriction ^1
API مکان جغرافیایی	API key with IP address restriction ^1
Places API	API key with IP address restriction ^1
Places Aggregate API	API key with IP address restriction ^1
Roads API	API key with IP address restriction ^1
Routes API	API key with IP address restriction ^1
API منطقه زمانی	API key with IP address restriction ^1
API کیفیت هوا	API key with IP address restriction ^1
Pollen API	API key with IP address restriction ^1
API خورشیدی	API key with IP address restriction ^1

¹ API key restrictions are optional, but we strongly recommend you restrict all API keys for greater security.

² Depending on usage, a digital signature may be required for the Maps Static API and Street View Static API . Regardless of usage, we strongly recommend that you use both an API key and a digital signature to authenticate your requests.

How do I switch my key restriction type from an HTTP referer to an IP address restriction?

Important: If you are using any of the web service APIs with an API key that has referer restrictions, your requests will fail with the error message: "API keys cannot have referer restrictions when used with this API." You should switch to using an API key with IP address restrictions.

Before you switch the API key restriction type from HTTP referer to IP address, make sure that all the APIs that use the API key support the IP restriction type. APIs of the same restriction type can use the same restricted key. If you need to enforce more than one restriction, add a separate key with the required restriction. See how to add a new API key .

Learn more about API key restrictions associated with Google Maps Platform products .

To switch an API key with HTTP referer restriction to IP address restriction, do the following:

1. Go to the Credentials page of the Cloud console.
2. Select the project that contains the API key you want to edit.
3. On the Credentials page, from the list of API keys, select the name of the API key to edit the details of the key.
4. In the Key restriction section of the page, select "IP addresses (web servers, cron jobs, etc.)" and insert the appropriate server IP addresses, then click Save.

How do I get a new API key?

See Get Started with Google Maps Platform .

How can I find the changes introduced in each version of the Google Maps APIs?

Version change information for many of the Maps APIs are available at the following links:

• API کدگذاری جغرافیایی
• Maps JavaScript API
• Routes API
• Maps SDK برای اندروید
• مکان‌های SDK برای Android
• Navigation SDK برای اندروید
• Maps SDK برای iOS
• مکان‌های SDK برای iOS
• Navigation SDK برای iOS
• Places API
• Places Aggregate API
• Address Validation API
• Aerial View API
• API کیفیت هوا
• Pollen API
• API خورشیدی
• Map Tiles API
• Maps Datasets API

You can also check which version of Google Maps Platform a particular bug was introduced and fixed in using the Google Maps Platform Issue Tracker at:

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

How can I load the API into a page asynchronously after the page has loaded?

Just specify the callback parameter when loading the API. More information and sample code can be found in the Getting Started section of the Maps JavaScript API documentation.

How can I get Google Maps Platform products to display in a language other than English?

By default the API will attempt to load the most appropriate language based on the users location or browser settings. Some APIs allow you to explicitly set a language when you make a request. More information on how to set the language is available in the documentation for each API:

• Maps JavaScript API
• API کدگذاری جغرافیایی
• Routes API
• Places API
• Maps Static API

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

Google often updates supported languages. This list may not be exhaustive and is subject to change.

کد زبان	زبان	کد زبان	زبان
af	آفریقایی	ja	ژاپنی
مربع	آلبانیایی	kn	کانادا
هستم	آمهری	kk	قزاقستان
ar	عربی	کیلومتر	خمر
هی	ارمنی	ko	کره ای
az	آذربایجانی	ky	قرقیزستان
اتحادیه اروپا	باسکی	اینجا	لائوس
باشد	بلاروسی	lv	لتونی
bn	بنگالی	آن	لیتوانیایی
bs	بوسنیایی	mk	مقدونی
bg	بلغاری	ام‌اس	مالایی
من	برمه ای	میلی لیتر	مالایایی
حدود	کاتالان	آقای	مراتی
zh	چینی	دقیقه	مغولی
zh-CN	چینی (ساده شده)	ne	نپالی
zh-HK	چینی (هنگ کنگ)	نه	نروژی
zh-TW	چینی (سنتی)	pl	لهستانی
ساعت	کروات	pt	پرتغالی
cs	چک	pt-BR	پرتغالی (برزیل)
دا	دانمارکی	pt-PT	پرتغالی (پرتغال)
nl	هلندی	pa	پنجابی
en	انگلیسی	ro	رومانیایی
en-AU	انگلیسی (استرالیایی)	ru	روسی
en-GB	انگلیسی (بریتانیا کبیر)	sr	صربی (سیریلیک)
et	استونیایی	sr-Latn	Serbian (Latin script)
فا	فارسی	سی	سینهالی
فی	فنلاندی	sk	اسلواکی
فایل	فیلیپینی	sl	اسلوونیایی
fr	فرانسوی	es	اسپانیایی
fr-CA	فرانسوی (کانادا)	es-419	اسپانیایی (آمریکای لاتین)
gl	گالیسیایی	sw	سواحیلی
کا	گرجی	sv	سوئدی
de	آلمانی	تا	تامیل
el	یونانی	شما	تلوگو
گو	گجراتی	هفتم	تایلندی
iw	عبری	tr	ترکی
سلام	هندی	انگلستان	اوکراینی
هو	مجارستانی	ur	اردو
است	ایسلندی	uz	ازبکستان
شناسه	اندونزیایی	vi	ویتنامی
آن را	ایتالیایی	zu	زولو

You can see what the map will look like in any of the languages listed above in this sample application .

Can the Google Maps Platform be accessed over HTTPS (TLS)?

All Google Maps Platform can and should be accessed over HTTPS. To future proof your applications, we strongly recommend that you use TLS 1.3 for HTTPS. Although older TLS versions are still supported, we advice against relying on the deprecated legacy TLS versions 1.0 and 1.1.

The deprecated SSL protocol is no longer supported.

For more information, see the Google Maps Platform Root CA Migration FAQ and the Google Trust Services FAQ .

How do I report a bug or request a new feature in Google Maps Platform?

If you experience behavior that you believe may be a bug, begin by raising it in the relevant forum . This will allow other developers to validate the bug, and rule out any potential issues with your code.

To request a feature, first raise it in the relevant forum to confirm that a solution that meets your requirements is not already available.

Once you have confirmed that you have identified a new bug, or that your requirements cannot be met by the existing functionality of Google Maps Platform products, report your bug or feature request using the Google Maps Platform Issue Tracker .

Before adding a bug or feature request to the Issue Tracker ,be sure to check that the bug or feature concerned has not already been added. If it has, you can star the issue to register your interest and be notified of updates.

How do Google Maps Platform APIs use site cookies?

Maps SDK for Android and Maps SDK for iOS use cookies subject to Google's Privacy Policy , such as calculating daily and 7-day active users and service abuse prevention. These cookies are not associated with any signed-in Google Account and are not logged with the rest of the information collected from the API calls.

I can't find the answer to my question. با چه کسی تماس بگیرم؟

Google's Developer Relations team maintains a presence on Stack Overflow — a collaboratively-edited question and answer site for programmers. It's a great place to ask technical questions about developing and maintaining Google Maps applications. More information about asking questions on Stack Overflow is available on the Support page.

For best results when requesting help, keep the following in mind:

• Search the current discussions. Chances are someone else has experienced a similar issue and found a fix.
• Submit a link to your site if possible. Only post code snippets if the code is not viewable online.
• Provide all relevant information including browser versions, errors, and all other facts that may be useful in troubleshooting this problem.

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

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

If you encounter an error while loading or running the Google Maps APIs, see the following links to find explanations for the error codes:

• Maps JavaScript API
• Maps Static API
• Maps Datasets API
• API استاتیک نمای خیابان
• Maps Embed API
• Elevation API
• API کدگذاری جغرافیایی
• API مکان جغرافیایی
• Routes API
• Roads API
• API منطقه زمانی
• Places API
• Address Validation API

My maps appear darker than usual. چه اتفاقی می افتد؟

Under certain circumstances, a darkened map, or 'negative' Street View image, watermarked with the text "for development purposes only", may be displayed. This behavior typically indicates issues with either an API key or billing. To use Google Maps Platform products, you must have a billing account and all requests must include a valid API key. The following flow will help troubleshoot this:

Are you using an API key?

من مطمئن نیستم. How can I check if I am using an API key?

An API key is passed as the key parameter in the URL that is used to load the Maps JavaScript API. Here are a few options to check if you are using an API key:

• Use the Google Maps Platform API Checker Chrome extension. This allows you to determine if your website is properly implementing Google's licensed Maps APIs.
• If you are using a library or plugin to load the Maps JavaScript API, check the settings for that library and look for an API key option.
• Check errors in your browser . If you see the following messages, you are not using your API key correctly:
• Google Maps JavaScript API warning: NoApiKeys
• Google Maps JavaScript API error: MissingKeyMapError

For web developers:

• If you have access to the source code of your application, look for the <script> tag which is used to load the Maps JavaScript API. When loading the Maps JavaScript API, substitute YOUR_API_KEY in the code below with your API key.

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>

• Check the network traffic generated by your website in the browser. In Chrome, this can be viewed using the DevTools Network tab. Here you will see the network requests made by your website. Requests made using the Maps JavaScript API will be under the path maps/api/js . Here you can confirm if the requests are using the key parameter. It may be helpful to filter your network traffic by maps/api/js when viewing the Network tab.

No, I am not using an API key.

To get an API key, click the button below. If you do not see a guided setup, follow the full instructions at Get Started with Google Maps Platform .
شروع کنید

Yes, I am using an API key.

عالیه Let's move on and check if a billing account is attached to your project.

Is a billing account attached to your project?

من مطمئن نیستم. How can I check if billing account is attached to my project?

Go to the Billing page in the Google Cloud console and select the project under which your API key was created. To confirm the key is associated with the project:

1. Go to the Credentials section, which can be accessed from the left side bar under Google Maps Platform > Credentials .
2. Check that the API key you currently use on your website is listed. If that's not the case, switch to a different project, and check the credentials there.
3. If you cannot locate the project for your API key, you may have lost access to this project. Ask others in your organization for help. If the original project cannot be located, you should:
   1. یک پروژه جدید ایجاد کنید. This can be done by selecting New Project from the projects list, or by selecting Create Project via the Resource Manager page .
   2. Create a new API key. This can be done on the Credentials page. Once there click Create credentials and then select API key .

Once you have located your project in the Cloud console, check if a billing account is attached by navigating to the Billing section in the left side menu.

No, a billing account is not attached to my project.

Go to the Enable Billing page in the Cloud console and add a billing account to your project. For additional information, see Get Started with Google Maps Platform .

Yes, a billing account is attached to my project.

عالیه Let's make sure the provided billing method is valid.

Is the provided billing method no longer valid (for example an expired credit card)?

You can add, remove, or update a payment method in the Cloud console.

Is there an exceeded self-imposed daily limit on the API?

If you have set a daily limit on any of your APIs, which is common to prevent unexpected increases, you can resolve this by increasing your daily limit .

You can check your daily limits by going to the APIs & Services Dashboard in the Cloud console. یک بار آنجا:

1. در صورت درخواست، پروژه ای را انتخاب کنید.
2. Select an API from the list, then click the Quotas tab.

Does your API key have an IP addresses restriction?

API keys with an IP addresses restriction can only be used with web services that are intended for use from the server side (such as the Geocoding API and other Web Service APIs ). Most of these web services have equivalent services within the Maps JavaScript API (for example, see the Geocoding Service ). To use the Maps JavaScript API client side services, you will need to create a separate API key which can be secured with an HTTP referrers restriction (see Get, add, and restrict an API key ).

How do I resolve the error codes: OVER_DAILY_LIMIT or OVER_QUERY_LIMIT ?

These error codes can be returned for any of the following reasons:

• An API key is missing from the request.
• The provided API key is invalid.
• The project does not have a billing account attached.
• A self-imposed usage cap has been exceeded.
• The provided method of payment is no longer valid (for example, a credit card has expired).
• You have exceeded the quota limits for a given API.

To use Google Maps Platform products, you must have a billing account, and all requests must include a valid API key. To fix this, take the following steps:

• Set up a billing account .
• Get a new API key .
• Adjust your usage cap to increase your daily quota limit (if applicable).

How do I resolve the error codes: kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED ?

If you are seeing kGMSPlacesRateLimitExceeded or 9005 PLACES_API_RATE_LIMIT_EXCEEDED , you may be using a deprecated version of the Places SDK for Android or Places SDK for iOS. Learn more and find the new SDKs at https://goo.gle/places-sdk-deprecation .

How do I resolve the error: "This IP, site or mobile application is not authorized to use this API key."?

There are various scenarios which may cause this error:

• You've enabled IP address (server) restrictions on your API key, and an unauthorized IP address is attempting a request.
• You've enabled HTTP referrer (website) restrictions on your API key, and an unauthorized referrer is attempting a request.
• You've restricted usage to your Android apps by setting a package name and fingerprint, and an unauthorized Android app is attempting a request.
• You've restricted requests from iOS apps by specifying bundle identifiers and an unrecognized iOS app is attemting to send a request.
• It used to be possible to get this error if you used any of the web service APIs , with an API key with HTTP referer restrictions. Requests to those APIs should be identified with an API key with IP address restrictions. Switch your key restriction type from an HTTP referer restriction to an IP address restriction . For more information about restricting API keys, see API Key Best Practices .

View and Edit your API Key Credentials

To view your API keys and manage any restrictions, do the following:

1. Go to the Credentials page of the Cloud console.
2. Select the project that contains the API key you want to review.
3. To view credential details, including any restrictions set for the key, from the list of API keys, click the name of the key.
4. The full credentials of the selected API key are displayed, including any restrictions set up for the key. From here, the restrictions can be changed, deleted, or updated as needed.

How do I resolve the error: "API keys with referer restrictions cannot be used with this API."?

You are using any of the web service APIs with an API key restricted to an HTTP referer. For security reasons, web service APIs need to use API keys restricted to IP addresses . Switch your key restriction type from an HTTP referer restriction to an IP address restriction , or create a new API key if your key is already used with the Maps JavaScript API.

Google Maps Platform Services

I need to convert addresses to latitude/longitude pairs. Can I do that with Google Maps Platform?

Yes, this process is called "geocoding." The Maps JavaScript API includes a class for performing a geocoding service. The class is: google.maps.Geocoder .

Alternatively, Google also provides the Geocoding API , which offers a REST interface that can respond in JSON and XML formats.

Which countries is geocoding available in?

To see countries supported by Google Maps Platform geocoders, consult the Google Maps coverage data .

The accuracy of geocoded locations may vary per country, so you should consider using the returned location_type field to determine if a good enough match has been found for the purposes of your application. The availability of geocoding data depends on our contracts with data providers, so it is subject to change.

Why do Google Maps Platform Geocoders provide different locations than Google Maps?

The API geocoder and Google Maps geocoder sometimes use different data sets (depending on the country). The API geocoder occasionally gets updated with new data, so you can expect to see results changing or improving over time.

How should I format my geocoder queries to maximise the number of successful requests?

The geocoder is designed to map street addresses to geographical coordinates. We therefore recommend that you format geocoder requests in accordance with the following guidelines to maximize the likelihood of a successful query:

• Specify addresses in accordance with the format used by the national postal service of the country concerned.
• don't specify additional address elements such as business names, unit numbers, floor numbers, or suite numbers that are not included in the address as defined by the postal service of the country concerned. Doing so may result in responses with ZERO_RESULTS .
• Format plus codes as shown here (plus signs are url-escaped to %2B and spaces are url-escaped to %20 ):
  • global code is a 4 character area code and 6 character or longer local code (849VCWC8+R9 is 849VCWC8%2BR9 ).
  • compound code is a 6 character or longer local code with an explicit location (CWC8+R9 Mountain View, CA, USA is CWC8%2BR9%20Mountain%20View%20CA%20USA ).
• Use the street number of a premise in preference to the building name where possible.
• Use street number addressing in preference to specifying cross streets where possible.
• don't provide 'hints' such as nearby landmarks.

How should I format a US address on a numbered highway for geocoding?

The Google Maps Platform geocoder requires that US numbered highways be specified in addresses as follows:

• County Roads: "Co Road NNN " where NNN is the road number. به عنوان مثال "Co Road 82"
• State Highways: " State NNN " where State is the full name of the state and NNN is the highway number. به عنوان مثال "California 82"
• US Highways: "US NNN " where NNN is the highway number. به عنوان مثال "US 101"
• US Interstates: "Interstate NNN " where NNN is the interstate number. به عنوان مثال "Interstate 280"

When should I use an API geocoder class and when should I use the HTTP Geocoding Service?

See the document: Geocoding Strategies , which details the advantages and limitations of different geocoding strategies.

How do I provide driving directions with Google Maps Platform?

The Compute Routes service of the Routes API lets you provide driving directions for single and multi-leg journeys. Routing options help you shape directions with a travel mode (driving), a single or a set of routes, and restrictions (no toll roads). These services are available in the following forms:

HTTP request/response interface (used in mobile and other applications) is compatible with Maps SDK for Android and with other Google Maps web services.

In which countries are driving directions available?

To see countries supported by driving directions in Google Maps Platform products, consult the Google Maps coverage data . The availability of driving directions data depends on our contracts with data providers, and is subject to change.

In which countries are transit directions available?

The Routes API supports all Google Transit partners , except the Indian Railway Catering and Tourism Corporation and those in Japan.

Which KML and GeoRSS features are supported in the Maps JavaScript API?

The KmlLayer class in the Maps JavaScript API enables developers to overlay KML/KMZ and GeoRSS files on top of the map. For documentation and examples, see KmlLayer class .

What are the limits on the size and complexity of KML that can be displayed using the KmlLayer class of the Maps JavaScript API?

The size and complexity limits on the display of KML using the KmlLayer class are documented KmlLayer overview .

How do I render KML files that are hosted on intranet sites on a map?

The KmlLayer class that generates KML overlays in the Maps JavaScript API uses a Google hosted service to retrieve and parse KML files for rendering. Consequently it is not possible to display KML files that are not hosted at a URL that is available publicly accessible, or that require authentication to access.

If you need to develop applications that use KML files hosted on intranet sites we recommend that you render the KML on the client side by using third-party JavaScript libraries. As the KML file is analyzed by the browser, performance may be lower than by using the KmlLayer class.

What is the maximum number of markers or path vertices supported by the Maps Static API?

There is no limit to the number of markers or path vertices supported by the Maps Static API. When using custom icons, up to five unique icons can be specified per request, but each can be used multiple times within the map.

Note that Maps Static API URLs can contain a maximum of approximately 8,192 characters which constrains the number of markers and path vertices that can be specified based on the number of decimal places used when specifying each latitude/longitude pair. For information on how the number of decimal places used relates to the accuracy on the Earth see the Wikipedia article on Decimal Degrees .

Why can't I access Google Maps Platform products for certain countries?

Maps APIs may not be used in Prohibited Territories . Refer also to the Terms of Service .

How do I report a problem on the Google basemap?

Send feedback through Google Maps for wrong or missing map information such as:

• Wrong addresses or marker locations
• Incorrect road names
• Wrong information about one-way and two-way roads
• Incorrectly drawn road
• Closed roads
• Roads that don't exist

For correction of a place or business listing, suggest an edit .

If Maps content needs to be removed for legal reasons, submit a legal request.

For critical or time-sensitive requests, file a support case with specific details on what needs to be fixed.

How is performance monitored for the services used with Maps JavaScript API?

Some client-side features are instrumented to report success or failure for the purpose of calculating the SLO (Service Level Objective). This information is sent to Google at maps.googleapis.com/maps_api_js_slo/log in calls that log SLO information. This information includes success status, latency, and version/channel of the Maps JavaScript API in use. The calls may be batched for performance. You may need to allow maps.googleapis.com in your Content Security Policy so that these calls are not blocked at browser-level. For example: Content-Security-Policy: default-src 'self' maps.googleapis.com; with HTTP headers, or <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> with HTML Meta Tags.

Maps JavaScript API

How long will the Maps JavaScript API work after it has been loaded?

You need to refresh the page that loads the Maps JavaScript API at least once every 5 days.

Google Maps SDK for iOS

How do I resolve the error: kGMSPlacesRateLimitExceeded ?

If you are seeing this error, you may be using a deprecated version of the Places SDK for iOS. Version 2.7.0 of the Places SDK for iOS has been turned off, and is no longer available. Update your app to use the latest version as soon as possible. See the migration guide for details.

I'm getting crashes when debugging with an iOS 8.x device. چه کار کنم؟

If you experience issues when debugging with devices running iOS 8.x, follow these steps to disable GPU frame capture in the XCode scheme you are running:

1. In XCode, choose Product , Scheme , Manage Schemes .
2. Select a scheme and choose Edit... .
3. Set the GPU Frame Capture option to Disabled . Note that this option may not be present for all devices.

What's the impact of rounded and wider screens on the Google Maps iOS SDK?

Beginning with the iPhone X , iPhones have a screen shape featuring rounded corners, a notch at the top for the device's sensor housing, and an indicator at the bottom of the screen for accessing the Home screen. As of iOS 11.0 SDK, Apple added the Safe Area API allowing developers to position elements in an area which is safe from being clipped by the new screen shape.

The Google Maps iOS SDK has many visual elements and controls, such as an indoor picker and the report a problem link. With version 2.4, these visual elements and controls could be clipped by the new screen shape. In landscape mode, the indoor floor picker may be clipped by either the notch or the home button indicator.

With the Google Maps iOS SDK 2.5 release these layout issues are fixed automatically. When your app is used on an iPhone X or later, the padding on GMSMapView and GMSPanoramaView are increased so that the visual elements aren't clipped.

By default, we will always include your padding. The Google Maps iOS SDK assumes that padding is intended to pad from within the safe area. If you design your interface with the assumption that everything is positioned within the safe area, this will work without any extra effort.

If you have designed an interface which doesn't work with our default adjustment, we have introduced a new property to GMSMapView, called paddingAdjustmentBehavior . Use GMSMapView to pick from one of three padding adjustments behaviors: 'Always' (default), 'Automatic', and 'Never'.

If GMSMapView is set to use the 'Always' padding behavior, it will always add the safe area insets to the padding. This setting lets you design your interface with the assumption that all placement is from the edges of the safe area. این مقدار پیش فرض است.

If GMSMapView is set to use the 'Automatic' padding behavior, it will always choose the larger of padding or safe area inset. This setting lets you add padding from the screen edge while making sure that all elements stay within the safe area.

If GMSMapView is set to use the 'Never' padding behavior, it will never add the safe area insets to the padding. This is the behavior prior to the 2.5 release and may be useful if your padding already takes into consideration the safe area, or if our other behaviors don't act well with your interface. It is your responsibility to make sure that the Google logo and copyright notices are always visible, as specified in the Google Maps Platform Terms of Service .

In contrast, GMSPanoramaView doesn't have an optional padding property. 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 SDK for Android

How do I resolve the error: 9005 PLACES_API_RATE_LIMIT_EXCEEDED ?

If you are seeing this error, you may be using a deprecated version of the Places SDK for Android. The Google Play services version of the Places SDK for Android has been turned off, and is no longer available. Update your app to use the latest version as soon as possible. See the migration guide for details.

My app only shows blank grey tiles instead of a map. چگونه می توانم این را حل کنم؟

A common reason that a blank grey tiles are shown instead of a map is authentication issues. You can follow the steps below to troubleshoot those issues by using adb logcat.

1. Make sure you have adb installed. If not, you can follow the guide Android adb guide .
2. Install the app that shows the problem on a device or an Android emulator. If you use Android emulator, make sure the emulator settings has Play Store included.
3. In Android Studio terminal, run adb logcat -e "Google Maps Android API" . This will only print lines where the log message matches "Google Maps Android API" (Optionally, you can output the log to a text file by appending: > logcat.txt)
4. Reproduce the issue on your device and check for common errors such as:
• The wrong/unintended API Key is being referenced in Manifest.
• Billing isn't enabled on Project.
• The SDK isn't enabled on project APIs.
• The incorrect SHA-1 fingerprint is added to the API Key restrictions.
• The Google Play Service dependencies is not included in the build.gradle file.

URL signing

Can I sign URLs using JavaScript?

We strongly recommend against signing URLs using JavaScript as this would expose your URL signing secret to end users. Therefore signatures should only be generated by server side components.

Why am I receiving a HTTP 403 Forbidden response to my Maps API web service requests?

An HTTP 403 response indicates a permission issue, likely because the signature couldn't be verified for this request. این می تواند به این دلیل باشد که:

1. A signature has been specified but is incorrect for this request.
2. The request specifies a Google Maps Platform Premium Plan an API key but does not specify a signature, and the service being called requires that requests made using an API key include a valid signature.
3. A signature has been specified but the associated Google Maps Platform Premium Plan API key has not been specified.