---
sourceDocument: Australia Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/now-intelligence

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Create a key-value pair mapping

# Create a key-value pair mapping {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

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.

## Vorbereitungen

Role required: report_admin or admin.

## Warum und wann dieser Vorgang ausgeführt wird

Default system key-value pairs map data to geoJSON hc-key values. All hc-key values
follow ISO 3166 standards. Default mappings exist for the most commonly used data
values. If your data uses a different value, you must create a key-value pair
mapping.

For example, the default mapping for United States of America maps key
USA to `ISO` value `us`. If your data has value of
United States instead of USA, you must make a new key-value pair to map
`United States` to ISO value `us`.

## Prozedur

1. Navigate to the Locations Mappings \[sys_report_map_source_mappings\] table.
2. In the Map Source Mapping column, select the mapping group to add the mapping to.  
   Select the mapping group that corresponds to type of object that you want to create a mapping for. For example, if you are creating a mapping for field value United States, select the Country mappings group. Note that the Key and Map values in the row with the mapping aren't taken into account. Abbildung : 1. Select map source mapping
3. Select New.
4. Fill in these fields.  
   {#t_CreateKeyValuePairMapping__table_pkd_3xx_bv__entry__2}

   | Field | Description |
   |-|-|
   | Key | The field value to transform. For example, USA. |
   | Value | The value to transform the key to. For example, us. This value is typically an ISO 3166 standard value. Each value can be used only once per map. |
   | Map | The map to associate with this mapping. If you do not fill in this field, this mapping can be used with any map. |
   [Tabelle : 1. Locations Mappings form]

   {#t_CreateKeyValuePairMapping__table_pkd_3xx_bv}
5. Select Submit to save your changes.

## Nächste Maßnahme

Add the mapping to a report source, so it can be used to map data from that source to
a map.
**Zugehörige Konzepte**   

* [Map report objects](https://servicenow-prod.fluidtopics.net/yhbEWBUVKtlsjiEYVqFqlA "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.")  
**Zugehörige Tasks**   

* [Automatically generate a map source hierarchy](https://servicenow-prod.fluidtopics.net/i_KYTr2kOGl1B0a4~buzMw "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/NOWPcuQZHrEapnMTjfbzhg "A map source configures data to be displayed in a map report. Customize existing map sources according to your needs.")
* [Create a map](https://servicenow-prod.fluidtopics.net/acOvc6~58HOhzKsw2iurRA#t_CreateAMap "Create a map that can be used in a map hierarchy.")