geobasemap

Set or query basemap

Syntax

geobasemap basemap

geobasemap(basemap)

geobasemap(gx,basemap)

bmap = geobasemap

bmap = geobasemap(gx)

Description

geobasemap basemap sets the Basemap property for the current geographic axes or chart to the value specified by basemap. When you use this syntax, you do not need to enclose the basemap argument in quotes, for example geobasemap topographic.

geobasemap(basemap) sets the basemap for the current geographic axes or chart. When you use this syntax, enclose the basemap argument in single or double quotes, for example geobasemap('topographic').

geobasemap(gx,basemap) sets the basemap for the geographic axes or chart specified by gx.

bmap = geobasemap returns the value of the Basemap property for the current geographic axes or chart.

bmap = geobasemap(gx) returns the basemap value for the geographic axes or chart specified by gx.

Examples

Specify Basemap of Geographic Axes or Chart

Create a geographic bubble chart. By default, the geographic bubble chart uses the 'streets-light' basemap.

tsunamis = readtable('tsunamis.xlsx');
geobubble(tsunamis,'Latitude','Longitude','SizeVariable','MaxHeight')

Change the basemap using the geobasemap function.

geobasemap colorterrain

Input Arguments

basemap — Map on which to plot data

'streets-light' (default) | 'streets-dark' | 'streets' | 'satellite' | 'topographic' | ...

Map on which to plot data, specified as one of the values listed in the table. Six of the basemaps are tiled data sets created using Natural Earth. Five of the basemaps are high-zoom-level maps hosted by Esri^®.

	'streets-light' (default) Map designed to provide geographic context while highlighting user data on a light background. Hosted by Esri.		'streets-dark' Map designed to provide geographic context while highlighting user data on a dark background. Hosted by Esri.
	'streets' General-purpose road map that emphasizes accurate, legible styling of roads and transit networks. Hosted by Esri.		'satellite' Full global basemap composed of high-resolution satellite imagery. Hosted by Esri.
	'topographic' General-purpose map with styling to depict topographic features. Hosted by Esri.		'landcover' Map that combines satellite-derived land cover data, shaded relief, and ocean-bottom relief. The light, natural palette is suitable for thematic and reference maps. Created using Natural Earth.
	'colorterrain' Shaded relief map blended with a land cover palette. Humid lowlands are green and arid lowlands are brown. Created using Natural Earth.		'grayterrain' Terrain map in shades of gray. Shaded relief emphasizes both high mountains and micro-terrain found in lowlands. Created using Natural Earth.
	'bluegreen' Two-tone, land-ocean map with light green land areas and light blue water areas. Created using Natural Earth.		'grayland' Two-tone, land-ocean map with gray land areas and white water areas. Created using Natural Earth.
	'darkwater' Two-tone, land-ocean map with light gray land areas and dark gray water areas. This basemap is installed with MATLAB®. Created using Natural Earth.		'none' Blank background that plots your data with a latitude-longitude grid, ticks, and labels.

All basemaps except 'darkwater' require Internet access. The 'darkwater' basemap is included with MATLAB.

If you do not have consistent access to the Internet, you can download the basemaps created using Natural Earth onto your local system by using the Add-On Explorer. The five high-zoom-level maps are not available for download. For more about downloading basemaps and changing the default basemap on your local system, see Access Basemaps for Geographic Axes and Charts.

The basemaps hosted by Esri update periodically. As a result, you might see differences in your visualizations over time.

Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks^®.

Example: gx = geoaxes('Basemap','bluegreen')

Example: gx.Basemap = 'bluegreen'

Data Types: char | string

gx — Geographic axes or chart

gca (default) | GeographicAxes object | GeographicBubbleChart object

Geographic axes or chart, specified as a GeographicAxes object or GeographicBubbleChart object.

Tips

• Specify custom basemaps using the Mapping Toolbox™ function addCustomBasemap (Mapping Toolbox).

• Add a basemap picker to the axes toolbar by using the Mapping Toolbox function addToolbarMapButton (Mapping Toolbox).