모바일 운영체제의 발전과 Google Maps Platform 기능 및 업데이트의 출시에 발맞춰 Google은 정기적으로 이전 모바일 OS 버전에 대한 지원을 중단하고 새로운 최소 지원 OS 버전을 예정된 일정에 따라 설정하고 있습니다. 이러한 조율 과정은 다음과 같은 이유에서 중요합니다.
예정된 일정에 따라 OS 지원을 중단하면 개발자가 OS 지원 종료일 전에 앱 업데이트를 계획할 수 있고, 이전 버전의 앱이 어떤 기기에서 언제까지 지원되는지 알 수 있습니다.
특정 Android 및 iOS 버전에 대한 Google Maps Platform SDK의 지원을 중단하면 Google에서 SDK 테스트 범위를 정하고 확장할 수 있습니다.
이 섹션에서는 모바일 플랫폼용 Google Maps Platform 지원 정책에 대해 설명합니다. 이 정책은 일반 안정화 버전(GA) 제품에만 적용됩니다.
모니터링되는 이메일 주소가 있는 프로젝트 소유자는 각 프로젝트에 영향을 미치는 변경사항에 대한 사전 알림을 받습니다. 메이저 업데이트, 지원 중단 및 기타 변경사항에 대한 최신 정보를 확인하세요.
용어
Android OS 지원 정책
새로 출시되는 Android용 Google Maps Platform SDK는 특정 Android OS 버전(29, 30 등의 API 수준)을 최초 주요 출시 이후 6년 동안 지원합니다.
예를 들어 2020년에 출시된 Android 버전의 경우 새로 출시된 Android용 Places SDK 버전이 2026년까지 이 버전을 지원합니다. 반대로 Android에서 2020년에 출시한 OS의 경우 Google Maps Platform에서는 2014년 이후에 출시된 OS 버전을 지원합니다. 이러한 반대의 경우를 이해하면 지원 정책의 다음 세부정보를 이해하는 데 도움이 됩니다.
매년 3분기:
Google에서는 6년이 지난 Android OS 버전을 지원하지 않으며, 그 다음 버전이 새로 출시된 Android용 SDK 버전의 최소 지원 OS 버전이 됩니다.
예를 들어 2022년 3분기, 즉 일반적으로 새 Android가 출시되는 시점에 Google에서는 Android 7(2016년 출시된 수준 25)에 대한 지원을 중단하며 그에 따라 Android 8(API 수준 26)이 새로 출시된 Android용 Google Maps Platform SDK의 최소 지원 OS 버전이 됩니다. 이 시점 이전에 출시된 마지막 SDK 버전은 Android API 수준 25의 최종 지원 버전이 됩니다.
따라서 앱 개발자는 새 앱 버전의 최소 지원 OS를 높일지 여부를 결정하고 그에 따라 빌드 종속 항목 버전을 지정해야 합니다.
위의 예를 계속 들자면, 이전 버전의 SDK로 빌드된 앱 버전은 Android 7을 실행하는 기기에서 계속 실행되며, 이 시점 이후에 출시된 SDK 버전으로 빌드된 앱 버전은 Android 7을 실행하는 기기에서 실행할 수 없습니다.
앱의 빌드 종속 항목을 새 SDK 버전으로 업그레이드한 후에 사용자가 새 앱 버전을 실행하려면 기기를 Android 8(API 수준 26) 이상으로 업그레이드해야 합니다.
예외적으로, Google Play 서비스의 일부로 제공되는 Android용 Maps SDK에는 이러한 OS 버전 중단 일정이 적용되지 않습니다.
Android용 Maps SDK
Android용 Maps SDK에는 이 OS 버전 지원 정책이 적용되지 않습니다. Android용 Maps SDK 런타임은 Google Play 서비스('Google 모바일 서비스' 또는 'GMS Core'라고도 함)의 일부로 포함되며, Android 기기에서 Google 앱을 실행하는 데 필요합니다. Google Play 서비스는 Android API 수준 지원에 대한 자체 일정을 따르므로(이 공지 내용 참고) Android용 Maps SDK 지원 일정은 Google Play 서비스 OS 지원에 따라 달라집니다. Google Play 서비스가 실행되는 Android API 버전에 관한 내용은 Google Play 서비스 설정을 참고하세요.
그러나 Google Play 서비스의 지도 런타임에서 작동하는 Android용 Maps SDK 클라이언트 라이브러리(API 퍼사드)는 특정 Android API 수준에서 버전이 지정되고 지원됩니다. 개발자는 Android용 Maps SDK로 앱을 빌드할 때 클라이언트 라이브러리 버전을 종속 항목으로 설정합니다.
최신 버전의 Google Play 서비스를 실행하는 기기에서 앱에 대해 최신 Google Maps Platform 기능을 사용하려면 최신com.google.android.gms.play-services-maps클라이언트 라이브러리를 사용하는 것이 좋습니다.
앱이 최신 버전의 클라이언트 라이브러리를 사용 중이지만 이전 버전의 Google Play 서비스가 있는 기기에서 실행 중인 경우 이러한 기기에서 호출되는 최신 기능은 이러한 기기에서 작동하지 않습니다. 앱이 비정상 종료되거나 예외가 발생하지 않습니다.
새로 출시된 iOS용 Google Maps Platform SDK 버전은 특정 iOS 버전을 초기 주요 출시 이후 최소 3년 동안 지원합니다.
예를 들어 2020년 3분기에 출시된 주요 iOS 버전의 경우 Google Maps Platform은 2023년까지 이 버전을 지원합니다.
자세히 설명하면 다음과 같습니다.
Google에서는 최초 주요 버전 출시 후 3년 이상 경과한 iOS 버전에 대한 지원을 정기적으로 중단하며, 그에 따라 그 다음 버전이 최소 지원 OS 버전이 됩니다.
예를 들어 2022년 2분기에 iOS 12(2018년 9월 최초 출시)에 대한 지원이 동결되면 iOS 13이 iOS용 Google Maps Platform SDK의 새 버전에서 최소 지원 OS가 됩니다. 이 시점 이전에 출시된 마지막 SDK 버전은 iOS 12의 마지막 지원 버전이 됩니다.
따라서 앱 개발자는 새 앱 버전의 최소 지원 OS를 높일지 여부를 결정하고 그에 따라 빌드 종속 항목 버전을 지정해야 합니다.
위의 예를 계속 들자면, 이전 SDK 버전으로 빌드된 앱 버전은 iOS 12를 실행하는 기기에서 계속 실행할 수 있으며, 이 시점 이후에 출시된 SDK 버전으로 빌드된 앱 버전은 iOS 12를 실행하는 기기에서 실행할 수 없습니다. 앱의 빌드 종속 항목을 새 SDK 버전으로 업그레이드한 후에 사용자가 새 앱 버전을 실행하려면 기기를 iOS 13 이상으로 업그레이드해야 합니다.
SDK 지원
Google에서 Google Maps Platform 모바일 SDK의 새 버전을 출시하는 경우:
Google에서는 명시된 최소 지원 OS 버전을 사용하여 OS 버전에 대해 이 버전을 테스트했습니다.
이 버전의 초기 주요 출시 후 12개월 이내의 향후 SDK 수정 버전은 이 버전과 하위 호환성이 있습니다.
이 버전의 초기 주요 출시 후 12개월이 지나면 향후 SDK 수정 버전은 이 버전과 하위 호환성이 없을 수 있습니다.
Google에서는 SDK 버전이 사용 중지될 때까지 Google Maps Platform 서비스로 인해 발생하는 백엔드 문제를 해결합니다.
IDE 지원
iOS용 Google Maps Platform SDK는 Apple 통합 개발 환경 Xcode의 iOS용 개발과 호환됩니다. 서로 다른 버전의 Xcode에는 다양한 버전의 Swift 프로그래밍 언어와 다양한 버전의 Apple 운영체제용 SDK가 포함되어 있습니다.
Google에서는 iOS용 Google Maps Platform SDK의 새 주요 버전에서 지원되는 최소 Xcode 버전을 주기적으로 높입니다. 출시 노트 및 지원되는 소프트웨어 항목을 검토하여 빌드하려는 SDK에서 지원되는 최소 Xcode 버전을 확인하세요.
브라우저 지원
Maps JavaScript API와 Maps Embed API는 다음과 같은 웹브라우저를 지원합니다.
[[["이해하기 쉬움","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-31(UTC)"],[[["\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."]]
