diff --git a/content/admin/configuration/configuring-your-enterprise/configuring-applications.md b/content/admin/configuration/configuring-your-enterprise/configuring-applications.md index 7eedded0b1..47fe263c12 100644 --- a/content/admin/configuration/configuring-your-enterprise/configuring-applications.md +++ b/content/admin/configuration/configuring-your-enterprise/configuring-applications.md @@ -34,3 +34,18 @@ You can enable a retention policy for checks, actions, and associated data by se 4. Under "Delete threshold (days)", type the number of days for the deletion threshold. Archived checks older than this number of days will be permanently deleted. {% data reusables.enterprise_management_console.save-settings %} {% endif %} + +{% ifversion azure-maps %} +## Enabling interactive maps + +You can allow users to create interactive maps using GeoJSON or TopoJSON syntax. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams#creating-geojson-and-topojson-maps)." + +To enable interactive maps on {% data variables.location.product_location %}, you must enable the feature and provide a public authentication token for Azure. For more information, see [Authentication with Azure Maps](https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-authentication) in the Microsoft Docs. + +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +1. In the "Settings" sidebar, click **Privacy**. +1. To enable interactive maps, select "Enable GeoJSON rendering". +1. To configure authentication, under "Azure Maps API Token", paste your token. +{% data reusables.enterprise_management_console.save-settings %} +{% endif %} \ No newline at end of file diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams.md b/content/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams.md index c379a5a3c8..c1c313d45d 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams.md @@ -40,7 +40,9 @@ graph TD; ## Creating GeoJSON and TopoJSON maps -You can use GeoJSON/TopoJSON syntax to create interactive maps. To create a map, add GeoJSON or TopoJSON inside a fenced code block with the `geojson` or `topojson` syntax identifier. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks)." +You can use GeoJSON or TopoJSON syntax to create interactive maps. To create a map, add GeoJSON or TopoJSON inside a fenced code block with the `geojson` or `topojson` syntax identifier. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks)." + +{% data reusables.advanced-formatting.administrator-must-enable-mapping %} ### Using GeoJSON diff --git a/content/repositories/working-with-files/using-files/working-with-non-code-files.md b/content/repositories/working-with-files/using-files/working-with-non-code-files.md index a26efad8fd..6968967fc5 100644 --- a/content/repositories/working-with-files/using-files/working-with-non-code-files.md +++ b/content/repositories/working-with-files/using-files/working-with-non-code-files.md @@ -278,6 +278,8 @@ By default, the embedded map 420px x 620px, but you can customize the output by ### Mapping in Markdown You can embed GeoJSON and TopoJSON directly in Markdown. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams#creating-geojson-and-topojson-maps)." + +{% data reusables.advanced-formatting.administrator-must-enable-mapping %} {% endif %} ### Clustering diff --git a/data/features/azure-maps.yml b/data/features/azure-maps.yml new file mode 100644 index 0000000000..340ae5ff8e --- /dev/null +++ b/data/features/azure-maps.yml @@ -0,0 +1,3 @@ +# Documentation for enterprise only (>=3.7) specifying that admins need to provide their own Azure Maps token +versions: + ghes: '>=3.7' diff --git a/data/reusables/advanced-formatting/administrator-must-enable-mapping.md b/data/reusables/advanced-formatting/administrator-must-enable-mapping.md new file mode 100644 index 0000000000..a224c43b12 --- /dev/null +++ b/data/reusables/advanced-formatting/administrator-must-enable-mapping.md @@ -0,0 +1,5 @@ +{% ifversion azure-maps %} + +To display interactive maps, a site administrator must configure the feature for {% data variables.location.product_location %}. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/configuring-applications#enabling-interactive-maps)." + +{% endif %}