Merge pull request #295515 from MicrosoftDocs/repo_sync_working_branch

Confirm merge from repo_sync_working_branch to main to sync with https://github.com/MicrosoftDocs/azure-docs (branch main)

Author: Taojunshen

articles/azure-maps/choose-map-style.md

@@ -27,7 +27,7 @@ var map = new atlas.Map('map', {
     style: 'road'
 
     //Additional map options.
-};
+});
 
 //Update the style options at anytime using `setStyle` function.
 map.setStyle({
@@ -37,8 +37,6 @@ map.setStyle({
 });
 ```
 
-For a fully functional sample that shows how the different styles affect how the map is rendered, see [Map style options] in the [Azure Maps Samples]. For the source code for this sample, see [Map style options source code].
-
 <!-----------------------------------------------------------------------------------------------
 <br/>
 > [!VIDEO https://codepen.io/azuremaps/embed/eYNMjPb?height=700&theme-id=0&default-tab=result]
@@ -57,7 +55,7 @@ var map = new atlas.Map('map', {
     style: 'grayscale_dark',
 
     //Additional map options
-);
+});
 ```
 
 :::image type="content" source="./media/choose-map-style/set-base-map-style-on-initialization.png" alt-text="Screenshot showing the grayscale dark style being set during the map load process.":::
@@ -85,6 +83,74 @@ map.setStyle({ style: 'satellite' });
 > [!VIDEO //codepen.io/azuremaps/embed/yqXYzY/?height=265&theme-id=0&default-tab=js,result&embed-version=2&editable=true]
 ----------------------------------------------------------------------------------------------->
 
+## Customize the base map
+The [styleOverrides] options enable users to streamline the base map by turning off specific map elements like country/region borders, administrative district borders, building footprints, and road detail layers. This allows for a cleaner and simpler map view, making it easier to visualize geometry data.
+
+The following code shows how to disable country/region borders and building footprints on the map.
+
+```javascript
+var map = new atlas.Map('map', {
+    styleOverrides: {
+        countryRegion: { borderVisible: false },
+        buildingFootprint: { visible: false },
+    },
+
+    //Additional map options
+});
+```
+
+Here are examples of all five available `styleOverrides` options:
+
+- Country/region borders
+   
+```javascript
+styleOverrides: {
+    countryRegion: { borderVisible: false }
+}
+```
+:::image type="content" source="./media/choose-map-style/country-region.gif" alt-text="An animated GIF that shows country/region borders on a map.":::
+
+- Admin district borders
+
+```javascript
+styleOverrides: {
+    adminDistrict: { borderVisible: false }
+}
+```
+:::image type="content" source="./media/choose-map-style/admin-district.gif" alt-text="An animated GIF that shows admin district borders.":::
+
+- Second admin district borders
+
+```javascript
+styleOverrides: {
+    adminDistrict2: { borderVisible: false }
+}
+```
+:::image type="content" source="./media/choose-map-style/admin-district-2.gif" alt-text="An animated GIF that shows second admin district borders.":::
+
+- Building footprints
+
+```javascript
+styleOverrides: {
+    buildingFootprint: { visible: false }
+}
+```
+:::image type="content" source="./media/choose-map-style/building-footprint.gif" alt-text="An animated GIF that shows building footprints.":::
+
+- Road details
+
+```javascript
+styleOverrides: {
+    roadDetails: { visible: false }
+}
+```
+:::image type="content" source="./media/choose-map-style/road-details.gif" alt-text="An animated GIF that shows road details.":::
+
+> [!NOTE]
+> For more information on the supported map styles on each `styleOverrides` option, see the [styleOverrides] API documentation.
+
+For a sample showing the different styles and how they affect how the map is rendered, see [Map style options] in the [Azure Maps Samples]. For this sample's source code, see [Map style options source code].
+
 ## Add the style picker control
 
 The style picker control provides an easy to use button with flyout panel that can be used by the end user to switch between base styles.
@@ -154,6 +220,7 @@ See the following articles for more code samples to add to your maps:
 > [Add a bubble layer]
 
 [style options]: /javascript/api/azure-maps-control/atlas.styleoptions
+[styleOverrides]: /javascript/api/azure-maps-control/atlas.styleoverrides
 [base map styles]: supported-map-styles.md
 
 [Add a bubble layer]: map-add-bubble-layer.md

articles/azure-maps/media/choose-map-style/admin-district-2.gif

@@ -53,9 +53,8 @@ When a customer has a deployed Azure VMware Solution private cloud, they can sca
 
 **Azure VMware Solution stretched clusters private cloud**: The AV64 SKU isn't supported with Azure VMware Solution stretched clusters private cloud. This means that an AV64-based expansion isn't possible for an Azure VMware Solution stretched clusters private cloud. 
 
-[!NOTE]
-
-All traffic from an AV64 host towards a customer network will utilize the IP address of the VMKernel Network Interface 1.
+> [!NOTE]
+> All traffic from an AV64 host towards a customer network will utilize the IP address of the VMKernel Network Interface 1.
 
 ### AV64 Cluster vSAN fault domain (FD) design and recommendations
 

articles/azure-maps/media/choose-map-style/admin-district.gif

@@ -98,7 +98,7 @@ You should follow the steps to initiate a local Azure Function project.
     });
     ```
 
-    This step creates a function `negotiate` with Http Trigger and `SocketIONegotiation` output binding, which means you can use an Http call to trigger the function and return a negotiation result that generated by `SocketIONegotiation` binding.
+    This step creates a function `negotiate` with HTTP Trigger and `SocketIONegotiation` output binding, which means you can use an HTTP call to trigger the function and return a negotiation result that generated by `SocketIONegotiation` binding.
 
 1. Create a function for handing messages.
 
@@ -219,7 +219,7 @@ You should follow the steps to initiate a local Azure Function project.
 
         async function index(request, context) {
             try {
-                context.log(`Http function processed request for url "${request.url}"`);
+                context.log(`HTTP function processed request for url "${request.url}"`);
 
                 const filePath = path.join(__dirname,'../public/index.html');
                 const html = await fs.readFile(filePath);

articles/azure-maps/media/choose-map-style/building-footprint.gif

@@ -158,8 +158,8 @@ Next you want to open `index.html` in VS Code and add the following snippet.
 </body>
 ```
 
-[!IMPORTANT]
-It's important here to note that this file `index.html` and the JavaScript bundle `outboundCallComposite.js` need to be in the same folder if you wish to not edit any of the importing in this file.
+> [!IMPORTANT]
+> It's important here to note that this file `index.html` and the JavaScript bundle `outboundCallComposite.js` need to be in the same folder if you wish to not edit any of the importing in this file.
 
 #### 3. Setting up Azure Communication Services and your Teams Voice Application
 
@@ -197,8 +197,8 @@ npx http-server@latest -p 3000
 ```
 This script using Node starts an HTTP server and hosts the `index.html` file and JavaScript bundle. In a browser open http://localhost:3000. You should see a white page with a button, and when you click it you should see the following screen.
 
-[!IMPORTANT]
-Note, if you try to go to the page not using local host, your calling experience won't work due to security reasons.
+> [!IMPORTANT]
+> Note, if you try to go to the page not using local host, your calling experience won't work due to security reasons.
 
 [![Screenshot of js bundle sample app homescreen.](../media/calling-widget/js-bundle-splash.png)](../media/calling-widget/js-bundle-splash.png#lightbox)
 

articles/azure-maps/media/choose-map-style/country-region.gif

@@ -609,7 +609,7 @@ Create a new agent pool to run the self-hosted runner.
 
 To run a self-hosted runner, you need to create a personal access token (PAT) in Azure DevOps. The PAT is used to authenticate the runner with Azure DevOps. It's also used by the scale rule to determine the number of pending pipeline runs and trigger new job executions.
 
-[!NOTE]
+> [!NOTE]
 > Personal Access Tokens (PATs) have an expiration date. Regularly rotate your tokens to ensure they remain valid (not expired) to maintain uninterrupted service.
 
 1. In Azure DevOps, select *User settings* next to your profile picture in the upper-right corner.