From c3006bbfa7d04b4e784afcccc3feb5c39802e435 Mon Sep 17 00:00:00 2001 From: tjukanovt Date: Wed, 13 Sep 2023 14:39:34 +0300 Subject: [PATCH 1/2] update wording --- MIGRATION_GUIDE_v3.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/MIGRATION_GUIDE_v3.md b/MIGRATION_GUIDE_v3.md index a7d3a39a49f..a185f6789d8 100644 --- a/MIGRATION_GUIDE_v3.md +++ b/MIGRATION_GUIDE_v3.md @@ -109,7 +109,9 @@ Property | Type | Description `lightPreset` | `String` | Switches between 4 time-of-day states: `dusk`, `dawn`, `day`, and `night`. `font` | `Array` | Defines font family for the style from predefined options. -Mapbox Standard is making adding your own data layers easier for you through the concept of `slot`s. `Slot`s are pre-specified locations in the style where your layer will be added to (such as on top of existing land layers, but below all labels). To do this, we've added a new `slot` property to each `Layer`. This property allows you to identify which `slot` in the Mapbox Standard your new layer should be placed in. To add custom layers in the appropriate location in the Standard style layer stack, we added 3 carefully designed slots that you can leverage to place your layer: +### Custom data layers + +Mapbox Standard is making adding your own data layers easier for you through the concept of `slot`s. `Slot`s are pre-specified locations in the style where your layer will be added to (such as on top of existing land layers, but below all labels). To do this, we've added a new `slot` property to each `Layer`. This property allows you to identify which `slot` in the Mapbox Standard your new layer should be placed in. To add custom layers in the appropriate location in the Standard style layer stack, we added 3 carefully designed slots that you can leverage to place your layer. These slots will remain stable, so you can be sure that your own map won't break even as the basemap evolves automatically. Slot | Description --- | --- @@ -136,7 +138,13 @@ map.addLayer({ Like with the classic Mapbox styles, you can still use the layer position in `map.addLayer(layer, beforeId)` method when importing the Standard Style. But, this method is only applicable to custom layers you have added yourself. If you add two layers to the same slot with a specified layer position the latter will define order of the layers in that slot. -When using the Standard style, you get the latest basemap rendering features, map styling trends and data layers as soon as they are available, without requiring any manual migration/integration. On top of this, you'll still have the ability to introduce your own data to the map and control your user's experience. If you have feedback or questions about the Standard beta style reach out to: [hey-map-design@mapbox.com](mailto:hey-map-design@mapbox.com). +Standard is aware of the map lighting configuration using the `measure-light` expression, which returns you an aggregated value of your light settings. This returns a value which ranges from 0 (darkest) to 1 (brightest). In darker lights, you make the individual layers light up by using the new `*-emissive-stength` expressions, which allow you to add emissive light to different layer types and for example keep texts legible in all light settings. If your custom layers seem too dark, try adjusting the emissive strength of these layers. + +### Customizing Standard + +The underlying design paradigm to the Standard style is different from what you know from the classic core styles. Mapbox manages the basemap experience and surfaces key global styling configurations - in return, you get a cohesive visual experience and an evergreen map, always featuring the latest data, styling and rendering features compatible with your SDK. The configuration options make interactions with the basemap simpler than before. During the beta phase, we are piloting these configurations - we welcome feedback on the beta configurations. If you have feedback or questions about the Standard beta style reach out to: [hey-map-design@mapbox.com](mailto:hey-map-design@mapbox.com). + +You can customize the overall color of your Standard experience easily by adjusting the 3D light settings. Individual basemap layers and/or color values can’t be adjusted, but all the flexibility offered by the style specification can be applied to custom layers while keeping interaction with the basemap simple through `slot`s. Our existing, classic Mapbox styles (such as [Mapbox Streets](https://www.mapbox.com/maps/streets), [Mapbox Light](https://www.mapbox.com/maps/light), and [Mapbox Satellite Streets](https://www.mapbox.com/maps/satellite)) and any custom styles you have built in Mapbox Studio will still work like they do in v2, so no changes are required. From 564127fb3a6331c2fdd96f08bbfa45886463dac9 Mon Sep 17 00:00:00 2001 From: Stepan Kuzmin Date: Thu, 14 Sep 2023 14:19:42 +0300 Subject: [PATCH 2/2] Rename slot `none` -> `top` --- MIGRATION_GUIDE_v3.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/MIGRATION_GUIDE_v3.md b/MIGRATION_GUIDE_v3.md index a185f6789d8..81eba9638cd 100644 --- a/MIGRATION_GUIDE_v3.md +++ b/MIGRATION_GUIDE_v3.md @@ -117,7 +117,7 @@ Slot | Description --- | --- `bottom` | Above polygons (land, landuse, water, etc.) `middle` | Above lines (roads, etc.) and behind 3D buildings -`none` | If there is no identifier, the new layer will be placed above all existing layers in the style +`top` | Above all existing layers in the style Set the preferred `slot` on the `Layer` object before adding it to your map and your layer will be appropriately placed in the Standard style's layer stack. @@ -134,7 +134,7 @@ map.addLayer({ }); ``` -**Important**: For the new Standard style, you can only add layers to these three slots (`bottom`, `middle`, `none`) within the Standard style basemap. +**Important**: For the new Standard style, you can only add layers to these three slots (`bottom`, `middle`, `top`) within the Standard style basemap. Like with the classic Mapbox styles, you can still use the layer position in `map.addLayer(layer, beforeId)` method when importing the Standard Style. But, this method is only applicable to custom layers you have added yourself. If you add two layers to the same slot with a specified layer position the latter will define order of the layers in that slot.