HERE iOS SDK Developer's Guide

NMAGeoPosition

Class Summary

class NMAGeoPosition

Derived from: NSObject

Represents position, speed, and course information as provided by a positioning source for a distinct moment in time.

Include: NMAKit.framework/headers/NMAGeoPosition.h

Inheritance Diagrams

Figure 1. Public inheritance diagram for NMAGeoPosition

[For complete information, see the section Class Details]

Public Property Summary

Table 1. Public Properties
Public Properties

[readable, assign] double  altitudeAccuracy

The accuracy of the altitude, in meters

[readable, assign] NSString *  buildingId

Building ID of this position.

[readable, assign] NSString *  buildingName

Building name in human readable format, e.g. "London Heathrow Airport". There can be different buildings with the same name.

[readable, weak] NMAGeoCoordinates coordinates

The geographical location of the position

[readable, assign] double  course

The course (direction of travel) of the position, in degrees.

[readable, assign] NSNumber *  floorId

FloorId is an integer identifying the floor level in the building.

[readable, assign] BOOL  isValid

Indicates the validity of the NMAGeoPosition

[readable, assign] double  latitudeAccuracy

The accuracy of the latitude coordinate, in meters

[readable, assign] double  longitudeAccuracy

The accuracy of the longitude coordinate, in meters

[readable, assign] NMAGeoPositionSource   source

Source of position.

[readable, assign] double  speed

The movement speed of the position

[readable, assign] NSDate *  timestamp

The time at which the position measurements were taken

Instance Method Summary

Table 2. Instance Methods
Instance Method Summary

-(nonnull) init

-(nullable) initWithCLLocation:(nonnull CLLocation *) location

Initializes an NMAGeoPosition instance with the specified CLLocation

-(nullable) initWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course accuracy:(double) accuracy

Initializes an NMAGeoPosition instance with specified coordinates, speed, course, and accuracy

-(nullable) initWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course accuracy:(double) accuracy timestamp:(nonnull NSDate *) timestamp

Initializes an NMAGeoPosition instance with specified coordinates, speed, course, accuracy and timestamp

-(nullable) initWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course latitudeAccuracy:(double) latitudeAccuracy longitudeAccuracy:(double) longitudeAccuracy altitudeAccuracy:(double) altitudeAccuracy timestamp:(nonnull NSDate *) timestamp

Initializes an NMAGeoPosition instance with specified coordinates, speed, course, latitudeAccuracy, longitudeAccuracy and altitudeAccuracy

Class Method Summary

Table 3. Class Methods
Class Methods

+(nullable) geoPositionWithCLLocation:(nonnull CLLocation *) location

A convenience constructor for creating NMAGeoPosition instances with the specified CLLocation

+(nullable) geoPositionWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course accuracy:(double) accuracy

A convenience constructor for creating NMAGeoPosition instances with specified coordinates, speed, course, and accuracy

+(nullable) geoPositionWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course accuracy:(double) accuracy timestamp:(nonnull NSDate *) timestamp

A convenience constructor for creating NMAGeoPosition instances with specified coordinates, speed, course, accuracy and timestamp

+(nullable) geoPositionWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course latitudeAccuracy:(double) latitudeAccuracy longitudeAccuracy:(double) longitudeAccuracy altitudeAccuracy:(double) altitudeAccuracy timestamp:(nonnull NSDate *) timestamp

A convenience constructor for creating NMAGeoPosition instances with specified coordinates, speed, course, latitudeAccuracy, longitudeAccuracy and altitudeAccuracy

Class Details

Represents position, speed, and course information as provided by a positioning source for a distinct moment in time.

Public Property Details

[readable, assign] double altitudeAccuracy

The accuracy of the altitude, in meters.

Note:

Will be NMAGeoPositionUnknownValue if unknown.

[readable, assign] NSString * buildingId

Building ID of this position.

[readable, assign] NSString * buildingName

Building name in human readable format, e.g. "London Heathrow Airport". There can be different buildings with the same name.

[readable, weak] NMAGeoCoordinatescoordinates

The geographical location of the position.

[readable, assign] double course

The course (direction of travel) of the position, in degrees.

Valid course values are in the range [0, 360), with 0 degrees representing north and values increasing clockwise. Thus, east is 90 degrees, south is 180 degrees, and so on.

Note:

Will be NMAGeoPositionUnknownValue if unknown.

[readable, assign] NSNumber * floorId

FloorId is an integer identifying the floor level in the building.

Floor id 0 specifies the floor that is considered the Main Level of the building. In the case building has multiple levels that can be considered as Main Level, the lowest level which can be considered as Main Level will be chosen. Floors below the chosen Main Level will have negative integers and floors above the chosen Main Level will have positive integers: The floor above the Main Level has floor id 1 and the floor below the Main Level has floor id -1.

[readable, assign] BOOL isValid

Indicates the validity of the NMAGeoPosition. The position is valid if its coordinates are valid.

[readable, assign] double latitudeAccuracy

The accuracy of the latitude coordinate, in meters.

Note:

Will be NMAGeoPositionUnknownValue if unknown.

[readable, assign] double longitudeAccuracy

The accuracy of the longitude coordinate, in meters.

Note:

Will be NMAGeoPositionUnknownValue if unknown.

[readable, assign] NMAGeoPositionSource  source

Source of position.

[readable, assign] double speed

The movement speed of the position.

Note:

Will be NMAGeoPositionUnknownValue if unknown.

[readable, assign] NSDate * timestamp

The time at which the position measurements were taken.

Instance Method Details

-(nonnull) init

Initializes an NMAGeoPosition

-(nullable) initWithCLLocation:(nonnull CLLocation *) location

Initializes an NMAGeoPosition instance with the specified CLLocation.

-(nullable) initWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course accuracy:(double) accuracy

Initializes an NMAGeoPosition instance with specified coordinates, speed, course, and accuracy.

Note:

The accuracy parameter will be used for all of latitudeAccuracy, longitudeAccuracy, and altitudeAccuracy.

Note:

The timestamp will be set to the current time.

-(nullable) initWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course accuracy:(double) accuracy timestamp:(nonnull NSDate *) timestamp

Initializes an NMAGeoPosition instance with specified coordinates, speed, course, accuracy and timestamp.

Note:

The accuracy parameter will be used for all of latitudeAccuracy, longitudeAccuracy, and altitudeAccuracy.

-(nullable) initWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course latitudeAccuracy:(double) latitudeAccuracy longitudeAccuracy:(double) longitudeAccuracy altitudeAccuracy:(double) altitudeAccuracy timestamp:(nonnull NSDate *) timestamp

Initializes an NMAGeoPosition instance with specified coordinates, speed, course, latitudeAccuracy, longitudeAccuracy and altitudeAccuracy.

Class Method Details

+(nullable) geoPositionWithCLLocation:(nonnull CLLocation *) location

A convenience constructor for creating NMAGeoPosition instances with the specified CLLocation.

+(nullable) geoPositionWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course accuracy:(double) accuracy

A convenience constructor for creating NMAGeoPosition instances with specified coordinates, speed, course, and accuracy.

Note:

The accuracy parameter will be used for all of latitudeAccuracy, longitudeAccuracy, and altitudeAccuracy.

Note:

The timestamp will be set to the current time.

+(nullable) geoPositionWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course accuracy:(double) accuracy timestamp:(nonnull NSDate *) timestamp

A convenience constructor for creating NMAGeoPosition instances with specified coordinates, speed, course, accuracy and timestamp.

Note:

The accuracy parameter will be used for all of latitudeAccuracy, longitudeAccuracy, and altitudeAccuracy.

+(nullable) geoPositionWithCoordinates:(nonnull NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course latitudeAccuracy:(double) latitudeAccuracy longitudeAccuracy:(double) longitudeAccuracy altitudeAccuracy:(double) altitudeAccuracy timestamp:(nonnull NSDate *) timestamp

A convenience constructor for creating NMAGeoPosition instances with specified coordinates, speed, course, latitudeAccuracy, longitudeAccuracy and altitudeAccuracy.

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.