iOS용 Maps SDK를 사용하면 Google 지도 데이터를 기반으로 하는 지도를 애플리케이션에 추가할 수 있습니다. SDK는 Google 지도 서버 액세스, 지도 표시, 사용자 동작(예: 클릭, 드래그)에 대한 응답을 자동으로 처리합니다. 마커, 다중선, 지면 오버레이, 정보 창을 지도에 추가할 수도 있습니다. 이러한 객체는 지도 위치에 관한 추가 정보를 제공하며 사용자는 이 객체를 통해 지도와 상호작용할 수 있습니다.
SDK를 사용할 때는 Google Maps Platform 서비스 약관을 준수해야 하고 앱이 관련 법률을 준수하는지도 확인해야 합니다. SDK를 사용할 때 애플리케이션 이름과 버전, 인증 정보, 교차 애플리케이션 익명 식별자가 각 요청과 함께 자동으로 전송됩니다.
잠재고객
이 개념 문서는 iOS 개발 및 객체 지향 프로그래밍 개념에 익숙한 개발자를 위해 작성되었습니다. 사용자의 관점에서 Google 지도에도 익숙해야 합니다. 이 가이드는 iOS용 Maps SDK를 사용하여 애플리케이션을 탐색하고 개발할 수 있도록 설계되었습니다. 클래스와 메서드의 구체적인 사항은 참고 문서를 참고하세요.
저작자 표시 요구사항
애플리케이션에 iOS용 Maps SDK를 사용하는 경우 애플리케이션의 법적 고지 섹션에 저작자 표시 문구를 삽입해야 합니다. 법적 고지는 독립적인 메뉴 항목 또는 '정보' 메뉴 항목의 일부로 포함하는 것이 좋습니다.
[GMSServices openSourceLicenseInfo]를 호출하여 저작자 표시 텍스트를 가져올 수 있습니다.
지원되는 플랫폼
iOS용 Maps SDK를 사용하면 iOS 16.0 이상을 실행하는 64비트 기기를 타겟팅하는 앱을 빌드할 수 있습니다. iOS용 Maps SDK를 사용하여 애플리케이션을 개발하려면 타겟 SDK가 16.0 이상인 Xcode 16.0 이상이 필요합니다. (타겟 SDK를 16.0 이상으로 설정해도 앱이 iOS 16.0에서 실행되는 것을 막지는 않습니다.)
[[["이해하기 쉬움","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-07-26(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)."]]