Locations for Outline-based Maps¶

With outline-based maps, you can visualize data for specific regions using the locations and locationmode parameters.

The following map types in plotly.express and plotly.graph_objects support these parameters:

• px.choropleth - color regions based on data values
• px.scatter_geo - show markers at geographic locations
• px.line_geo - draw lines connecting geographic locations
• go.Choropleth - choropleth trace for coloring regions
• go.Scattergeo - geographic scatter/line trace for markers and lines

The locations parameter accepts region identifiers and the locationmode parameter controls how those identifiers are interpreted:

• 'ISO-3' - three-letter ISO country codes (for example, 'USA', 'CAN', 'GBR')
• 'USA-states' - two-letter US state abbreviations (for example, 'CA', 'TX', 'NY')
• 'country names' - full country names (for example, 'United States')

locationmode='ISO-3'¶

Set locationmode='ISO-3' to use three-letter ISO country codes in locations.

Supported ISO Codes¶

The following ISO codes are supported when locationmode='ISO-3':

locationmode='USA-states'¶

Set locationmode='USA-states' to use two-letter US state abbreviations in locations.

New in 6.7

You can also use full state names in locations when locationmode='USA-states':

Supported US State Codes¶

The following state names and codes are supported when locationmode='USA-states':

locationmode='country names'¶

Set locationmode='country names' to use full country names in locations.

Changed in 7.0: country names are matched by a different library, which accepts more forms and rejects some names that matched by accident before. See Changes in Version 7 for details. To get identical results across versions, use locationmode='ISO-3' with ISO codes for locations.

Using Different Data Types with locations¶

Earlier examples demonstrated using the locations parameter with Python lists. The locations parameter also accepts column names from DataFrames, pandas Series, or other array-like objects.

Here's an example that uses a column from the gapminder dataset with locations:

What About Dash?¶

Dash is an open-source framework for building analytical applications, with no Javascript required, and it is tightly integrated with the Plotly graphing library.

Learn about how to install Dash at https://dash.plot.ly/installation.

Everywhere in this page that you see fig.show(), you can display the same figure in a Dash application by passing it to the figure argument of the Graph component from the built-in dash_core_components package like this:

import plotly.graph_objects as go # or plotly.express as px
fig = go.Figure() # or any Plotly Express function e.g. px.bar(...)
# fig.add_trace( ... )
# fig.update_layout( ... )

from dash import Dash, dcc, html

app = Dash()
app.layout = html.Div([
    dcc.Graph(figure=fig)
])

app.run(debug=True, use_reloader=False)  # Turn off reloader if inside Jupyter