Maps SDK for Android 是隨 Google Play 服務提供,因此不受作業系統版本凍結時程的影響。
Maps SDK for Android
Maps SDK for Android 不適用於這項作業系統版本支援政策。Maps SDK for Android 執行階段隨附於 Google Play 服務 (也稱為「Google 行動服務」或「GMS Core」),是在 Android 裝置上執行 Google 應用程式的必備要素。Google Play 服務有專屬的 Android API 級別支援時程 (如本公告所示),因此 Maps SDK for Android 的支援時程取決於 Google Play 服務作業系統支援。如要瞭解用來執行 Google Play 服務的 Android API 版本,請參閱 Google Play 服務設定。
不過,在 Google Play 服務上與 Google 地圖執行階段搭配使用的 Maps SDK for Android 用戶端程式庫 (API 門面元件),則是支援特定 Android API 級別並在該特定級別建立版本。使用 Maps SDK for Android 建立應用程式時,開發人員會將用戶端程式庫版本設為依附元件。
Google 建議使用最新的com.google.android.gms.play-services-maps用戶端程式庫,確保在執行最新版 Google Play 服務的裝置上,您的應用程式可以使用最新的 Google 地圖平台功能。
如果應用程式使用新版用戶端程式庫,但在搭載舊版 Google Play 服務的裝置上執行,則呼叫的所有新功能將無法在這些裝置上運作,也不會發生應用程式當機問題或例外狀況。
[null,null,["上次更新時間:2025-08-31 (世界標準時間)。"],[[["\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."]]