GeoImage
Details and Options
- GeoImage requires internet connectivity and may use external services requiring Service Credits.
- In GeoImage[reg,…], the region reg can be specified as a geo entity, a geo primitive, a location or list of locations, or in general as any valid input to GeoGraphics.
- GeoImage[reg,mapstyle,opts] effectively returns the background image used by GeoGraphics[reg,GeoBackgroundmapstyle,opts].
- Possible forms for mapstyle include:
-
Automatic use default "Satellite" map style "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 - Options of GeoImage include:
-
AspectRatio Automatic aspect ratio of the final projected image Background Automatic background color outside the projected map GeoCenter Automatic center coordinates to use GeoGridRange All projected coordinate range to include GeoGridRangePadding Automatic how much to pad the projected range GeoModel Automatic model of the Earth (or other body) to use GeoProjection "Mercator" projection to use GeoRange Automatic geographic area range to include GeoRangePadding Automatic how much to pad the geographic range GeoResolution Automatic average distance between pixels GeoServer Automatic specification of a tile server GeoZoomLevel Automatic zoom to use for tile download ImageSize Automatic image size of result MetaInformation {} additional fields of metainformation RasterSize Automatic raster dimensions for the underlying data - GeoImage[] gives a satellite image centered on the current geo location.
- GeoImage returns an image whose MetaInformation option setting contains copyright and other information about the source of geo imagery, as well as geo tagging information.
Examples
open all close allBasic Examples (5)
GeoImage[Entity["Country", "Iceland"]]Satellite image of Iceland using an external tile provider:
GeoImage[Entity["Country", "Iceland"], GeoServer -> "Mapbox"]Image of Iceland using the "StreetMap" map style:
GeoImage[Entity["Country", "Iceland"], "StreetMap"]Satellite image around a given location:
GeoImage[Entity["Building", "TajMahal::zw4mm"], GeoRange -> Quantity[250, "Meters"]]Satellite image of a geo region specified by two corner points, using the Mercator projection:
GeoImage[{GeoPosition[{20, -125}], GeoPosition[{40, -100}]}, GeoRangePadding -> None, GeoProjection -> "Mercator"]Options (24)
AspectRatio (1)
Construct map images of the same area with different aspect ratios:
GeoImage[Entity["City", {"NewYork", "NewYork", "UnitedStates"}], AspectRatio -> 1 / 2]ImageDimensions[%]GeoImage[Entity["City", {"NewYork", "NewYork", "UnitedStates"}], AspectRatio -> 1]ImageDimensions[%]GeoImage[Entity["City", {"NewYork", "NewYork", "UnitedStates"}], AspectRatio -> 2]ImageDimensions[%]Background (1)
GeoCenter (2)
Change the default center longitude of a world map:
GeoImage[GeoRange -> "World", GeoCenter -> 150]Extend the geo range of the US so that Dallas is at its center:
GeoImage[Entity["Country", "UnitedStates"], GeoCenter -> Entity["City", {"Dallas", "Texas", "UnitedStates"}]]GeoGridRange (2)
Specify projected coordinate ranges in the coordinate system determined by the projection:
GeoImage[GeoProjection -> "Mercator", GeoGridRange -> {{-120, -60}, {0, 60}}]A map of the Chicago area in zone 16 of the Universal Transverse Mercator coordinate system:
GeoGridPosition[Entity["City", {"Chicago", "Illinois", "UnitedStates"}], "UTMZone16"]GeoImage[GeoProjection -> "UTMZone16", GeoGridRange -> {{435000, 465000}, {4620000, 4650000}}]GeoGridRangePadding (1)
Add padding in the projected coordinate system:
GeoImage["World", GeoProjection -> "Bonne", GeoGridRangePadding -> 0.3]Add positive padding in the horizontal direction, but negative padding in the vertical direction:
GeoImage["World", GeoProjection -> "Bonne", GeoGridRangePadding -> {0.5, -0.5}]GeoModel (2)
GeoProjection (2)
An equirectangular projection of the world map:
GeoImage[GeoRange -> "World", GeoProjection -> "Equirectangular"]Use any projection for any region of the world:
GeoImage[GeoRange -> {{-50, 50}, {-150, 150}}, GeoProjection -> "LambertAzimuthal", GeoRangePadding -> None]GeoRange (2)
GeoRangePadding (2)
Extend the geo range of Spain two degrees in each direction:
GeoImage[Entity["Country", "Spain"], GeoRangePadding -> Quantity[2, "AngularDegrees"]]Extend the geo range of Spain different amounts in different directions:
GeoImage[Entity["Country", "Spain"], GeoRangePadding -> {{Quantity[-100, "Kilometers"], None}, Quantity[1, "AngularDegrees"]}]GeoResolution (1)
GeoServer (2)
Use tiles from the default geo server:
GeoImage[Entity["Country", "Australia"]]Use tiles from an external provider:
GeoImage[Entity["Country", "Australia"], GeoServer -> "ExternalProvider"]Limit the number of tiles that will be downloaded in a GeoImage call:
GeoImage[Entity["Country", "Spain"], GeoServer -> {"Wolfram", "MaxServedTileCount" -> 5}];With a larger setting, the tiles will be downloaded:
GeoImage[Entity["Country", "Spain"], GeoServer -> {"Wolfram", "MaxServedTileCount" -> 10}]GeoZoomLevel (1)
ImageSize (1)
GeoImage automatically chooses an image size around 400 pixels in width:
GeoImage[Entity["Park", "CentralParkNYC::m3c8r"], GeoZoomLevel -> 13]Specify the image size of the result:
GeoImage[Entity["Park", "CentralParkNYC::m3c8r"], GeoZoomLevel -> 13, ImageSize -> 500]MetaInformation (1)
By default, GeoImage stores Exif information in the result, as well as attribution data:
GeoImage[Entity["City", {"Brasilia", "DistritoFederal", "Brazil"}]]Options[%, MetaInformation]Store additional metainformation:
GeoImage[Entity["City", {"Brasilia", "DistritoFederal", "Brazil"}], MetaInformation -> {"Date" -> Today}]Options[%, MetaInformation]RasterSize (3)
Specify the number of pixels of the image in the horizontal direction:
GeoImage[Entity["Country", "Turkey"], RasterSize -> 300]ImageDimensions[%]Specify maximum numbers of pixels in both dimensions:
GeoImage[Entity["Country", "Turkey"], RasterSize -> {{400}, {200}}]ImageDimensions[%]RasterSize and ImageSize can be specified independently:
GeoImage[Entity["Country", "Turkey"], RasterSize -> {{400}, {200}}, ImageSize -> 600]The image dimensions are determined by RasterSize, while ImageSize gives the size on the screen:
ImageDimensions[%]Properties & Relations (1)
GeoImage effectively returns the geo background image used in GeoGraphics for a given input:
GeoImage[Polygon[Entity["Country", "Italy"]], "StreetMap"]GeoGraphics[Polygon[Entity["Country", "Italy"]], GeoBackground -> "StreetMap"]Text
Wolfram Research (2017), GeoImage, Wolfram Language function, https://reference.wolfram.com/language/ref/GeoImage.html (updated 2019).
CMS
Wolfram Language. 2017. "GeoImage." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019. https://reference.wolfram.com/language/ref/GeoImage.html.
APA
Wolfram Language. (2017). GeoImage. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/GeoImage.html