---
sourceDocument: Xanadu Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Customize a map source level

# Customize a map source level {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read

A map source configures data to be displayed in a map report. Customize existing map sources according to your needs.{#t_CustomizeAMapSourceLevel__ph_csx_52y_zy}

## Before you begin

Role required: report_admin or admin

## About this task

Note:  
A set of predefined map sources and maps are available by default. Use these predefined objects whenever possible. If you need a map source that does not exist, generate it automatically using Generate map source levels link on the map source form, then customize it. You can automatically generate map source levels only for map sources that reference the location table. These map sources have a field that ends in .location.

## Procedure

1. Navigate to AllReportsAdministrationMap Sources.
2. Open the map source whose level you want to customize, then navigate down to the appropriate level using the Map Sources related lists.  
   For example, click the level 1 map source name to reopen the Map Source form with the level 2 map source in the related list, and so on.
3. Modify these fields as appropriate.  
   {#t_CustomizeAMapSourceLevel__table_njp_mdw_y5__entry__2}{#t_CustomizeAMapSourceLevel__ph_cwh_nyz_zy}{#t_CustomizeAMapSourceLevel__ph_yk5_211_1z}

   | Field | Description |
   |-|-|
   | Name | Enter a name for the map source. Include the level in the names of map source levels. For example, Incident by location - level 2. |
   | Table | The same table is used throughout a map source hierarchy, and is specified in the top-level map source. |
   | Field | Select the field whose data you want to display on the map. You can dot walk to other fields. Select a field that is one level more granular than the map you want to display the data on. For example, imagine you are configuring data for a level 1 map source that is displayed on the world map. Because the data for countries are displayed on the world map, select Location Country. Similarly, if you are configuring data to display on a map of Germany or the United States, select Location State / Province. Note: The city label is the most granular level able to be displayed when drilling down into a map report. For example: If you want to report on various site locations within a city, and define the bottom-level map source field to include location.name, the map report displays the multiple locations as the corresponding city labels. As a result, reporting on multiple locations which have the same location.city value results in displaying multiple map dots with the same label, but with different aggregated values, and which drill down to different locations. Most map sources use a field on the Location table. |
   | Level | Select a hierarchy level for this map source. You can have a maximum of four levels. Each map source level corresponds to a drill level on the map hierarchy, and these levels much match. Each level must exist in a hierarchy only once. |
   | Active | Clear this check box to make this map source unavailable when creating map reports. |
   [Table 1. Map source fields]

   {#t_CustomizeAMapSourceLevel__table_njp_mdw_y5}
4. In the Data transformation section, modify these fields as appropriate.  
   {#t_CustomizeAMapSourceLevel__table_wxt_3dg_1v__entry__2}{#t_CustomizeAMapSourceLevel__ph_rmc_mb1_1z}

   | Field | Description |
   |-|-|
   | Data | Select how to use data in this map source. * Use data on table: Use the data in the ServiceNow platform without transforming it. Select this option when the data already matches the JSON key values that you are mapping to. * Use mapping: Transform that data so it matches the JSON key values that you are mapping to. For geographical map sources that use the hc-key geoJSON key, always select this option. * Use longitude and latitude: Use latitude and longitude coordinates to plot your data. Always select this option for the bottom map level, such as level 3. Ensure that your data has latitude and longitude values. Warning: Because the Use longitude and latitude option disables heatmap and drilling for maps using this map source, select this option only on map source levels that are the bottom level in a hierarchy. {#t_CustomizeAMapSourceLevel__ul_amx_zfg_1v} |
   | Use these mappings | If you selected Use mapping, select a mapping group to use. A mapping group is a collection of key-value pair mappings that transform data. To review the mappings in a mapping group, go to the Locations Mappings \[sys_report_map_source_mapping\] table. For example, if you are transforming field value USA to hc-key value us, select Country mappings, which contains the relevant key-value pair mapping. |
   [ ]

   {#t_CustomizeAMapSourceLevel__table_wxt_3dg_1v}
5. In the JSON key section, select a JSON key to connect the map source data to maps.  
   Geographical maps typically use hc-key.

   Every report map has a JSON
   definition. Select one JSON key-value pair to map the data to. The data to
   appear on the map must match the JSON key values. So the key that you select
   determines whether you must transform your data with the settings in the
   How to use data section. All default platform
   maps and mappings use the [geoJSON](http://geojson.org/) hc-key and ISO 3166 standard values. For
   custom maps, you can enter a different JSON key.
6. Click Update.
**Related concepts**   

* [Map report objects](https://servicenow-prod.fluidtopics.net/nvgfNcIFNc0kVphuRGLxxw "Map objects define the different levels that users can drill down into on a map report and the data displayed on these levels. Admins can create and manage these objects.")  
**Related tasks**   

* [Automatically generate a map source hierarchy](https://servicenow-prod.fluidtopics.net/ayM0GVQcO2gVQXBWOCCbNw "A map source hierarchy is a data source that is used to create a map report. Except for the top-level wrapper, each map source level in the hierarchy defines the data for one map drill level.")
* [Create a key-value pair mapping](https://servicenow-prod.fluidtopics.net/Fy3cMQPmZ3XW3gqbRvBomQ "Key-value pair mappings transform data in the ServiceNow platform to a value that can be plotted on a map. Mappings are used during map source configuration when data requires transformation. Each mapping exists in a mapping group.")
* [Create a map](https://servicenow-prod.fluidtopics.net/sjcp9swq2mHSdwocXOcqbg#t_CreateAMap "Create a map that can be used in a map hierarchy.")

*[\>]: and then