Goong DocumentsStyle Specification

Style Specification

Current version: v14.0.0 View changelog

    A Goong style is a document that defines the visual appearance of a map: what data to draw, the order to draw it in, and how to style the data when drawing it. A style document is a JSON object with specific root level and nested properties. This specification defines and describes these properties.

    The intended audience of this specification includes:

    • Advanced designers and cartographers who want to write styles by hand.
    • Developers using style-related features of Goong GL JS
    • Authors of software that generates or processes Goong styles.

    Available styles

    • Light
    https://tiles.goong.io/assets/goong_light_v2.json
    
    • Street
    https://tiles.goong.io/assets/goong_map_web.json
    
    • Dark
    https://tiles.goong.io/assets/goong_map_dark.json
    
    • Navigation Light
    https://tiles.goong.io/assets/navigation_day.json
    
    • Navigation Dark
    https://tiles.goong.io/assets/navigation_night.json
    

    Style document structure

    A Goong style consists of a set of root properties, some of which describe a single global property, and some of which contain nested properties. Some root properties, like version, name, and metadata, don't have any influence over the appearance or behavior of your map, but provide important descriptive information related to your map. Others, like layers and sources, are critical and determine which map features will appear on your map and what they will look like. Some properties, like center, zoom, pitch, and bearing, provide the map renderer with a set of defaults to be used when initially displaying the map.