Com o SDK do Maps para iOS, você pode adicionar mapas com base nos dados do Google Maps ao seu aplicativo. O SDK controla automaticamente o acesso aos servidores do Google Maps, a exibição de mapas e a resposta aos gestos do usuário, como cliques e arrastos.
Você também pode adicionar marcadores, polilinhas, sobreposições de solo e janelas de informações ao mapa. Esses objetos fornecem informações adicionais para os locais do mapa e permitem a interação do usuário com ele.
Ao usar o SDK, é preciso obedecer aos Termos de Serviço da Plataforma Google Maps e garantir que seu app esteja em conformidade com as leis aplicáveis. Ao usar o SDK, o nome e a versão do aplicativo, as informações de autenticação e um identificador anônimo entre aplicativos são enviados automaticamente com cada solicitação.
Público-alvo
Esta documentação conceitual foi criada para pessoas que conhecem desenvolvimento em iOS e conceitos de programação orientada a objetos. Também é preciso saber utilizar o Google Maps como usuário.
Ele foi criado para que você comece a explorar e desenvolver aplicativos com o SDK do Maps para iOS. Você também pode consultar a documentação de referência para detalhes específicos de classes e métodos.
Requisitos de atribuição
Se você usa o SDK do Maps para iOS no seu aplicativo, precisa incluir o texto de atribuição como parte da seção de avisos legais no app.
Recomendamos incluir avisos legais como um item de menu independente ou no menu "Sobre".
Para receber o texto de atribuição, faça uma chamada para [GMSServices
openSourceLicenseInfo].
Plataformas compatíveis
Com o SDK do Maps para iOS, você pode criar apps direcionados a dispositivos de 64 bits que executam o iOS 16.0 e versões mais recentes. Para desenvolver um aplicativo com o SDK do Maps para iOS, é necessário ter pelo menos o Xcode 16.0 com um SDK de destino 16.0 ou mais recente. Definir um SDK de destino 16.0 ou mais recente não impede que o app seja executado no iOS 16.0.
É improvável que o uso do SDK do Maps para iOS em extensões de apps iOS funcione devido às restrições de memória rigorosas aplicadas. Por exemplo, o uso do SDK em um teclado
personalizado
provavelmente não vai funcionar.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 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)."]]
