iOS용 Maps SDK를 사용하면 카메라 변경 이벤트나 마커 탭 이벤트와 같은 지도에서 발생하는 이벤트를 수신할 수 있습니다.
소개
이벤트를 수신하려면 GMSMapViewDelegate 프로토콜을 구현해야 합니다. 일반적으로 이 프로토콜은 지도를 표시하는 보기 컨트롤러에 구현합니다. 아래 예시를 참조하세요.
Swift
import GoogleMaps
class Events: UIViewController, GMSMapViewDelegate {
// ...
}
Objective-C
@import GoogleMaps;
@interface Events : UIViewController <GMSMapViewDelegate>
@end
GMSMapView가 생성되면 대리자를 뷰 컨트롤러로 설정할 수 있습니다. GMSMapViewDelegate는 선택적 메서드만 제공합니다. 특정
이벤트를 수신 대기하려면 관련 메서드를 구현해야 합니다.
Swift
override func loadView() {
super.loadView()
let camera = GMSCameraPosition.camera(
withLatitude: 1.285,
longitude: 103.848,
zoom: 12
)
let mapView = GMSMapView.map(withFrame: .zero, camera: camera)
mapView.delegate = self
self.view = mapView
}
// MARK: GMSMapViewDelegate
func mapView(_ mapView: GMSMapView, didTapAt coordinate: CLLocationCoordinate2D) {
print("You tapped at \(coordinate.latitude), \(coordinate.longitude)")
}
Objective-C
- (void)loadView {
[super loadView];
GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:1.285
longitude:103.848
zoom:12];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
mapView.delegate = self;
self.view = mapView;
}
#pragma mark - GMSMapViewDelegate
- (void)mapView:(GMSMapView *)mapView didTapAtCoordinate:(CLLocationCoordinate2D)coordinate {
NSLog(@"You tapped at %f,%f", coordinate.latitude, coordinate.longitude);
}
카메라 위치
GMSMapViewDelegate를 사용하면 지도를 렌더링하는 데 사용되는 카메라 위치의 변경사항을
수신 대기할 수 있습니다. 세 가지 고유한 이벤트가 있습니다.
mapView:willMove:는 카메라 위치가 곧 변경됨을 나타냅니다.gesture인수가YES로 설정된 경우 이는 사용자가GMSMapView에서 화면 이동이나 기울이기와 같은 자연스러운 동작을 실행하기 때문입니다. 그렇지 않은 경우NO는 프로그래매틱 변경의 일부임을 나타냅니다. 예를 들어animateToCameraPosition:와 같은 메서드를 통하거나 지도 레이어를 직접 업데이트하는 방법이 있습니다. 사용자가 카메라를 변경하는 애니메이션을 생성하는 내 위치 버튼이나 나침반 버튼을 탭한 경우에도NO일 수 있습니다.이 메서드는
mapView:idleAtCameraPosition:가 호출되기 전에 여러 번 호출될 수 있지만 일반적으로 애니메이션과 동작이 동시에 발생하는 경우에만 발생합니다. 예를 들어 동작이 현재 애니메이션을 취소하고mapView:willMove:를 두 번째로 호출합니다.mapView:didChangeCameraPosition:는 동작 또는 애니메이션 중에 반복적으로 호출되며 항상mapView:willMove:호출 후에 호출됩니다. 중간 카메라 위치가 전달됩니다.마지막으로
GMSMapView의 카메라 위치가 유휴 상태가 되면mapView:idleAtCameraPosition:가 호출되며 관련 카메라 위치를 지정합니다. 이 시점에서 모든 애니메이션과 제스처가 중단됩니다.예를 들어 애플리케이션이 카메라가 변경될 때마다 콘텐츠를 다시 로드하는 대신 이 이벤트를 사용하여
GMSMapView에 표시되는 마커 또는 기타 콘텐츠의 새로고침을 트리거할 수 있습니다.
예를 들어 애플리케이션에서는 이동 시 GMSMapView를 지운 다음 카메라가 고정되는 위치를 역 지오코딩할 수 있습니다.
Swift
let geocoder = GMSGeocoder()
func mapView(_ mapView: GMSMapView, willMove gesture: Bool) {
mapView.clear()
}
func mapView(_ mapView: GMSMapView, idleAt cameraPosition: GMSCameraPosition) {
geocoder.reverseGeocodeCoordinate(cameraPosition.target) { (response, error) in
guard error == nil else {
return
}
if let result = response?.firstResult() {
let marker = GMSMarker()
marker.position = cameraPosition.target
marker.title = result.lines?[0]
marker.snippet = result.lines?[1]
marker.map = mapView
}
}
}
Objective-C
GMSGeocoder *geocoder;
- (void)mapView:(GMSMapView *)mapView willMove:(BOOL)gesture {
[mapView clear];
}
- (void)mapView:(GMSMapView *)mapView idleAtCameraPosition:(GMSCameraPosition *)cameraPosition {
id handler = ^(GMSReverseGeocodeResponse *response, NSError *error) {
if (error != nil) {
return;
}
GMSReverseGeocodeResult *result = response.firstResult;
GMSMarker *marker = [GMSMarker markerWithPosition:cameraPosition.target];
marker.title = result.lines[0];
marker.snippet = result.lines[1];
marker.map = mapView;
};
[geocoder reverseGeocodeCoordinate:cameraPosition.target completionHandler:handler];
}
비즈니스 및 기타 관심 장소의 이벤트
기본적으로, 관심 지점(POI)은 해당 아이콘과 함께 기본 지도에 나타납니다. POI에는 공원, 학교, 정부 건물 등 뿐만 아니라 상점, 식당, 호텔 등의 사업체 POI가 포함됩니다.
관심 장소의 클릭 이벤트에 응답할 수 있습니다. 비즈니스 및 기타 관심 장소 가이드를 참고하세요.
기타 이벤트
GMSMapViewDelegate의 전체 메서드 목록에 관해 알아보려면 참조 가이드를 확인하세요.