Maps SDK configuration

The Maps SDK configuration for iOS provides developers with the ability to create maps within their applications using the NGLMapView class. This class serves as the foundation for integrating interactive maps into iOS applications.

With the NGLMapView class, developers can configure various properties to customize the behavior and appearance of the map. These properties allow fine-grained control over aspects such as the map's initial position, zoom level, rotation, and tilt. Additionally, developers can specify the map's style, which determines the visual representation of the map, including the colors, icons, and fonts used.

By leveraging the properties provided by the NGLMapView class, developers can create maps that seamlessly integrate with their applications and match the desired look and feel. This flexibility allows developers to tailor the map's behavior and appearance to meet the specific needs and branding requirements of their applications, ensuring a cohesive and immersive user experience.

Initialization

The NGLMapView class provides two initializers. The initWithFrame: initializer takes a CGRect as input and creates a map view with the specified frame and the default style. The initWithFrame:styleURL: initializer takes a CGRect and a CGRect as input and creates a map view with the specified frame and style URL.

1- (instancetype)initWithFrame:(CGRect)frame;

Initialises and returns a newly allocated map view with the specified frame and the default style.

1- (instancetype)initWithFrame:(CGRect)frame styleURL:(nullable NSURL *)styleURL

Initialises and returns a newly allocated map view with the specified frame and style URL.

The style URL can be set after the map view has been initialized.

1 NSURL *styleURL;

Map components

The NGLMapView class provides properties for configuring the following map components:

1. Scale bar
2. Compass view
3. Logo view
4. Location and tracking mode
5. Camera

Scale bar

The scale bar displays the map's zoom level. The NGLMapView class provides properties for controlling whether the scale bar is displayed, its position, and its margins.

1/**
2 A Boolean value indicates whether the map may display scale information.
3 The scale bar may not be shown at all zoom levels. The scale bar becomes visible
4 when the maximum distance visible on the map view is less than 400 miles (800
5 kilometers). The zoom level where this occurs depends on the latitude at the map
6 view's center coordinate, as well as the device screen width. At latitudes
7 farther from the equator, the scale bar becomes visible at lower zoom levels.
8 The unit of measurement is determined by the user's device locale.
9 The view controlled by this property is available at `scaleBar`. The default value
10 of this property is `NO`.
11 */
12
13@property (nonatomic, assign) BOOL showsScale;
14/**
15 A control indicating the scale of the map. The scale bar is positioned in the
16 upper-left corner. Enable the scale bar via `showsScale`.
17 */
18@property (nonatomic, readonly) UIView *scaleBar;
19/**
20 The position of the scale bar. The default value is `NGLOrnamentPositionTopLeft`.
21 */
22@property (nonatomic, assign) NGLOrnamentPosition scaleBarPosition;
23/**
24 A `CGPoint` indicating the position offset of the scale bar.
25 */
26@property (nonatomic, assign) CGPoint scaleBarMargins;

The following parameters are optional for NGLOrnamentPosition:

1/** Place the ornament in the top left of the map view. */
2    NGLOrnamentPositionTopLeft = 0,
3    /** Place the ornament in the top right of the map view. */
4    NGLOrnamentPositionTopRight,
5    /** Place the ornament in the bottom left of the map view. */
6    NGLOrnamentPositionBottomLeft,
7    /** Place the ornament in the bottom right of the map view. */
8    NGLOrnamentPositionBottomRight,

Compass view

The compass view indicates the map's direction and allows the user to manipulate the direction. The NGLMapView class provides properties for controlling the compass view's position and margins. The compass view is displayed in the top-right corner of the map view by default. More detailed parameter Settings can be seen below：

1/**
2 A control indicates the map's direction and allows the user to manipulate
3 the direction, positioned in the upper-right corner.
4 */
5@property (nonatomic, readonly) NGLCompassButton *compassView;
6/**
7 The position of the compass view. The default value is `NGLOrnamentPositionTopRight`.
8 */
9@property (nonatomic, assign) NGLOrnamentPosition compassViewPosition;
10/**
11 A `CGPoint` indicating the position offset of the compass.
12 */
13@property (nonatomic, assign) CGPoint compassViewMargins;

compassView contains the compassView visibility property, which allows you to set the compassView display status

1/** A constant indicating that the ornament adapts to the current map state. */
2NGLOrnamentVisibilityAdaptive,
3/** A constant indicating that the ornament is always hidden. */
4NGLOrnamentVisibilityHidden,
5/** A constant indicating that the ornament is always visible. */
6NGLOrnamentVisibilityVisible

Logo view

The logo view displays the Nbmap wordmark. The NGLMapView class provides properties for controlling whether the logo view is displayed, its position, and its margins. The logo view is displayed in the bottom-left corner of the map view by default.

1/**
2 The Nbmap wordmark, is positioned in the lower-left corner.
3 */
4@property (nonatomic, readonly) UIImageView *logoView;
5/**
6 The position of the logo view. The default value is `NGLOrnamentPositionBottomLeft`.
7 */
8@property (nonatomic, assign) NGLOrnamentPosition logoViewPosition;
9/**
10 A `CGPoint` indicates the position offset of the logo.
11 */
12@property (nonatomic, assign) CGPoint logoViewMargins;

The following Settings can be used to control the display and hiding of logo view

1logoView.isHidden = false

Location and tracking mode

The NGLMapView class provides properties for controlling the user's location and the map's tracking mode. The locationManager property can be used to set a custom location manager. The showsUserLocation property controls whether the user's location is displayed on the map. The userLocationVisible property can be used to check whether the user's location is currently visible on the map. The userLocation property returns the annotation object that represents the user's current location. The userTrackingMode property controls the map's tracking mode. The default tracking mode is NGLUserTrackingModeNone.

userTrackingMode has the following parameters:

1    /** The map does not follow the user's location. */
2    NGLUserTrackingModeNone              = 0,
3    /** The map follows the user's location. This tracking mode falls back
4        to `NGLUserTrackingModeNone` if the user pans the map view. */
5    NGLUserTrackingModeFollow,
6    /**
7        The map follows the user's location and rotates when the heading changes.
8        The default user location annotation displays a fan-shaped indicator with
9        the current heading. The heading indicator represents the direction the
10        device is facing, which is sized according to the reported accuracy.
11        This tracking mode is disabled if the user pans the map view, but
12        remains enabled if the user zooms in. If the user rotates the map
13        view, this tracking mode will fall back to `NGLUserTrackingModeFollow`.
14     */
15    NGLUserTrackingModeFollowWithHeading,
16    /**
17        The map follows the user's location and rotates when the course changes.
18        The course represents the direction in which the device is traveling.
19        The default user location annotation shows a puck-shaped indicator
20        that rotates as the course changes.
21        This tracking mode is disabled if the user pans the map view, but
22        remains enabled if the user zooms in. If the user rotates the map view,
23        this tracking mode will fall back to `NGLUserTrackingModeFollow`.
24     */
25    NGLUserTrackingModeFollowWithCourse,

Camera

The NGLMapView class provides properties for controlling the camera view of the map.

1. The zoomLevel property of the NGLMapView class specifies the zoom level of the map. The zoom level affects the visual size and detail of features on the map, as well as the size of the vector tiles that are loaded. At zoom level 0, each tile covers the entire world map. At zoom level 1, each tile covers ¼ of the world. At zoom level 2, each tile covers 1/16 of the world, and so on. The zoomLevel property can be changed at any time. If you want to animate the change, you can use the -setZoomLevel:animated: method.

2. The minimumZoomLevel property sets the minimum zoom level at which the map can be shown.The default minimumZoomLevel is 0.

3. The maximumZoomLevel property sets the maximum zoom level at which the map can be shown.The default maximumZoomLevel is 22. The upper bound for this property is 25.5.

4. The direction property sets the heading of the map, measured in degrees clockwise from true north.The value 0 means that the top edge of the map view corresponds to true.

5. The minimumPitch property sets the minimum pitch of the map's camera toward the horizon, measured in degrees. If the value of this property is greater than that of the maximumPitch property, the behavior is undefined. The pitch may not be less than 0 regardless of this property.

6. The maximumPitch property sets the maximum pitch of the map's camera toward the horizon, measured in degrees. If the value of this property is smaller than that of the minimumPitch property, the behavior is undefined. The pitch may not exceed 60 degrees regardless of this property. The default value of this property is 60 degrees.

Detailed properties definitions can be found below

1@property (nonatomic) double zoomLevel;
2
3@property (nonatomic) double minimumZoomLevel;
4
5@property (nonatomic) double maximumZoomLevel;
6
7@property (nonatomic) CLLocationDirection direction;
8
9@property (nonatomic) CGFloat minimumPitch;
10
11@property (nonatomic) CGFloat maximumPitch;
12