---
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


---

# Map report objects

# Map report objects {#ariaid-title1}

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

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.

Each map report contains a map source hierarchy, which configures the data for a map level. The
report also contains a map hierarchy, which defines the map drill levels. The Level field
connects levels for these hierarchies. For example, the data in the Level 1 map is displayed on
the Level 1 map object.  
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.  
{#c_MapReportObjects__table_dsl_3tv_y5__entry__2}

| Object | Description |
|-|-|
| Map source | Defines a set of data to display on a map report. The map source that a user selects in the Map data field when creating a map report is actually a map source hierarchy. There is one map source level for each drill level on the map. The top map source in the hierarchy is not a level, but rather a wrapper for other hierarchy levels. Each map source contains the data for a single map hierarchy drill level, with both having the same Level. Because they both specify the data that is used for a report, a map source is similar to a report source. However, in a map source you select a field to report on instead of a table. |
| Map | The map that data is displayed on. Maps are set up in a hierarchy defined by parent-child relationships. Each hierarchy level is a drill level on the map report. A JSON definition (geoJSON definition for geographical maps) defines the actual map layout. Select an existing map or create a new one. You can optionally define conditions for a map, which further filters the data it displays. |
| Mappings | Transform the data in a map source to a value that can be displayed on a map. Mappings are organized into the Countries and State / Province mapping groups. During map source configuration, you select the mapping group to transform the data in that source. The mapping group that you select must match the Field that you have selected. For example, a map source that has a Field value of Locations Country would use the Country mappings group. A map source that has a Field value of Locations State / Province would use the Region and state mappings mapping group. |
[Table 1. Map objects]

{#c_MapReportObjects__table_dsl_3tv_y5}
**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.")
* [Customize a map source level](https://servicenow-prod.fluidtopics.net/Q~NTYfJOw0HRcUEmVJn8Eg "A map source configures data to be displayed in a map report. Customize existing map sources according to your needs.")
* [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.")