Get Started Contact sales

GoogleNavigation Framework Reference

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

  • It provides methods to track panorama changes, such as willMoveToPanoramaID, didMoveToPanorama, and coordinate-based transitions.

  • Delegates can respond to errors during panorama movement with methods like error:onMoveNearCoordinate and error:onMoveToPanoramaID.

  • GMSPanoramaViewDelegate enables handling user interactions, including taps on the panorama or markers, using methods like didTap and didTapMarker.

  • It also provides feedback on the rendering process with panoramaViewDidStartRendering and panoramaViewDidFinishRendering methods, indicating when panorama tiles are loading and rendered.

GMSPanoramaViewDelegate

@protocol GMSPanoramaViewDelegate <NSObject>

Delegate for events on GMSPanoramaView.

  • 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;

  • 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;

  • 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;

  • 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;

  • 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;

  • 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;

  • 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;

  • 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;

  • 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;

  • 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;