내 위치 버튼 사용
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

지도 보기의 오른쪽 하단에
내 위치 버튼이 표시됩니다. 사용자가 버튼을 탭하면 지도의 화면이 사용자의 현재 위치로 이동합니다.
시작하기
샘플 코드를 사용하기 전에 개발 환경을 구성해야 합니다.
자세한 내용은 iOS용 Maps SDK 코드 샘플을 참고하세요.
코드 보기
로컬에서 전체 샘플 앱 실행
iOS용 Maps SDK 샘플 앱은 GitHub에서 다운로드 보관 파일로 제공됩니다.
다음 단계에 따라 iOS용 Maps SDK 샘플 앱을 설치하고 사용해 보세요.
git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git
를 실행하여 샘플 저장소를 로컬 디렉터리에 클론합니다.
터미널 창을 열고 샘플 파일을 클론한 디렉터리로 이동한 다음 GoogleMaps 디렉터리로 드릴다운합니다.
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
pod install
open GoogleMapsSwiftDemos.xcworkspace
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
pod install
open GoogleMapsDemos.xcworkspace
- Xcode에서 컴파일 버튼을 눌러 현재 스키마로 앱을 빌드합니다. 빌드 오류가 발생하여 Swift의
SDKConstants.swift
파일 또는 Objective-C의 SDKDemoAPIKey.h
파일에 API 키를 입력하라는 메시지가 표시됩니다.
- iOS용 Maps SDK가 사용 설정된 프로젝트에서 API 키를 가져옵니다.
- Swift의 경우
SDKConstants.swift
파일을 수정하고 Objective-C의 경우 SDKDemoAPIKey.h
파일을 수정한 후 apiKey
또는 kAPIKey
상수의 정의에 API 키를 붙여넣습니다. 예를 들면 다음과 같습니다.
Swift
static let apiKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
SDKConstants.swift
파일 (Swift) 또는 SDKDemoAPIKey.h
파일 (Objective-C)에서 다음 줄을 삭제합니다. 이 줄은 사용자 정의 문제를 등록하는 데 사용됩니다.
Swift
#error (Register for API Key and insert here. Then delete this line.)
Objective-C
#error Register for API Key and insert here.
- 프로젝트를 빌드하고 실행합니다. iOS 시뮬레이터 창이 표시되고 Maps SDK 데모 목록이 표시됩니다.
- 표시된 옵션 중 하나를 선택하여 iOS용 Maps SDK의 기능을 실험합니다.
- GoogleMapsDemos에서 내 위치에 액세스하도록 허용하라는 메시지가 표시되면 허용을 선택합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eThe "My Location" button, located in the bottom right corner of the map, centers the map on the user's current location when tapped.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code samples (Swift and Objective-C) demonstrate how to implement the "My Location" functionality within a map view.\u003c/p\u003e\n"],["\u003cp\u003eTo run the sample code, you'll need to configure your development environment, including obtaining and integrating a Google Maps API key.\u003c/p\u003e\n"],["\u003cp\u003eThe full sample app can be downloaded and explored to experiment with various features of the Maps SDK for iOS.\u003c/p\u003e\n"]]],["The content describes implementing a \"My Location\" feature in a map view using the Google Maps SDK for iOS. When enabled, a button appears, allowing the user to center the map on their current location upon tapping. The code examples show how to set up the map, enable the \"My Location\" button and feature, and observe changes to the user's location. Additionally, it details setting up a project and API key. It also describes setting up a tap handler on the current user's location in the map.\n"],null,["The **My Location** button is displayed in the bottom right corner of the map view. When the user taps the button, the map pans to the user's current location.\n\nGet started\n\nBefore you can try the sample code, you must configure your development environment.\nFor more information, see [Maps SDK for iOS code samples](/maps/documentation/ios-sdk/examples).\n\nView the code \n\nSwift \n\n```swift\nimport GoogleMaps\nimport UIKit\n\nclass MyLocationViewController: UIViewController {\n\n private let cameraLatitude: CLLocationDegrees = -33.868\n\n private let cameraLongitude: CLLocationDegrees = 151.2086\n\n private let cameraZoom: Float = 12\n\n lazy var mapView: GMSMapView = {\n let camera = GMSCameraPosition(\n latitude: cameraLatitude, longitude: cameraLongitude, zoom: cameraZoom)\n return GMSMapView(frame: .zero, camera: camera)\n }()\n\n var observation: NSKeyValueObservation?\n var location: CLLocation? {\n didSet {\n guard oldValue == nil, let firstLocation = location else { return }\n mapView.camera = GMSCameraPosition(target: firstLocation.coordinate, zoom: 14)\n }\n }\n\n override func viewDidLoad() {\n super.viewDidLoad()\n\n mapView.delegate = self\n mapView.settings.compassButton = true\n mapView.settings.myLocationButton = true\n mapView.isMyLocationEnabled = true\n view = mapView\n\n // Listen to the myLocation property of GMSMapView.\n observation = mapView.observe(\\.myLocation, options: [.new]) {\n [weak self] mapView, _ in\n self?.location = mapView.myLocation\n }\n }\n\n deinit {\n observation?.invalidate()\n }\n}\n\nextension MyLocationViewController: GMSMapViewDelegate {\n func mapView(_ mapView: GMSMapView, didTapMyLocation location: CLLocationCoordinate2D) {\n let alert = UIAlertController(\n title: \"Location Tapped\",\n message: \"Current location: \u003c\\(location.latitude), \\(location.longitude)\u003e\",\n preferredStyle: .alert)\n alert.addAction(UIAlertAction(title: \"OK\", style: .default))\n present(alert, animated: true)\n }\n}https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/blob/86408feffd008565cd2cafce8aff3dc27f1f41bb/GoogleMaps-Swift/GoogleMapsSwiftDemos/Swift/Samples/MyLocationViewController.swift#L14-L69\n \n```\n\nObjective-C \n\n```objective-c\n#import \"GoogleMapsDemos/Samples/MyLocationViewController.h\"\n\n#import \u003cGoogleMaps/GoogleMaps.h\u003e\n\n@implementation MyLocationViewController {\n GMSMapView *_mapView;\n BOOL _firstLocationUpdate;\n}\n\n- (void)viewDidLoad {\n [super viewDidLoad];\n GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.868\n longitude:151.2086\n zoom:12];\n\n _mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];\n _mapView.delegate = self;\n _mapView.settings.compassButton = YES;\n _mapView.settings.myLocationButton = YES;\n\n // Listen to the myLocation property of GMSMapView.\n [_mapView addObserver:self\n forKeyPath:@\"myLocation\"\n options:NSKeyValueObservingOptionNew\n context:NULL];\n\n self.view = _mapView;\n\n // Ask for My Location data after the map has already been added to the UI.\n GMSMapView *mapView = _mapView;\n dispatch_async(dispatch_get_main_queue(), ^{\n mapView.myLocationEnabled = YES;\n });\n}\n\n- (void)mapView:(GMSMapView *)mapView didTapMyLocation:(CLLocationCoordinate2D)location {\n NSString *message = [NSString stringWithFormat:@\"My Location Dot Tapped at: [lat: %f, lng: %f]\",\n location.latitude, location.longitude];\n UIAlertController *alertController =\n [UIAlertController alertControllerWithTitle:@\"Location Tapped\"\n message:message\n preferredStyle:UIAlertControllerStyleAlert];\n UIAlertAction *okAction = [UIAlertAction actionWithTitle:@\"OK\"\n style:UIAlertActionStyleDefault\n handler:^(UIAlertAction *action){\n }];\n [alertController addAction:okAction];\n [self presentViewController:alertController animated:YES completion:nil];\n}\n\n- (void)dealloc {\n [_mapView removeObserver:self forKeyPath:@\"myLocation\" context:NULL];\n}\n\n#pragma mark - KVO updates\n\n- (void)observeValueForKeyPath:(NSString *)keyPath\n ofObject:(id)object\n change:(NSDictionary *)change\n context:(void *)context {\n if (!_firstLocationUpdate) {\n // If the first location update has not yet been received, then jump to that location.\n _firstLocationUpdate = YES;\n CLLocation *location = [change objectForKey:NSKeyValueChangeNewKey];\n _mapView.camera = [GMSCameraPosition cameraWithTarget:location.coordinate zoom:14];\n }\n}\n\n@end \nhttps://github.com/googlemaps-samples/maps-sdk-for-ios-samples/blob/86408feffd008565cd2cafce8aff3dc27f1f41bb/GoogleMaps/GoogleMapsDemos/Samples/MyLocationViewController.m#L16-L84\n\n \n```\n\nRun the full sample app locally\n\nThe Maps SDK for iOS sample app is available as a\n[download archive](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/archive/main.zip)\nfrom [GitHub](https://github.com/googlemaps-samples/maps-sdk-for-ios-samples/tree/main/GoogleMaps).\nFollow these steps to install and try the Maps SDK for iOS sample app.\n\n1. Run `git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git` to clone the samples repository into a local directory.\n2. Open a terminal window, navigate to the directory where you cloned the sample files, and\n drill down into the GoogleMaps directory:\n\n Swift \n\n cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift\n pod install\n open GoogleMapsSwiftDemos.xcworkspace\n\n Objective-C \n\n cd maps-sdk-for-ios-samples-main/GoogleMaps\n pod install\n open GoogleMapsDemos.xcworkspace\n\n3. In Xcode, press the compile button to [build the app](https://developer.apple.com/documentation/xcode/building-and-running-an-app) with the current scheme. The build produces an error, prompting you to enter your API key in the `SDKConstants.swift` file for Swift or`SDKDemoAPIKey.h` file for Objective-C.\n4. [Get an API key](/maps/documentation/ios-sdk/get-api-key) from your project with the [Maps SDK for iOS enabled](/maps/documentation/ios-sdk/cloud-setup#enabling-apis).\n5. Edit the `SDKConstants.swift` file for Swift or`SDKDemoAPIKey.h` file for Objective-C and paste your API key into the definition of either the `apiKey` or `kAPIKey` constant. For example: \n\n Swift \n\n ```scdoc\n static let apiKey = \"YOUR_API_KEY\"\n ```\n\n Objective-C \n\n ```objective-c\n static NSString *const kAPIKey = @\"YOUR_API_KEY\";\n ```\n6. In the `SDKConstants.swift` file (Swift) or`SDKDemoAPIKey.h` file (Objective-C), remove the following line, because it's used to register the user-defined issue: \n\n Swift \n\n ```text\n #error (Register for API Key and insert here. Then delete this line.)\n ```\n\n Objective-C \n\n ```text\n #error Register for API Key and insert here.\n ```\n7. Build and run the project. The iOS simulator window appears, showing a list of **Maps SDK Demos**.\n8. Choose one of the options displayed, to experiment with a feature of the Maps SDK for iOS.\n9. If prompted to allow GoogleMapsDemos to access your location, choose **Allow**."]]