With the Maps SDK for iOS, you can add maps based on Google maps data
to your application. The SDK automatically handles access to the Google Maps
servers, map display, and response to user gestures such as clicks and drags.
You can also add markers, polylines, ground overlays and info windows to your
map. These objects provide additional information for map locations, and allow
user interaction with the map.
When using the SDK you need to comply with the Google Maps Platform Terms of Service
and make sure that your app complies with applicable laws. Note that when using
the SDK, your application name and version, authentication information and a
cross-application anonymous identifier is automatically sent with each request.
Audience
This conceptual documentation is designed for people familiar with iOS
development and
object-oriented programming concepts. You should also be familiar with Google
Maps from a user's point of view.
It is designed to let you start exploring and developing applications with the
Maps SDK for iOS. You may also refer to the reference
documentation for specific
details of classes and methods.
Attribution requirements
If you use the Maps SDK for iOS in your application, you must include
the attribution text as part of a legal notices section in your application.
Including legal notices as an independent menu item, or as part of an "About"
menu item, is recommended.
You can get the attribution text by making a call to [GMSServices
openSourceLicenseInfo].
Supported platforms
With the Maps SDK for iOS, you can build apps that target
64-bit devices running iOS 16.0 and later. Developing an
application with the Maps SDK for iOS requires at least
Xcode 16.0 with a target SDK of 16.0 or
later. (Setting a target SDK of 16.0 or later won't prevent
your app from running on iOS 16.0).
Use of the Maps SDK for iOS within iOS app extensions is
unlikely to work, due to the strict memory restrictions which are applied. For
example, use of the SDK within a custom
keyboard
is unlikely to work.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-18 UTC."],[[["\u003cp\u003eThe Maps SDK for iOS allows you to integrate Google Maps into your iOS application, enabling features like markers, polylines, and ground overlays for enhanced user interaction.\u003c/p\u003e\n"],["\u003cp\u003eYou must comply with the Google Maps Platform Terms of Service and display attribution text within your application when using the SDK.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK supports native 64-bit iOS devices running iOS 14.0 and later, requiring Xcode 15.0 or higher for development.\u003c/p\u003e\n"],["\u003cp\u003eTo get started, you need a Google Cloud project with billing enabled and the Maps SDK for iOS activated.\u003c/p\u003e\n"],["\u003cp\u003eFamiliarity with iOS development, object-oriented programming, and Google Maps from a user perspective is recommended.\u003c/p\u003e\n"]]],["To use the Maps SDK for iOS, set up a Google Cloud project with a billing account and the SDK enabled. The SDK allows adding Google Maps to iOS apps, handling map display and user interactions. Developers must comply with Google Maps Platform Terms of Service and include attribution text via `[GMSServices openSourceLicenseInfo]`. Apps require iOS 14.0+ and Xcode 15.0+. Note that app extensions and multi-window use may be problematic, and Google Maps must be installed for Maps URLs to work.\n"],null,["Select platform: [Android](/maps/documentation/android-sdk/overview \"View this page for the Android platform docs.\") [iOS](/maps/documentation/ios-sdk/overview \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/overview \"View this page for the JavaScript platform docs.\")\n\n\u003cbr /\u003e\n\n| **Before you begin:** Before you start using the Maps SDK for iOS, you need a project with a billing account and the Maps SDK for iOS enabled. We recommend creating multiple Project Owners and Billing Administrators, so that you'll always have someone with these roles available to your team. To learn more, see [Set up in Cloud console](/maps/documentation/ios-sdk/cloud-setup).\n\nIntroduction\n\nWith the Maps SDK for iOS, you can add maps based on Google maps data\nto your application. The SDK automatically handles access to the Google Maps\nservers, map display, and response to user gestures such as clicks and drags.\nYou can also add markers, polylines, ground overlays and info windows to your\nmap. These objects provide additional information for map locations, and allow\nuser interaction with the map.\n\nWhen using the SDK you need to comply with the [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms)\nand make sure that your app complies with applicable laws. Note that when using\nthe SDK, your application name and version, authentication information and a\ncross-application anonymous identifier is automatically sent with each request.\n| **Note:** Google uses cookies to gather anonymous usage statistics. You can delete cookies associated with an app by uninstalling and reinstalling the app.\n\nAudience\n\nThis conceptual documentation is designed for people familiar with [iOS\ndevelopment](https://developer.apple.com/) and\nobject-oriented programming concepts. You should also be familiar with [Google\nMaps](https://maps.google.com/) from a user's point of view.\nIt is designed to let you start exploring and developing applications with the\nMaps SDK for iOS. You may also refer to the [reference\ndocumentation](/maps/documentation/ios-sdk/reference/objc/Classes) for specific\ndetails of classes and methods.\n\nAttribution requirements\n\nIf you use the Maps SDK for iOS in your application, you must include\nthe attribution text as part of a legal notices section in your application.\nIncluding legal notices as an independent menu item, or as part of an \"About\"\nmenu item, is recommended.\n\nYou can get the attribution text by making a call to `[GMSServices\nopenSourceLicenseInfo]`.\n\nSupported platforms\n\nWith the Maps SDK for iOS, you can build apps that target\n64-bit devices running iOS 16.0 and later. Developing an\napplication with the Maps SDK for iOS requires at least\nXcode 16.0 with a target SDK of 16.0 or\nlater. (Setting a target SDK of 16.0 or later won't prevent\nyour app from running on iOS 16.0).\n\nApplications that use [Maps URLs](/maps/documentation/ios-sdk/urlscheme) require that the target device has\n[Google Maps for\niOS](https://itunes.apple.com/app/id585027354) installed.\n\nUse of the Maps SDK for iOS within iOS app extensions is\nunlikely to work, due to the strict memory restrictions which are applied. For\nexample, use of the SDK within a [custom\nkeyboard](https://developer.apple.com/library/ios/documentation/General/Conceptual/ExtensibilityPG/CustomKeyboard.html#//apple_ref/doc/uid/TP40014214-CH16-SW1)\nis unlikely to work.\n| **Note:** As of iPadOS 13 you can allow your app to have multiple windows or instances running simultaneously. Maps SDK for iOS has not been optimized for this experience and may result in undefined behavior.\n\nWhat's next\n\nTo get started building apps with the Maps SDK for iOS you must first\n[Set up your Google Cloud project](/maps/documentation/ios-sdk/cloud-setup)."]]
