با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
خط مشی پشتیبانی نسخه سیستم عامل موبایل
با تکامل سیستم‌عامل‌های تلفن همراه، و با ارائه ویژگی‌ها و به‌روزرسانی‌های پلتفرم نقشه‌های Google، به طور منظم پشتیبانی از نسخه‌های قدیمی‌تر سیستم‌عامل تلفن همراه را متوقف می‌کنیم و حداقل نسخه سیستم‌عامل پشتیبانی‌شده جدید را بر اساس یک زمان‌بندی قابل پیش‌بینی تنظیم می‌کنیم. این همسویی به چند دلیل مهم است:
ثابت کردن پشتیبانی از سیستم عامل در یک برنامه زمان‌بندی قابل پیش‌بینی به توسعه‌دهندگان کمک می‌کند تا به‌روزرسانی‌های برنامه‌های خود را قبل از تاریخ پایان پشتیبانی سیستم‌عامل برنامه‌ریزی کنند و به آن‌ها اجازه می‌دهد تا از مدت زمانی که نسخه‌های قدیمی‌تر برنامه‌هایشان پشتیبانی می‌شوند و در کدام دستگاه‌ها پشتیبانی شوند.
ثابت کردن پشتیبانی از نسخه SDK پلتفرم نقشه‌های Google برای نسخه‌های خاص Android و iOS به Google کمک می‌کند تا آزمایش‌های SDK خود را گسترش داده و مقیاس‌بندی کند.
این بخش خط‌مشی پشتیبانی پلتفرم Google Maps برای پلتفرم‌های تلفن همراه را شرح می‌دهد. این خط‌مشی فقط محصولات در دسترس عموم (GA) را پوشش می‌دهد.
مسدود کردن پشتیبانی سیستم‌عامل همانطور که در شرایط خدمات پلتفرم Google Maps تعریف شده است، «منسوخ شدن قابل توجه» در نظر گرفته نمی‌شود.
صاحبان پروژه با آدرس‌های ایمیل نظارت شده، اعلان‌های فعالانه‌ای در مورد تغییراتی که بر هر یک از پروژه‌هایشان تأثیر می‌گذارد، دریافت می‌کنند. از به‌روزرسانی‌های اصلی، منسوخ شدن‌ها و سایر تغییرات مطلع باشید .
واژه شناسی
خط مشی پشتیبانی سیستم عامل اندروید
نسخه‌های جدید SDKهای پلتفرم نقشه‌های گوگل برای اندروید از نسخه سیستم‌عامل اندروید ( سطح API مانند 29 و 30) به مدت 6 سال پس از انتشار اصلی اولیه پشتیبانی می‌کنند.
به عنوان مثال، برای نسخه اندروید منتشر شده در سال 2020، نسخه‌های جدید Places SDK برای Android از آن نسخه تا سال 2026 پشتیبانی می‌کند. یا، از منظر زمانی معکوس، زمانی که Android یک سیستم‌عامل را در سال 2020 منتشر کرد، پلتفرم نقشه‌های Google از نسخه‌های سیستم عامل منتشر شده پشتیبانی می‌کند. تا سال 2014. این دیدگاه زمان معکوس برای درک جزئیات زیر از خط مشی پشتیبانی ما مفیدتر است.
در سه ماهه سوم هر سال:
Google پشتیبانی از نسخه سیستم عامل اندروید را که 6 سال از عمر آن می گذرد، متوقف می کند و نسخه جدیدتر را به حداقل نسخه سیستم عامل پشتیبانی شده در نسخه های جدید SDK ها برای اندروید تبدیل می کند.
به عنوان مثال، در سه ماهه سوم سال 2022، تقریباً در زمان معمول انتشار اندروید جدید، گوگل پشتیبانی از اندروید 7 (سطح API 25، منتشر شده در سال 2016) را متوقف می کند و اندروید 8 (سطح API 26) را به حداقل سیستم عامل پشتیبانی شده در جدید تبدیل می کند. نسخه های SDK های پلتفرم نقشه های گوگل برای اندروید. آخرین نسخه SDK منتشر شده قبل از این مرحله، آخرین نسخه پشتیبانی کننده Android API Level 25 خواهد بود.
در نتیجه، توسعه دهندگان برنامه باید تصمیم بگیرند که آیا حداقل سیستم عامل پشتیبانی شده را برای نسخه های جدید برنامه خود افزایش دهند و نسخه های وابستگی ساخت را بر این اساس مشخص کنند.
در ادامه مثال بالا، نسخه‌های برنامه ساخته‌شده با نسخه‌های قدیمی‌تر SDK همچنان روی دستگاه‌های دارای Android 7 اجرا می‌شوند، و نسخه‌های برنامه ساخته‌شده با نسخه‌های SDK که پس از این مرحله منتشر شده‌اند، نمی‌توانند روی دستگاه‌های دارای Android 7 اجرا شوند. وابستگی ساخت برنامه به نسخه جدید SDK ارتقا یافته است، کاربران باید دستگاه های خود را به اندروید 8 (سطح API 26) یا بالاتر ارتقا دهند تا بتوانند نسخه های جدید برنامه را اجرا کنند.
استثنای برنامه فریز کردن نسخه سیستم عامل Maps SDK برای Android است که به عنوان بخشی از خدمات Google Play ارائه می شود.
Maps SDK برای اندروید
Maps SDK برای Android خارج از این خط‌مشی پشتیبانی نسخه سیستم‌عامل است. Maps SDK برای زمان اجرای Android به عنوان بخشی از خدمات Google Play (همچنین به عنوان "Google Mobile Services" یا "GMS Core" شناخته می شود) گنجانده شده است که برای اجرای برنامه های Google در دستگاه های Android مورد نیاز است. از آنجایی که سرویس‌های Google Play از برنامه پشتیبانی سطح API Android خود پیروی می‌کند (همانطور که در این اطلاعیه نشان داده شده است)، برنامه پشتیبانی Maps SDK برای Android به پشتیبانی سیستم‌عامل سرویس‌های Google Play وابسته است. برای اطلاع از اینکه سرویس‌های Google Play روی کدام نسخه‌های API Android اجرا می‌شوند، به تنظیمات سرویس‌های Google Play مراجعه کنید.
با این حال، Maps SDK برای کتابخانه سرویس گیرنده Android (نمای API) که با زمان اجرای نقشه‌ها در سرویس‌های Google Play کار می‌کند، در سطوح خاص API Android نسخه‌سازی و پشتیبانی می‌شود. هنگام ساختن برنامه‌ها با Maps SDK برای Android، توسعه‌دهندگان نسخه کتابخانه سرویس گیرنده را به عنوان یک وابستگی تنظیم می‌کنند .
Google توصیه می‌کند از جدیدترینکتابخانه سرویس گیرندهcom.google.android.gms.play-services-maps استفاده کنید، که تضمین می‌کند جدیدترین ویژگی‌ها و عملکردهای پلتفرم Google Maps در برنامه شما در دستگاه‌هایی که آخرین نسخه سرویس‌های Google Play را اجرا می‌کنند در دسترس خواهد بود.
اگر برنامه‌ای از نسخه جدیدتری از کتابخانه سرویس گیرنده استفاده می‌کند اما در دستگاهی با نسخه قدیمی‌تر خدمات Google Play اجرا می‌شود، هر ویژگی جدیدتری که نامیده می‌شود به سادگی در آن دستگاه‌ها کار نخواهد کرد. هیچ خرابی یا استثنای برنامه رخ نمی دهد.
نسخه های جدید SDK های پلتفرم نقشه های گوگل برای iOS حداقل تا 3 سال پس از انتشار اصلی اولیه، از نسخه iOS پشتیبانی می کنند.
به عنوان مثال، برای نسخه اصلی iOS منتشر شده در سه ماهه سوم سال 2020، پلتفرم نقشه های گوگل تا سال 2023 از آن نسخه پشتیبانی می کند.
برای توضیح بیشتر:
گوگل به طور منظم پشتیبانی از نسخه iOS را که بیش از 3 سال پیش منتشر شده بود متوقف می کند و نسخه جدیدتر را به حداقل نسخه سیستم عامل پشتیبانی می کند.
به عنوان مثال، در سه ماهه دوم سال 2022، گوگل پشتیبانی از iOS 12 (در ابتدا در سپتامبر 2018 منتشر شد) را متوقف کرد و iOS 13 را به حداقل سیستم عامل پشتیبانی شده در نسخه های جدید SDK های پلتفرم نقشه های گوگل برای iOS تبدیل کرد. آخرین نسخه SDK منتشر شده قبل از این مرحله آخرین نسخه پشتیبانی کننده برای iOS 12 خواهد بود.
در نتیجه، توسعه دهندگان برنامه باید تصمیم بگیرند که آیا حداقل سیستم عامل پشتیبانی شده را برای نسخه های جدید برنامه خود افزایش دهند و نسخه های وابستگی ساخت را بر این اساس مشخص کنند.
در ادامه مثال بالا، نسخه‌های برنامه ساخته‌شده با نسخه‌های قدیمی‌تر SDK همچنان در دستگاه‌های دارای iOS 12 اجرا می‌شوند، و نسخه‌های برنامه ساخته‌شده با نسخه‌های SDK که پس از این مرحله منتشر شده‌اند، نمی‌توانند روی دستگاه‌های دارای iOS 12 اجرا شوند. وابستگی ساخت برنامه به نسخه جدید SDK ارتقا یافته است، کاربران باید دستگاه های خود را به iOS 13 یا بالاتر ارتقا دهند تا بتوانند نسخه های جدید برنامه را اجرا کنند.
پشتیبانی از SDK
هنگامی که Google نسخه جدیدی از SDK تلفن همراه پلتفرم Google Maps را منتشر می کند:
Google این نسخه را با نسخه‌های سیستم‌عامل به حداقل نسخه پشتیبانی‌شده سیستم‌عامل اعلام کرده است.
اصلاحات آتی SDK در عرض 12 ماه پس از انتشار اصلی اولیه این نسخه، با این نسخه سازگار خواهند بود.
بیش از 12 ماه پس از تاریخ انتشار اصلی اولیه این نسخه، ممکن است اصلاحات SDK با این نسخه سازگار نباشند.
تا زمانی که نسخه SDK از رده خارج نشود، Google مشکلات Backend ناشی از سرویس‌های پلتفرم Google Maps را برطرف خواهد کرد.
پشتیبانی IDE
SDK های پلت فرم نقشه های گوگل برای iOS با توسعه برای iOS در محیط توسعه یکپارچه Xcode اپل سازگار هستند. نسخه های مختلف Xcode شامل نسخه های مختلف زبان برنامه نویسی سوئیفت و همچنین SDK برای نسخه های مختلف سیستم عامل های اپل است.
Google به صورت دوره‌ای حداقل نسخه Xcode را که در نسخه‌های اصلی جدید SDKهای پلتفرم Google Maps برای iOS پشتیبانی می‌شود، افزایش می‌دهد. یادداشت‌های انتشار و موضوعات نرم‌افزار پشتیبانی‌شده را بررسی کنید تا حداقل نسخه پشتیبانی‌شده Xcode را برای نسخه‌ای از SDK که می‌خواهید با آن بسازید، ببینید.
پشتیبانی از مرورگر
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.
تاریخ آخرین بهروزرسانی 2025-08-09 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-09 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGoogle Maps Platform SDKs for Android support an Android OS version for 6 years after its initial major release, with support frozen annually in the third quarter.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Maps Platform SDKs for iOS support an iOS version for at least 3 years after its initial major release, with support typically frozen in the second quarter.\u003c/p\u003e\n"],["\u003cp\u003eNew SDK versions are tested against older OS versions back to the minimum supported version, with fixes backward-compatible for 12 months after initial release.\u003c/p\u003e\n"],["\u003cp\u003eMaps SDK for Android follows Google Play services' OS support schedule due to its runtime inclusion, while its client library is versioned separately.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Maps Platform supports the latest and previous major versions of common web browsers on desktop, Android, and iOS.\u003c/p\u003e\n"]]],["Google Maps Platform regularly freezes support for older mobile OS versions, establishing new minimums. Android OS versions are supported for six years post-release, while iOS versions are supported for at least three years. Support freezes involve raising the minimum OS requirement for new SDK versions. Developers must adjust app dependencies accordingly, impacting which OS versions can run newer app releases. The Maps SDK for Android is an exception, relying on Google Play services' support schedule. These changes help plan app updates and ensure SDK testing efficiency.\n"],null,["Mobile OS version support policy\n\nAs mobile operating systems evolve, and as we roll out Google Maps Platform\nfeatures and updates, we will begin regularly freezing support for older mobile OS versions\nand setting a new minimum supported OS version on a predictable\nschedule. This alignment is important for a number of reasons:\n\n- Freezing OS support on a predictable schedule helps developers plan their app updates ahead of OS support end dates, and lets them know how long older versions of their apps will be supported, and on which devices.\n- Freezing Google Maps Platform SDK version support to specific Android and iOS versions helps Google scope and scale its SDK testing.\n\nThis section describes the Google Maps Platform support policy for mobile\nplatforms. This policy covers only Generally Available (GA) products.\n\nOS support freezes are not considered \"Significant Deprecations\" as defined in the\n[Google Maps Platform\nTerms of Service](https://cloud.google.com/maps-platform/terms/).\n\nProject Owners with monitored email addresses receive proactive notifications about changes that\nimpact each of their projects. [Stay\ninformed](https://developers.google.com/maps/support#staying_informed) about major updates, deprecations, and other changes.\n\nTerminology **Key Term:** *Supporting a mobile OS version* indicates that new versions of a Google Maps Platform mobile SDK have a minimum supported OS at or below that version of the mobile operating system. See [SDK support](#sdk-support) for implications on testing and bug fixes.\n| **Key Term:** *Freezing support for a mobile OS\n| version* indicates that new versions of a Google Maps Platform mobile SDK will raise the minimum supported OS above that version, and support for that mobile OS version is \"frozen\" at the last supporting version. App versions that must support the frozen mobile OS version should build with a version of the Google Maps Platform SDK that is at or lower than the last supporting version.\n| **Key Term:** *Ending support for a mobile OS version* indicates that the last supporting version of a Google Maps Platform mobile SDK is scheduled to be [decommissioned](/maps/deprecations#how_deprecation_works). Users who are running the old OS will no longer be able to run app versions built with decommissioned SDK versions until they upgrade their mobile OS and update to a newer version of the app built with a supported version of the SDK.\n\nAndroid OS support policy\n\nNew releases of Google Maps Platform SDKs for Android will support an Android\nOS version ([API Level](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)\nsuch as 29 and 30) for 6 years after initial major release.\n\nFor example, for an Android version released in 2020, new\nreleases of the Places SDK for Android will support that version until 2026. Or,\nfrom a reversed time perspective, when Android released an OS in 2020, Google Maps Platform\nwould support OS versions released as far back as 2014. This\nreversed time perspective is more helpful in understanding the following details\nof our support policy.\n\nIn the third quarter of each year:\n\n- Google will freeze support on the Android OS version that is 6 years\n old, making the one-newer version the minimum supported OS version in new\n releases of SDKs for Android.\n\n For example, in the third quarter of\n 2022, around the typical time of a new Android release, Google will freeze\n support of Android 7 (API Level 25, released 2016), making Android 8 (API Level 26) the minimum\n supported OS in new versions of Google Maps Platform SDKs for Android. The last SDK version\n released before this point will be the last supporting version of Android API Level 25.\n- As a consequence, app developers will need to decide whether to raise the\n minimum supported OS for new versions of their app and\n specify build dependency versions accordingly.\n\n Continuing the example\n above, app versions built with older versions of the SDK will continue to run on\n devices running Android 7, and app versions built with versions of the SDK\n released after this point will not be able to run on devices running Android 7.\n Once the app's build dependency is upgraded to the new version of the SDK, users\n will have to upgrade their devices to Android 8 (API Level 26) or above to be able to run new\n versions of the app.\n\nThe exception to the OS version freeze schedule is Maps SDK for Android,\nwhich is delivered as part of Google Play services.\n\nMaps SDK for Android\n\nMaps SDK for Android falls outside of this OS version support policy. The\nMaps SDK for Android runtime is included as part of\n[Google Play services](/android) (also\nknown as \"Google Mobile Services\" or \"GMS Core\"), which is required for running\nGoogle apps on Android devices. Because Google Play services follows its own\nAndroid API Level support schedule (as illustrated by [this announcement](https://android-developers.googleblog.com/2021/07/google-play-services-discontinuing-jelly-bean.html)), the support schedule for Maps SDK for Android is dependent on\nGoogle Play services OS support. For information on which Android API versions\nGoogle Play services runs on, see [Google Play services\nsetup](/android/guides/setup).\n\nHowever, the Maps SDK for Android client library (API facade) that works with\nthe maps runtime on Google Play services is versioned and supported on specific\nAndroid API Levels. When building apps with Maps SDK for Android, developers\n[set\nthe client library version as a dependency](/maps/documentation/android-sdk/config#add_the_maps_dependency).\n\nGoogle recommends using the\n[latest](/android/guides/setup#list-dependencies) `com.google.android.gms.play-services-maps`\n[client library](https://maven.google.com/web/index.html?q=play-services-map#com.google.android.gms:play-services-maps), which ensures that the newest Google Maps Platform features\nand functionality will be available in your app, on devices running the latest\nversion of Google Play services.\n\nIf an app is using a newer version of the client library but is being run on\na device with an older version of Google Play services, any newer features being\ncalled simply won't operate on those devices. No app crashes or exceptions\noccur.\n\nFor more information about Android releases, see the\n[Android SDK platform\nreleases](https://developer.android.com/about/versions).\n\niOS support policy\n\nNew releases of Google Maps Platform SDKs for iOS will support an iOS version for at\nleast 3 years after its initial major release.\n\nFor example, for a major iOS version released in the third quarter of 2020,\nGoogle Maps Platform will support that version through 2023.\n\nTo further illustrate:\n\n- Google will regularly freeze support for the iOS version that had its initial major release more\n than 3 years ago, making the one-newer version the minimum supported OS version.\n\n For example, in the second quarter of 2022, Google freezes\n support of iOS 12 (initially released September 2018), making iOS 13 the minimum supported\n OS in new versions of Google Maps Platform SDKs for iOS. The last SDK version\n released before this point will be the last supporting version for iOS 12.\n- As a consequence, app developers will need to decide whether to raise the\n minimum supported OS for new versions of their app and specify\n build dependency versions accordingly.\n\n Continuing the example\n above, app versions built with older versions of the SDK will continue to run on\n devices running iOS 12, and app versions built with versions of the SDK released\n after this point will not be able to run on devices running iOS 12. Once the\n app's build dependency is upgraded to the new version of the SDK, users will\n have to upgrade their devices to iOS 13 or above to be able to run new versions\n of the app.\n\nSDK support\n\nWhen Google releases a new version of a Google Maps Platform mobile SDK:\n\n- Google has tested this version against OS versions back to the stated minimum supported OS version.\n- Future SDK fixes within 12 months after this version's initial major release will be backward-compatible with this version.\n- Beyond 12 months after this version's initial major release date, SDK fixes may not be backward-compatible with this version.\n- Google will fix backend issues caused by Google Maps Platform services until the SDK version is decommissioned.\n\nIDE support\n\nGoogle Maps Platform SDKs for iOS are compatible with development for iOS in Apple's\nintegrated development environment Xcode. Different versions of Xcode include different\nversions of the Swift programming language as well as SDKs for different versions of Apple\noperating systems.\n\nGoogle periodically raises the minimum version of Xcode supported in new major versions of\nGoogle Maps Platform SDKs for iOS. Check release notes and supported software topics to see\nthe minimum supported version of Xcode for the version of the SDK that you wish to build with.\n\nBrowser support\n\n\nThe Maps JavaScript API and Maps Embed API support\nthe following web browsers:\n**Desktop**\n\n- The current version of Microsoft Edge (Windows), **excluding** IE mode.\n- The two latest major stable versions of Firefox (Windows, macOS, Linux).\n- The two latest major stable versions of Chrome (Windows, macOS, Linux).\n- The two latest major stable versions of Safari (macOS).\n\n**Android**\n\n- The current version of Chrome on Android 4.1+.\n- Chrome WebView on Android 4.4+.\n\n**iOS**\n\n- Mobile Safari on the current and previous major versions of iOS.\n- UIWebView and WKWebView on the current and previous major versions of iOS.\n- The current version of Chrome for iOS."]]
