geobasemap

Set or query basemap

Syntax

geobasemap(Basemap)

geobasemap(gx,Basemap)

basemap_out = geobasemap

basemap_out = geobasemap(gx)

Description

geobasemap(Basemap) sets the basemap of the current geographic axes or chart to the value specified by Basemap. You can specify any of the values supported by the Basemap property of the geographic axes or chart.

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

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

basemap_out = geobasemap(gx) returns the value of the Basemap property of the geographic axes or chart specified by gx.

Examples

Specify Basemap of Geographic Axes or Chart

Create a geographic bubble chart.

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

Get the name of the current basemap, using the geobasemap function. By default, the geographic bubble chart uses the 'darkwater' basemap.

current_basemap = geobasemap

current_basemap =

    'darkwater'

Change the basemap used in the geographic bubble chart, using the geobasemap function to specify the name of another basemap.

geobasemap colorterrain

Input Arguments

Basemap — Map on which to plot data

'darkwater' (default) | character vector | string scalar | 'none'

Map on which to plot data, specified as one of the string scalars or character vectors in the following table, or 'none'.

MathWorks^® offers six basemaps for use with geographic axes and charts. The basemaps provide a variety of display options, from two-tone, land-ocean raster maps to color terrain maps. By default, geographic axes or charts use the 'darkwater' basemap, which is installed with the product. If you choose one of the other basemaps, the geographic axes or chart accesses the map over the Internet.

If you do not have consistent access to the Internet, you can download the basemaps hosted by MathWorks onto your local system. For more information about downloading basemaps, see Access Basemaps in MATLAB.

If you specify 'none', the geographic axes or chart plots your data with latitude-longitude grid, ticks, and labels, but does not include a map.

Basemaps

	'darkwater' (default) Land areas: light-to-moderate gray Ocean and water areas: darker gray Hosted by MathWorks.		'colorterrain' Shaded relief map blended with a land cover palette. Humid lowlands are green and arid lowlands brown. Hosted by MathWorks.
	'grayland' Land areas: light-to-moderate gray land Ocean and water areas: white Hosted by MathWorks.		'grayterrain' Worldwide terrain depicted monochromatically in shades of gray, combining shaded relief that emphasizes both high mountains and the micro terrain found in lowlands. Hosted by MathWorks.
	'bluegreen' Land areas: light green Ocean and water areas: light blue Hosted by MathWorks.		'landcover' Satellite-derived land cover data and shaded relief presented with a light, natural palette suitable for making thematic and reference maps (includes ocean-bottom relief). Hosted 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.

Output Arguments

basemap_out — Current basemap

character vector

Current basemap, returned as a character vector. basemap_out is the value of the Basemap property of the geographic axes or chart.