---
schema_version: "1"
id: f3d14edfe752ad691a7fc189866aa268d74f92a73c35840033b84827e5d07e1d
title: Format Geographic Fields in Tableau
collection: tableau
version: current
locale: en-us
portal_url: https://docs.salesforce.com/tableau/current/en-us/public/desktop/maps_geographicroles.md
canonical_url: https://help.tableau.com/current/public/desktop/en-us/maps_geographicroles.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 5217b696d30a485d19731a28942094c186bfbfcf082a78f55982166ce6562872
description: Assign geographic roles to fields so you can use them to create map views.
---
[Skip to main content](#main-content)

# Assign Geographic Roles

This article describes how to assign a geographic role to a field in Tableau so you can use it to create a map view.

A _geographic role_ associates each value in a field with a latitude and longitude value. When you assign a geographic role to a field, Tableau assigns latitude and longitude values to each location in your data based on data that is already built in to the Tableau map server.

## Assign a geographic role to a field

Assigning a geographic role based on the type of location (such as state versus postcode) helps ensure that your data is plotted correctly on your map view. For example, you can assign the City geographic role to a field that contains a list of city names.

When a field is assigned a geographic role, Tableau creates a map view when you add the field to **Detail** on the **Marks** card. In other words, Tableau _geocodes_ the information in that field.

**To assign a geographic role to a field:**

- In the Data pane, click the data type icon next to the field, select Geographic Role, and then select the geographic role you want to assign to the field.

![Geographic Roles menu to select geographic role type.](/tableau/current/en-us/public/desktop/en-us/Img/georoles1.png)

When you assign a geographic role to a field, Tableau adds two fields to the measures area of the Data pane: Latitude (generated) and Longitude (generated).

These fields contain latitude and longitude values and are assigned the Latitude and Longitude geographic roles. If you double-click each of these fields, Tableau adds them to the Columns and Rows shelves and creates a map view using the Tableau background map.  
![Latitude and Longitude measures generated by Tableau.](/tableau/current/en-us/public/desktop/en-us/Img/georoles2.png)

## Types of geographic roles in Tableau

The following table describes the geographic roles available in Tableau. Many of the roles are international, but some are limited to the US only.

You can assign geographic roles to your fields based on the type of geographic data they contain. For example, you can assign the Airport geographic role to a field that contains International Air Transport Association (IATA) codes.

If your location data does not fit into one of these roles, you may have to import custom geocoding to plot the data on a map. For more information, see [Geocode Locations Tableau Does Not Recognize and Plot Them on a Map](https://help.tableau.com/current/public/desktop/en-us/custom_geocoding.htm).

<table style="width: 100%;mc-table-style: url('Resources/TableStyles/Shaded-NoBorder.css');" class="TableStyle-Shaded-NoBorder" cellspacing="0"><colgroup><col class="Column-Column1"> <col class="Column-Column1"></colgroup><tbody><tr class="Body-Body1"><td class="BodyE-Column1-Body1"><b>Geographic Role</b></td><td class="BodyD-Column1-Body1"><b>Assign this role to a field if it contains:</b></td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Airport</td><td class="BodyD-Column1-Body2">International Air Transport Association (IATA) or International Civil Aviation Organization (ICAO) airport codes.</td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">Area Code (US)</td><td class="BodyD-Column1-Body1">US telephone area codes; numbers only.</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">CBSA/MSA (US)</td><td class="BodyD-Column1-Body2">US Core Based Statistical Areas (CBSA), which includes Metropolitan Statistical Areas (MSA), as defined by the US Office of Management and Budget. CBSA/MSA Codes and Names are recognized.</td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">City</td><td class="BodyD-Column1-Body1">Worldwide cities with population of 15,000 or more. Names are in English (UK&nbsp;or US), French, German, Spanish, Brazilian-Portuguese, Japanese, Korean, and Chinese (Simplified and Traditional).</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Congressional District (US)</td><td class="BodyD-Column1-Body2">US congressional districts.</td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">Country/Region</td><td class="BodyD-Column1-Body1">Worldwide countries, regions, and territories. Names are in English (UK or US), French (Canada and France), German, Spanish, Brazilian-Portuguese, Japanese, Korean, Chinese (Simplified and Traditional), Swedish, Thai, and Dutch. Tableau also recognizes, FIPS 10, ISO 3166-1 alpha 2, and ISO 3166-1 alpha 3. Names are included in various forms, including long, short, and various abbreviations.</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">County</td><td class="BodyD-Column1-Body2">Second-level administrative divisions for select countries. For example, US counties, French départements, German kriese, etc.<br><br><b>Note:</b> Second-level administrative division definitions vary by country. In Tableau, all second-level administrative divisions are geocoded with the County geographic role. For more information, see the <a href="https://help.tableau.com/current/public/desktop/en-us/maps_data.htm#Counties" class="xref">Location Data that Tableau Supports for Building Map Views</a> section.</td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">NUTS Europe</td><td class="BodyD-Column1-Body1">NUTS (Nomenclature of Territorial Units for Statistics) levels 1–3 codes. Codes and names, including synonyms, are supported.</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">Latitude</td><td class="BodyD-Column1-Body2">Latitude in decimal degrees. Only available for numeric fields.</td></tr><tr class="Body-Body1"><td class="BodyE-Column1-Body1">Longitude</td><td class="BodyD-Column1-Body1">Longitude in decimal degrees. Only available for numeric fields.</td></tr><tr class="Body-Body2"><td class="BodyE-Column1-Body2">State/Province</td><td class="BodyD-Column1-Body2">Worldwide state, province, and other first-level administrative divisions. Names are in English (UK or US), French, German, Spanish, Brazilian-Portuguese, Japanese, Korean, and Chinese (Simplified and Traditional). <b>Note:</b> Some names are available only in their local form.</td></tr><tr class="Body-Body1"><td class="BodyB-Column1-Body1">ZIP Code/Postcode</td><td class="BodyA-Column1-Body1">ZIP codes and postcodes for select countries. For example, US five-digit zip codes, Australian four-digit postcodes, German five-digit postcodes, etc. For more information, see the <a href="https://help.tableau.com/current/public/desktop/en-us/maps_data.htm#ZIP" target="_blank" class="xref">Location Data that Tableau Supports for Building Map Views</a> section.</td></tr></tbody></table>

## See also:

[Location Data that Tableau Supports for Building Map Views](https://help.tableau.com/current/public/desktop/en-us/maps_data.htm)

[Geocode Locations Tableau Does Not Recognize and Plot Them on a Map](https://help.tableau.com/current/public/desktop/en-us/custom_geocoding.htm)

[Blend Geographic Data](https://help.tableau.com/current/public/desktop/en-us/maps_customgeocode_ex_datablend.htm)

[Edit Unknown or Ambiguous Locations](https://help.tableau.com/current/public/desktop/en-us/maps_editlocation.htm)