HERE iOS SDK Developer's Guide

NMAPositioningManager

Class Summary

class NMAPositioningManager

Derived from: NSObject

Manages positioning services for the NMA SDK.

Include: NMAKit.framework/headers/NMAPositioningManager.h

Inheritance Diagrams

Figure 1. Public inheritance diagram for NMAPositioningManager

[For complete information, see the section Class Details]

Public Property Summary

Table 1. Public Properties
Public Properties

[readable, assign] BOOL  active

Indicates whether the NMAPositioningManager is currently broadcasting position updates

[readable, assign] NMAGeoPosition currentPosition

The best estimate for the user's current position.

[readable, assign] NMAGeoPosition rawPosition

The latest unprocessed position

Instance Method Summary

Table 2. Instance Methods
Instance Method Summary

-(BOOL) startPositioning

Enables position broadcasting.

-(void) stopPositioning

Disables position broadcasting.

Class Method Summary

Table 3. Class Methods
Class Methods

+(nonnull NMAPositioningManager *) sharedPositioningManager

Returns the NMAPositioningManager singleton instance

Class Details

Manages positioning services for the NMA SDK.

This is a singleton class and thus should never be retained, released, or instantiated. The singleton instance is accessed via the sharedPositioningManager method.

Use the startPositioning method to begin tracking position, and stopPositioning to stop. By default, position data comes from CLLocationManager.

Only one type of position is available from the positioning manager in Starter Edition: the raw position. The raw position is simply passed straight through from the positioning manager's data source. If the position is lost, a NMAPositioningManagerDidLosePositionNotification is sent.

Note:

Certain other SDK features may require the use of the positioning manager; if these features are accessed, the positioning manager will be enabled automatically (for example, the NMAPositionIndicator of a NMAMapView).

Note:

NMAPositioningManager requires valid authentication credentials to be set via NMAApplicationContext. If valid credentials are not present the API may not function correctly or may stop functioning correctly in the future when server side configurations change.

Public Property Details

[readable, assign] BOOL active

Indicates whether the NMAPositioningManager is currently broadcasting position updates.

[readable, assign] NMAGeoPositioncurrentPosition

The best estimate for the user's current position.

The currentPosition will be equal to the rawPosition in the Starter Edition.

Note:

Will be nil if the positioning manager is not active or does not have a valid position.

[readable, assign] NMAGeoPositionrawPosition

The latest unprocessed position.

Note:

Will be nil if the latest update did not return a valid position.

Instance Method Details

-(BOOL) startPositioning

Enables position broadcasting.

Returns:

YES if positioning was successfully started, NO if positioning was already in progress or if positioning failed to start.

-(void) stopPositioning

Disables position broadcasting.

Class Method Details

+(nonnull NMAPositioningManager *) sharedPositioningManager

Returns the NMAPositioningManager singleton instance.

Note:

Use this method to obtain a NMAPositioningManager instance. Do not call init directly.

Returns:

shared NMAPositioningManager instance

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.