GoogleNavigation Framework Reference

AI-generated Key Takeaways

• GMSPanoramaService allows you to request panorama metadata without needing an active GMSPanoramaView.

• It provides asynchronous methods to retrieve information about panoramas near a given coordinate, optionally specifying a search radius and panorama source.

• You can also request panorama information using a specific panorama ID obtained from the Google Maps SDK for iOS.

• The service uses a callback mechanism to deliver the results of the requests.

• While panorama source filtering is available, it's experimental and may not always be accurate.

GMSPanoramaService

@interface GMSPanoramaService : NSObject

GMSPanoramaService can be used to request panorama metadata even when a GMSPanoramaView is not active.

Get an instance like this: [[GMSPanoramaService alloc] init].

• -requestPanoramaNearCoordinate:callback:

  Retrieves information about a panorama near the given coordinate.

  This is an asynchronous request, callback will be called with the result.

  Declaration

  Swift

  func requestPanoramaNearCoordinate(_ coordinate: CLLocationCoordinate2D, callback: @escaping GMSPanoramaCallback)

  Objective-C

  - (void)requestPanoramaNearCoordinate:(CLLocationCoordinate2D)coordinate
                               callback:(nonnull GMSPanoramaCallback)callback;

• -requestPanoramaNearCoordinate:radius:callback:

  Similar to -requestPanoramaNearCoordinate:callback: but allows specifying a search radius (meters) around coordinate.

  Declaration

  Swift

  func requestPanoramaNearCoordinate(_ coordinate: CLLocationCoordinate2D, radius: UInt, callback: @escaping GMSPanoramaCallback)

  Objective-C

  - (void)requestPanoramaNearCoordinate:(CLLocationCoordinate2D)coordinate
                                 radius:(NSUInteger)radius
                               callback:(nonnull GMSPanoramaCallback)callback;

• -requestPanoramaNearCoordinate:source:callback:

  Similar to -requestPanoramaNearCoordinate:callback: but allows specifying the panorama source type near the given coordinate.

  This API is experimental and may not always filter by source.

  Declaration

  Swift

  func requestPanoramaNearCoordinate(_ coordinate: CLLocationCoordinate2D, source: GMSPanoramaSource, callback: @escaping GMSPanoramaCallback)

  Objective-C

  - (void)requestPanoramaNearCoordinate:(CLLocationCoordinate2D)coordinate
                                 source:(GMSPanoramaSource)source
                               callback:(nonnull GMSPanoramaCallback)callback;

• -requestPanoramaNearCoordinate:radius:source:callback:

  Similar to -requestPanoramaNearCoordinate:callback: but allows specifying a search radius (meters) and the panorama source type near the given coordinate.

  This API is experimental and may not always filter by source.

  Declaration

  Swift

  func requestPanoramaNearCoordinate(_ coordinate: CLLocationCoordinate2D, radius: UInt, source: GMSPanoramaSource, callback: @escaping GMSPanoramaCallback)

  Objective-C

  - (void)requestPanoramaNearCoordinate:(CLLocationCoordinate2D)coordinate
                                 radius:(NSUInteger)radius
                                 source:(GMSPanoramaSource)source
                               callback:(nonnull GMSPanoramaCallback)callback;

• -requestPanoramaWithID:callback:

  Retrieves information about a panorama with the given panoramaID.

  callback will be called with the result. Only panoramaIDs obtained from the Google Maps SDK for iOS are supported.

  Declaration

  Swift

  func requestPanorama(withID panoramaID: String, callback: @escaping GMSPanoramaCallback)

  Objective-C

  - (void)requestPanoramaWithID:(nonnull NSString *)panoramaID
                       callback:(nonnull GMSPanoramaCallback)callback;