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) | 'darkwater' | 'colorterrain' | 'satellite' | ...

Map on which to plot data, specified as one of the values listed in the table. Six of the basemaps are tiled data sets that MathWorks^® derives from public-domain data. Five of the basemaps are high-zoom-level maps hosted by Esri^®.

MATLAB^® includes one installed basemap, a two-tone map named 'darkwater'. Use of this basemap does not require Internet access. Use of the other basemaps, including the default basemap 'streets-light', does require Internet access.

If you do not have consistent access to the Internet, you can download the basemaps hosted by MathWorks 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 in MATLAB.

The five basemaps hosted by Esri include attributions that give credit to the provider of the map data. This attribution can change as you zoom in on a map because different organizations contribute map data at different zoom levels for different localities. Alignment of boundaries and region labels are a presentation of the feature provided by our data vendors and does not imply endorsement by MathWorks.

	'streets-light' Map designed to provide geographic context while highlighting user data on a light background. Hosted by Esri.		'satellite' Full global basemap composed of high-resolution satellite imagery. Hosted by Esri.
	'streets-dark' Map designed to provide geographic context while highlighting user data on a dark background. Hosted by Esri.		'topographic' General-purpose map with styling to depict topographic features. Hosted by Esri.
	'streets' General-purpose road map that emphasizes accurate, legible styling of roads and transit networks. 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. Provided by MathWorks.
	'grayterrain' Terrain map in shades of gray. Shaded relief emphasizes both high mountains and micro-terrain found in lowlands. Provided by MathWorks.		'colorterrain' Shaded relief map blended with a land cover palette. Humid lowlands are green and arid lowlands are brown. Provided by MathWorks.
	'grayland' Two-tone, land-ocean map with gray land areas and white water areas. Provided by MathWorks.		'bluegreen' Two-tone, land-ocean map with light green land areas and light blue water areas. Provided by MathWorks.
	'darkwater' Two-tone, land-ocean map with light gray land areas and dark gray water areas. This basemap is installed with MATLAB. Provided by MathWorks.		'none' Blank background that plots your data with a latitude-longitude grid, ticks, and labels.

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.