GMSNavigationInstructionOptions Class Reference

GMSNavigationInstructionOptions Class Reference

Overview

Options for formatting attributed instruction strings.

Properties

GMSNavigationStepInfoImageOptionsimageOptions
 Image options to be used when generating inline images.
BOOL disableLongDistanceFormat
 By default, instructions will sometimes use a special format for long-distance instructions, such as staying on the same highway for a long time.
UIFont * primaryFont
 The primary font to use when formatting the instructions.
UIFont * secondaryFont
 The secondary font to use when formatting the instructions.
UIFont * tertiaryFont
 The font for small elements like exit numbers or conjunctions.
UIColor * textColor
 The color to use for instruction text.
CGFloat primaryRoadShieldHeight
 The primary road shield height to assign when formatting the instructions.
CGFloat secondaryRoadShieldHeight
 The secondary road shield height to assign when formatting the instructions.
CGFloat roadShieldOutlineWidth
 The width of the outline drawn around road shields.
UIColor * roadShieldOutlineColor
 The color of the outline drawn around road shields.
CGFloat exitNumberHeight
 The exit cue height to use when formatting the instructions.
UIColor * exitCueBackgroundColor
 The exit cue background color to assign when formatting the instructions.

Property Documentation

Image options to be used when generating inline images.

Setting this to nil specifies using a default set of image options.

- (BOOL) disableLongDistanceFormat [read, write, assign]

By default, instructions will sometimes use a special format for long-distance instructions, such as staying on the same highway for a long time.

Setting this to YES will disable the use of such instructions. This can be an overall better experience on space-constrained displays such as CarPlay.

Defaults to NO.

- (UIFont*) primaryFont [read, write, copy]

The primary font to use when formatting the instructions.

Setting this to nil implies use of the default font from the Google navigation experience.

- (UIFont*) secondaryFont [read, write, copy]

The secondary font to use when formatting the instructions.

Setting this to nil implies use of the default font from the Google navigation experience.

- (UIFont*) tertiaryFont [read, write, copy]

The font for small elements like exit numbers or conjunctions.

Setting this to nil implies use of the default font from the Google navigation experience.

- (UIColor*) textColor [read, write, copy]

The color to use for instruction text.

Setting this to nil implies white.

- (CGFloat) primaryRoadShieldHeight [read, write, assign]

The primary road shield height to assign when formatting the instructions.

Road shields are the logos for particular highways or other roads. They may be used inline in the attributed instructions in order to more compactly reference a road. This value controls the height assigned to such road shields.

- (CGFloat) secondaryRoadShieldHeight [read, write, assign]

The secondary road shield height to assign when formatting the instructions.

See primaryRoadShieldHeight for a description of road shields.

- (CGFloat) roadShieldOutlineWidth [read, write, assign]

The width of the outline drawn around road shields.

By default, the width is 0, which will cause no outline to be drawn.

See primaryRoadShieldHeight for a description of road shields.

- (UIColor*) roadShieldOutlineColor [read, write, assign]

The color of the outline drawn around road shields.

By default, the color is nil, which will cause no outline to be drawn.

See primaryRoadShieldHeight for a description of road shields.

- (CGFloat) exitNumberHeight [read, write, assign]

The exit cue height to use when formatting the instructions.

When exiting a highway or other limited access road, instructions may reference specific exit numbers in some situations. When this is done, a graphic highlighting the exit number may be created. This property allows controlling the height of that graphic.

- (UIColor*) exitCueBackgroundColor [read, write, copy]

The exit cue background color to assign when formatting the instructions.

When exiting a highway or other limited access road, instructions may reference specific exit numbers in some situations. When this is done, a background color may be assigned to the graphic highlighting the exit number. This property allows controlling that color.

Setting this to nil implies use of the default color from the Google navigation experience.