is an option that specifies the background style of a GeoGraphics object.


  • The geo background of a GeoGraphics[prims,] output is the actual map that appears underneath the primitives prims. A map like GeoGraphics[{},] with no primitives will only show the geo background, and possibly auxiliary elements like geo grid lines or a scale bar.
  • GeoBackground values can be given as GeoBackgroundGeoStyling[mapstyle] for any valid GeoStyling map style. For named map styles, such as "StreetMap" or "Satellite", GeoBackgroundGeoStyling["mapstyle"] may also be specified as GeoBackground"mapstyle".
  • GeoBackground map styles may be given by raster data (images) or by vector data (graphics primitives).
  • Possible raster map styles include:
  • "ContourMap"elevation data as contours
    "ReliefMap"elevation data as color with shadows
    "Satellite"satellite imagery
    "SatelliteWithLabels"satellite imagery with labels
    "StreetMap"street map data
    "StreetMapLabelsOnly"street map labels only
    "StreetMapNoLabels"street map data omitting labels
  • Possible vector outline map styles include:
  • "Coastlines"display coastlines
    "CountryBorders"display country borders
    Dated["CountryBorders",year]display historical country borders for the given year
  • Experimental vector map styles include:
  • "VectorBusiness"bright, modern look for business presentations
    "VectorClassic""StreetMap"-like style
    "VectorDark"dark monochrome
    "VectorMarketing"elegant design for marketing needs
    "VectorMinimal"simplified map representation
    "VectorMonochrome"single-color design for printing and accessibility
    "VectorVintage"historical design
    "VectorWeb"clean, bold design for a website or blog
    "VectorLabels"labels, as a collection of vector primitives
  • Maps with vector backgrounds use the "Mercator" projection by default.
  • GeoBackground{style1,style2,} uses the list of map styles sequentially overlaid.
  • GeoBackground"StreetMapVectorLabels" is equivalent to GeoBackground{"StreetMapNoLabels","VectorLabels"}.
  • GeoBackgroundAutomatic uses the "StreetMapVectorLabels" map style by default.
  • GeoBackgroundNone specifies that no geo background should be used, meaning no background regions are displayed.
  • GeoBackgroundGeoStyling[image] places image as the geo background, stretching it to cover the map.
  • GeoBackgroundGeoStyling[{"Image",image,"Projection"proj,"Bounds"bounds}] specifies that the image is given in projection proj and covers the given bounds in projected space.
  • GeoBackground takes precedence over Background in geo graphics.


open allclose all

Basic Examples  (3)

Display with the default GeoBackground:

Use satellite imagery as geo background:

Use a vector map style as geo background:

Scope  (12)

Display with the default GeoBackground:

Explicitly specify an automatic GeoBackground:

Use satellite imagery as background:

Use satellite imagery from an external tile provider:

Show no geo background:

Use vector map styles as geo background:

Show country borders in the geo background:

Show country borders in the year 1800 for the region corresponding to modern Italy:

Overlay several geo background map styles:

Specify parameters for one of the styles:

Control the geo zoom level independently for several geo background styles:

Use GeoBackground to display a relief for all regions that lie within the bounding box of the given primitive:

Take an image:

Display that image as geo background, partially visible behind the map:

Specify a region of the map for the geo background image using projected coordinates:

GeoBackgroundGeoStyling[{"GeoImage",image}] specifies that the image was given in latitude-longitude space, and therefore will be transformed to the map projection:

GeoBackground applies to the geographic map, and Background to the whole graphic:

Possible Issues  (3)

Specifying None as a geo background is not the same as specifying GeoStyling[None]:

Specifying Automatic as a geo background is not the same as specifying GeoStyling[Automatic]:

Specifying "OutlineMap" as geo background sets the style of the whole geo background polygon:

Use "Coastlines" or "CountryBorders" to include an actual map in the geo background:

Interactive Examples  (1)

Interactively explore map foreground and background styles:

Neat Examples  (1)

Add a tapered "swoosh" map effect around Paris:

Show the "swooshed" map:

Wolfram Research (2014), GeoBackground, Wolfram Language function, (updated 2021).


Wolfram Research (2014), GeoBackground, Wolfram Language function, (updated 2021).


Wolfram Language. 2014. "GeoBackground." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2021.


Wolfram Language. (2014). GeoBackground. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2024_geobackground, author="Wolfram Research", title="{GeoBackground}", year="2021", howpublished="\url{}", note=[Accessed: 17-July-2024 ]}


@online{reference.wolfram_2024_geobackground, organization={Wolfram Research}, title={GeoBackground}, year={2021}, url={}, note=[Accessed: 17-July-2024 ]}