GoogleMaps Framework Reference

AI-generated Key Takeaways

• GMSPanoramaViewDelegate handles events and interactions within a GMSPanoramaView, offering control over panorama navigation and user actions.

• It provides methods to track panorama changes, including starting a move (willMoveToPanoramaID:) and completing a move (didMoveToPanorama:).

• Delegates can respond to camera movements (didMoveCamera:), taps on the panorama (didTap:), and marker taps (didTapMarker:).

• Error handling is provided for move operations (error:onMoveNearCoordinate: and error:onMoveToPanoramaID:).

• Rendering events are signaled through panoramaViewDidStartRendering: and panoramaViewDidFinishRendering:, enabling developers to manage loading indicators.

GMSPanoramaViewDelegate

@protocol GMSPanoramaViewDelegate <NSObject>

Delegate for events on GMSPanoramaView.

• -panoramaView:willMoveToPanoramaID:

  Called when starting a move to another panorama.

  This can be the result of interactive navigation to a neighbouring panorama.

  At the moment this method is called, the view.panorama is still pointing to the old panorama, as the new panorama identified by panoID is not yet resolved. -panoramaView:didMoveToPanorama: will be called when the new panorama is ready.

  Declaration

  Swift

  optional func panoramaView(_ view: GMSPanoramaView, willMoveToPanoramaID panoramaID: String)

  Objective-C

  - (void)panoramaView:(nonnull GMSPanoramaView *)view
      willMoveToPanoramaID:(nonnull NSString *)panoramaID;

• -panoramaView:didMoveToPanorama:

  This is invoked every time the view.panorama property changes.

  Declaration

  Swift

  optional func panoramaView(_ view: GMSPanoramaView, didMoveTo panorama: GMSPanorama?)

  Objective-C

  - (void)panoramaView:(nonnull GMSPanoramaView *)view
      didMoveToPanorama:(nullable GMSPanorama *)panorama;

• -panoramaView:didMoveToPanorama:nearCoordinate:

  Called when the panorama change was caused by invoking -moveToPanoramaNearCoordinate:. The coordinate passed to that method will also be passed here.

  Declaration

  Swift

  optional func panoramaView(_ view: GMSPanoramaView, didMoveTo panorama: GMSPanorama, nearCoordinate coordinate: CLLocationCoordinate2D)

  Objective-C

  - (void)panoramaView:(nonnull GMSPanoramaView *)view
      didMoveToPanorama:(nonnull GMSPanorama *)panorama
         nearCoordinate:(CLLocationCoordinate2D)coordinate;

• -panoramaView:error:onMoveNearCoordinate:

  Called when -moveNearCoordinate: produces an error.

  Declaration

  Swift

  optional func panoramaView(_ view: GMSPanoramaView, error: any Error, onMoveNearCoordinate coordinate: CLLocationCoordinate2D)

  Objective-C

  - (void)panoramaView:(nonnull GMSPanoramaView *)view
                     error:(nonnull NSError *)error
      onMoveNearCoordinate:(CLLocationCoordinate2D)coordinate;

• -panoramaView:error:onMoveToPanoramaID:

  Called when -moveToPanoramaID: produces an error.

  Declaration

  Swift

  optional func panoramaView(_ view: GMSPanoramaView, error: any Error, onMoveToPanoramaID panoramaID: String)

  Objective-C

  - (void)panoramaView:(nonnull GMSPanoramaView *)view
                   error:(nonnull NSError *)error
      onMoveToPanoramaID:(nonnull NSString *)panoramaID;

• -panoramaView:didMoveCamera:

  Called repeatedly during changes to the camera on GMSPanoramaView. This may not be called for all intermediate camera values, but is always called for the final position of the camera after an animation or gesture.

  Declaration

  Swift

  optional func panoramaView(_ panoramaView: GMSPanoramaView, didMove camera: GMSPanoramaCamera)

  Objective-C

  - (void)panoramaView:(nonnull GMSPanoramaView *)panoramaView
         didMoveCamera:(nonnull GMSPanoramaCamera *)camera;

• -panoramaView:didTap:

  Called when a user has tapped on the GMSPanoramaView, but this tap was not consumed (taps may be consumed by e.g., tapping on a navigation arrow).

  Declaration

  Swift

  optional func panoramaView(_ panoramaView: GMSPanoramaView, didTap point: CGPoint)

  Objective-C

  - (void)panoramaView:(nonnull GMSPanoramaView *)panoramaView
                didTap:(CGPoint)point;

• -panoramaView:didTapMarker:

  Called after a marker has been tapped. May return YES to indicate the event has been fully handled and suppress any default behavior.

  Declaration

  Swift

  optional func panoramaView(_ panoramaView: GMSPanoramaView, didTap marker: GMSMarker) -> Bool

  Objective-C

  - (BOOL)panoramaView:(nonnull GMSPanoramaView *)panoramaView
          didTapMarker:(nonnull GMSMarker *)marker;

• -panoramaViewDidStartRendering:

  Called when the panorama tiles for the current view have just been requested and are beginning to load.

  Declaration

  Swift

  optional func panoramaViewDidStartRendering(_ panoramaView: GMSPanoramaView)

  Objective-C

  - (void)panoramaViewDidStartRendering:(nonnull GMSPanoramaView *)panoramaView;

• -panoramaViewDidFinishRendering:

  Called when the panorama tiles have been loaded (or permanently failed to load) and rendered on screen.

  Declaration

  Swift

  optional func panoramaViewDidFinishRendering(_ panoramaView: GMSPanoramaView)

  Objective-C

  - (void)panoramaViewDidFinishRendering:(nonnull GMSPanoramaView *)panoramaView;