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] NMAGeoCoordinates coordinates

The geographical location of the position

[readable, assign] double  course

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

[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] double  speed

The movement speed of the position

[readable, strong] NSDate *  timestamp

The time at which the position measurements were taken

Class Method Summary

Table 2. Class Methods
Class Methods

+(instancetype) geoPositionWithCLLocation:(CLLocation *) location

A convenience constructor for creating NMAGeoPosition instances with the specified CLLocation

+(instancetype) geoPositionWithCoordinates:( 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

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

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

+(instancetype) geoPositionWithCoordinates:( NMAGeoCoordinates *) coordinates speed:(double) speed course:(double) course latitudeAccuracy:(double) latitudeAccuracy longitudeAccuracy:(double) longitudeAccuracy altitudeAccuracy:(double) altitudeAccuracy timestamp:(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] 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] 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] double speed

The movement speed of the position.

Note:

Will be NMAGeoPositionUnknownValue if unknown.

[readable, strong] NSDate * timestamp

The time at which the position measurements were taken.

Class Method Details

+(instancetype) geoPositionWithCLLocation:(CLLocation *) location

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

+(instancetype) geoPositionWithCoordinates:( 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.

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

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.

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

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