Overview

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. To learn more, see Get Started with Google Maps Platform.

Introduction

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 ensure 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.

Note: Google uses cookies to gather anonymous usage statistics. You can delete cookies associated with an app by uninstalling and re-installing the app.

Audience

This 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.

This conceptual documentation is designed to let you start exploring and developing applications with the Maps SDK for iOS. You may also wish to 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 native 32-bit or 64-bit devices running iOS 9.0 and later. Developing an application with the Maps SDK for iOS requires at least Xcode 11.0 with a target SDK of 11.0 or later (note that setting a target SDK of 11.0 or later will not prevent your app from running on iOS 9.0).

Applications that use Maps URLs require that the target device has Google Maps for iOS installed.

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.