---
sourceDocument: Australia ServiceNow AI Platform user interface
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/platform-user-interface

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia ServiceNow AI Platform user interface

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Add a map filter

# Add a map filter {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

Add a map filter to display filtered map markers. This filter enables you to see only
the map markers for the data that you want.

## Antes de Iniciar

A [map data item](https://servicenow-prod.fluidtopics.net/wFEVT5r3oaIadUpCwYzGkg "Add map data items to render data on your Map Page using the Classic Environment.") should be configured before accomplishing this task. The example map data item can work with the example map filter tables below to successfully set up a map filter.

Role required:
admin

## Por Que e Quando Desempenhar Esta Tarefa

Map filters can be configured using lists and forms, or scripting. Create a container
for your map filters first, configure filter items, and then choose a Map Page for
your filter.

## Procedimento

1. Navigate to AllSystem Map PageMap Filters.
2. Click New.
3. In the Name field, enter a name for the map filter.
4. In the Application field, define the application scope, if other than Global.
5. Click the menu icon (![Menu icon]()) and select Save.
6. In the Map filter item field, double-click the record and click the search icon (![Search icon]()).
7. To create a Map Page filter item, click New.
8. On the form, fill in the fields.  
   {#set-up-map-filters__table_ewl_cpm_1kb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name for your Map Page filter item. |
   | Label | Title for your Map Page filter item that's displayed in the map filter in your Map Page. |
   | UI Type | UI type for your Map Page filter item. This determines how your filter displays on the map page. Select Single selection, Multiple selection, or Date picker. When you select Date picker, the data item fields hide and the default value script appears. |
   | Data type | Data type for your Map Page filter item. Select Data item or Scripted for the data type. A data item enables you to configure or select data items using lists and forms. |
   | Application | Application scope for your Map Page filter item, if other than Global. Nota: This field is optional. |
   | Data item | Data item for your Map Page filter item. Select the data item that you previously configured. |
   | Data item table | Data item table for your Map Page filter item. Nota: This field is automatically populated when a data item is selected. |
   | Data item value field | Data item value field for your Map Page filter item. Choose how data is used in a table. |
   | Default value script | Scripting field for your Map Page filter item. |
   [Tabela 1. Map Page Filter Item form]

   {#set-up-map-filters__table_ewl_cpm_1kb}
9. Click Submit.
10. When you return to the Map Page Filter form, click the check mark icon (![Check mark icon]()).  
    The name of the Map Page filter item that you created is displayed in the field.
11. Click the menu icon (![Menu icon]()) and select Save.

## Map Page Filter Item form

Select the options in the table to successfully create your Map Page filter item. This setup works with the [map data item example](https://servicenow-prod.fluidtopics.net/wFEVT5r3oaIadUpCwYzGkg "Add map data items to render data on your Map Page using the Classic Environment.").{#set-up-map-filters__table_drl_r1j_nkb__entry__2}

| Field | Description |
|-|-|
| Name | Enter <kbd class="ph userinput">Incident</kbd>. |
| Label | Enter <kbd class="ph userinput">Incident</kbd>. |
| UI Type | Select Single selection. |
| Data type | Select the data item. |
| Application | Skip this field. |
| Data item | Select Incident state. Nota: This data item is the map data item you created in the map data item example. |
| Data item table | Skip this field. Nota: This field is automatically populated when a data item is selected. |
| Data item value field | Select Value. |
| Default value script | Skip this field. |
[ ]

{#set-up-map-filters__table_drl_r1j_nkb}

## O que Fazer Depois

Continue to the next task to [configure a map filter data mapping](https://servicenow-prod.fluidtopics.net/AUuWhvgz9cxsR_4VjxyGZA#configure-map-filter-data-mappings "Choose a Map Page for your map filter, and determine how it functions on the Map Page.").

## Configure a map filter data mapping {#ariaid-title2}

Choose a Map Page for your map filter, and determine how it functions on the Map
Page.

### Antes de Iniciar

Role required: admin

### Procedimento

1. Navigate to AllSystem Map PageMap Filters.
2. Select your map filter.
3. On the Map Page Filter record, select your map filter item.
4. On the Map Page Filter Item record, locate the Map Filter Data Mappings related list and select New.
5. On the form, fill in the fields.  
   {#configure-map-filter-data-mappings__table_xks_j1m_1kb__entry__2}

   | Field | Description |
   |-|-|
   | Map page | Map Page where your map filter is applied. |
   | Data item | Data item for your map filter data mapping. Select the data item that you previously configured. |
   | Application | Optional application scope for your map filter data mapping. |
   | Filter item | Filter item for your map filter data mapping. Select the filter item that you previously configured. Nota: This field is automatically populated with the filter item. |
   | Table | Table for your map filter data mapping. Nota: This field is automatically populated when a data item is selected. |
   | Field | Data is retrieved from this field in the table that you selected. |
   [Tabela 2. Map Filter Data Mapping form]

   {#configure-map-filter-data-mappings__table_xks_j1m_1kb}
6. Select Submit.

### Map Filter Data Mapping form

Select the options in the table to create your map filter data mapping. This setup works with the [map data item example](https://servicenow-prod.fluidtopics.net/wFEVT5r3oaIadUpCwYzGkg "Add map data items to render data on your Map Page using the Classic Environment.").{#configure-map-filter-data-mappings__table_mpw_bmq_nkb__entry__2}

| Field | Description |
|-|-|
| Map page | Select the Map Page that you created. |
| Data item | Select Incident state. Nota: This data item is the map data item that you created in the map data item example. |
| Application | Skip this field. |
| Filter item | Skip this field. Nota: This field is automatically populated when a data item is selected. |
| Table | Skip this field. Nota: This field is automatically populated with the Choice \[sys_choice\] selection. |
| Field | Select Value. |
[ ]

{#configure-map-filter-data-mappings__table_mpw_bmq_nkb}

### O que Fazer Depois

Continue to the next task to [select your map filter](https://servicenow-prod.fluidtopics.net/AUuWhvgz9cxsR_4VjxyGZA#select-map-filters "Select your map filter to complete the Map Page filter setup. This setup applies the map filter to your Map Page."), and complete the map filter setup.

## Select map filters {#ariaid-title3}

Select your map filter to complete the Map Page filter setup. This setup applies the
map filter to your Map Page.

### Antes de Iniciar

Role required: admin

### Procedimento

1. Navigate to AllSystem Map PageMap Pages.
2. Select the Map Page that you want to apply your map filter to.
3. Select the Use advanced configuration check box.
4. In the Filter field, click the search icon (![Search icon]()) and select the map filter that you created.
5. Click the menu icon (![Menu icon]()) and select Save.

### O que Fazer Depois

You've set up your map filter. Continue to the [next task](https://servicenow-prod.fluidtopics.net/AUuWhvgz9cxsR_4VjxyGZA#check-map-filter "Check to see that your map filter was successfully created in your Map Page.") to see that you have successfully created it.

## Check your map filter {#ariaid-title4}

Check to see that your map filter was successfully created in your Map
Page.

### Antes de Iniciar

Role required: admin

### Procedimento

1. Navigate to AllSystem Map PageMap Pages.
2. Select your Map Page.
3. Click Try It.
4. In your Map Page, click Filter.  
   Your map filter appears.