Use locally generated ideographs

Rendering Chinese/Japanese/Korean (CJK) ideographs and precomposed Hangul Syllables requires downloading large amounts of font data, which can significantly slow map load times. Use the localIdeographFontFamily setting to speed up map load times by using locally available fonts instead of font data fetched from the server. This setting defines a CSS ‘font-family’ for locally overriding generation of glyphs in the ‘CJK Unified Ideographs’ and ‘Hangul Syllables’ Unicode ranges. In these ranges, font settings from the map’s style will be ignored in favor of the locally available font. Keywords in the fontstack defined in the map’s style (light/regular/medium/bold) will be translated into a CSS ‘font-weight’.

This setting is enabled by default to use the system ‘sans-serif’ font. When overriding this setting, the fonts you select may not be available on all users’ devices. Specify at least one broadly available fallback font class such as ‘sans-serif’.

Related examples

Change the case of labels

Example

Use the upcase and downcase expressions to change the case of labels.

Display and style rich text labels

Example

Use the format expression to display country labels in both English and in the local language.

Icon image URL inside a rich text format label

Example

Use the Formatted type to display a rich text labels with texts and icons from images URL.

Set map language

Example

This tutorial shows how to change the default map labels language.