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:과 같은 메서드를 통해 또는 지도의 레이어를 직접 업데이트하는 방식입니다. 사용자가 My Location 버튼이나 나침반 버튼을 탭한 경우에도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의 전체 메서드 목록에 대해 알아보려면 참조 가이드를 참고하세요.