HERE iOS SDK Developer's Guide

<NMAStreetLevelViewDelegate>

Protocol Summary

protocol <NMAStreetLevelViewDelegate>

Derived from: <NSObject>

.

Deprecated: Street Level APIs are deprecated as of release 3.7.

Include: NMAKit.framework/headers/NMAStreetLevelView.h

Inheritance Diagrams

Figure 1. Public inheritance diagram for <NMAStreetLevelViewDelegate> – <NMAStreetLevelViewDelegate>

[For complete information, see the section Protocol Details]

Instance Method Summary

Table 1. Instance Methods
Instance Method Summary

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didChangePositionTo:(nonnull NMAGeoCoordinates *) position

A callback indicating that NMAStreetLevelView camera position changed

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didMoveTo:(nullable NMAGeoCoordinates *) geoCoordinates withSuccess:(BOOL) success

A callback indicating that NMAStreetLevelView moved to a different section

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didOrientTo:( NMAStreetLevelOrientation ) orientation

A callback indicating that NMAStreetLevelView camera did change orientation

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didSelectObjects:(nonnull NSArray< NMAStreetLevelSelectedObject * > *) selectedObjects

A callback indicating that one or more NMAViewObject objects have been selected

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didZoomTo:(float) zoomLevel

A callback indicating that NMAStreetLevelView camera did zoom

- @optional (BOOL) streetLevelView:(nonnull NMAStreetLevelView *) view shouldMoveToLink:(nonnull NMAStreetLevelLink *) link

A callback indicating that the user tapped on a NMAStreetLevelLink, use this callback to customize the default link handling behaviour

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view willMoveTo:(nonnull NMAGeoCoordinates *) geoCoordinates

A callback indicating that the NMAStreetLevelView is attempting to move to a different section

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view willOrientFrom:( NMAStreetLevelOrientation ) orientation

A callback indicating that NMAStreetLevelView camera will change orientation

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view willZoomFrom:(float) zoomLevel

A callback indicating that NMAStreetLevelView camera will zoom

Protocol Details

NMAStreetLevelView Delegate

A delegate that provides callback methods related to visible changes in the street level view resulting from user interaction and programmatic state changes.

Methods of this protocol are called on the main queue.

Deprecated: Street Level APIs are deprecated as of release 3.7.

Instance Method Details

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didChangePositionTo:(nonnull NMAGeoCoordinates *) position

A callback indicating that NMAStreetLevelView camera position changed.

This callback typically occurs when moving between sections with animation. The camera transitions from one section next to the next.

Parameters:

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didMoveTo:(nullable NMAGeoCoordinates *) geoCoordinates withSuccess:(BOOL) success

A callback indicating that NMAStreetLevelView moved to a different section.

Note:

If a moveTo request is made whilst a previous moveTo request is outstanding the first request may be disregarded. Regardless, this method will only be called once to reflect the final state of multiple competing move requests.

Parameters:

  • view

    NMAStreetLevelView that has moved to a different section is attempting to move to a new section

  • geoCoordinates

    NMAGeoCoordinates of the center of the section that has been moved to. Undefined if success == NO.

  • success

    YES if the street view has moved to a new section. NO if the move failed.

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didOrientTo:( NMAStreetLevelOrientation ) orientation

A callback indicating that NMAStreetLevelView camera did change orientation.

Parameters:

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didSelectObjects:(nonnull NSArray< NMAStreetLevelSelectedObject * > *) selectedObjects

A callback indicating that one or more NMAViewObject objects have been selected.

Proxy objects represent objects in the street view that pre-exist as part of the HERE street level model data (e.g. buildings). Although you will receieve a different instance of a proxy object everytime it is selected the entity it represents reamains the same - therefore proxy object comparisons should be made using the base class [ NMAViewObject isEqual] method instead of comparing instance pointers.

User objects are objects added via [ NMAStreetLevelView addStreetLevelObject:]

/note NMAStreetLevelLink objects are handled via [ NMAStreetLevelViewDelegate streetLevelView:shouldMoveToLink:]

Parameters:

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view didZoomTo:(float) zoomLevel

A callback indicating that NMAStreetLevelView camera did zoom.

Parameters:

A callback indicating that the user tapped on a NMAStreetLevelLink, use this callback to customize the default link handling behaviour.

Returning YES from this method will result in the default link handling behaviour which is to move to the street level section represented by the link (streetLevelView:willMoveTo: will be called).

Returning NO will result in no further handling of the link.

See [ NMAStreetLevelView navigationLinksVisible].

Note:

If a link is tapped whilst a previous moveTo request is outstanding the first request may be disregarded.

Parameters:

Returns:

YES for default link handling. NO otherwise.

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view willMoveTo:(nonnull NMAGeoCoordinates *) geoCoordinates

A callback indicating that the NMAStreetLevelView is attempting to move to a different section.

This callback will occur as the result of a programmatic moveTo... method call or as the result of the using tapping a navigation link within the the street view.

Parameters:

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view willOrientFrom:( NMAStreetLevelOrientation ) orientation

A callback indicating that NMAStreetLevelView camera will change orientation.

Parameters:

- @optional (void) streetLevelView:(nonnull NMAStreetLevelView *) view willZoomFrom:(float) zoomLevel

A callback indicating that NMAStreetLevelView camera will zoom.

Parameters: