JavaScript Figure Reference: layout.geo
- geo
Parent:layout
Type: object containing one or more of the keys listed below.- bgcolor
Parent:layout.geo
Type: color
Default:"#fff"
Set the background color of the map
- center
Parent:layout.geo
Type: object containing one or more of the keys listed below.- lat
Parent:layout.geo.center
Type: numberSets the latitude of the map's center. For all projection types, the map's latitude center lies at the middle of the latitude range by default.
- lon
Parent:layout.geo.center
Type: numberSets the longitude of the map's center. By default, the map's longitude center lies at the middle of the longitude range for scoped projection and above `projection.rotation.lon` otherwise.
- lat
- coastlinecolor
Parent:layout.geo
Type: color
Default:"#444"
Sets the coastline color.
- coastlinewidth
Parent:layout.geo
Type: number greater than or equal to 0
Default:1
Sets the coastline stroke width (in px).
- countrycolor
Parent:layout.geo
Type: color
Default:"#444"
Sets line color of the country boundaries.
- countrywidth
Parent:layout.geo
Type: number greater than or equal to 0
Default:1
Sets line width (in px) of the country boundaries.
- domain
Parent:layout.geo
Type: object containing one or more of the keys listed below.- column
Parent:layout.geo.domain
Type: integer greater than or equal to 0
Default:0
If there is a layout grid, use the domain for this column in the grid for this geo subplot . Note that geo subplots are constrained by domain. In general, when `projection.scale` is set to 1. a map will fit either its x or y domain, but not both.
- row
Parent:layout.geo.domain
Type: integer greater than or equal to 0
Default:0
If there is a layout grid, use the domain for this row in the grid for this geo subplot . Note that geo subplots are constrained by domain. In general, when `projection.scale` is set to 1. a map will fit either its x or y domain, but not both.
- x
Parent:layout.geo.domain
Type: array
Default:[0, 1]
Sets the horizontal domain of this geo subplot (in plot fraction). Note that geo subplots are constrained by domain. In general, when `projection.scale` is set to 1. a map will fit either its x or y domain, but not both.
- y
Parent:layout.geo.domain
Type: array
Default:[0, 1]
Sets the vertical domain of this geo subplot (in plot fraction). Note that geo subplots are constrained by domain. In general, when `projection.scale` is set to 1. a map will fit either its x or y domain, but not both.
- column
- fitbounds
Parent:layout.geo
Type: enumerated , one of (false
|"locations"
|"geojson"
)Determines if this subplot's view settings are auto-computed to fit trace data. On scoped maps, setting `fitbounds` leads to `center.lon` and `center.lat` getting auto-filled. On maps with a non-clipped projection, setting `fitbounds` leads to `center.lon`, `center.lat`, and `projection.rotation.lon` getting auto-filled. On maps with a clipped projection, setting `fitbounds` leads to `center.lon`, `center.lat`, `projection.rotation.lon`, `projection.rotation.lat`, `lonaxis.range` and `lonaxis.range` getting auto-filled. If "locations", only the trace's visible locations are considered in the `fitbounds` computations. If "geojson", the entire trace input `geojson` (if provided) is considered in the `fitbounds` computations, Defaults to "false".
- framecolor
Parent:layout.geo
Type: color
Default:"#444"
Sets the color the frame.
- framewidth
Parent:layout.geo
Type: number greater than or equal to 0
Default:1
Sets the stroke width (in px) of the frame.
- lakecolor
Parent:layout.geo
Type: color
Default:"#3399FF"
Sets the color of the lakes.
- landcolor
Parent:layout.geo
Type: color
Default:"#F0DC82"
Sets the land mass color.
- lataxis
Parent:layout.geo
Type: object containing one or more of the keys listed below.- dtick
Parent:layout.geo.lataxis
Type: numberSets the graticule's longitude/latitude tick step.
- gridcolor
Parent:layout.geo.lataxis
Type: color
Default:"#eee"
Sets the graticule's stroke color.
- griddash
Parent:layout.geo.lataxis
Type: string
Default:"solid"
Sets the dash style of lines. Set to a dash type string ("solid", "dot", "dash", "longdash", "dashdot", or "longdashdot") or a dash length list in px (eg "5px,10px,2px,2px").
- gridwidth
Parent:layout.geo.lataxis
Type: number greater than or equal to 0
Default:1
Sets the graticule's stroke width (in px).
- range
Parent:layout.geo.lataxis
Type: arraySets the range of this axis (in degrees), sets the map's clipped coordinates.
- showgrid
Parent:layout.geo.lataxis
Type: booleanSets whether or not graticule are shown on the map.
- tick0
Parent:layout.geo.lataxis
Type: number
Default:0
Sets the graticule's starting tick longitude/latitude.
- dtick
- lonaxis
Parent:layout.geo
Type: object containing one or more of the keys listed below.- dtick
Parent:layout.geo.lonaxis
Type: numberSets the graticule's longitude/latitude tick step.
- gridcolor
Parent:layout.geo.lonaxis
Type: color
Default:"#eee"
Sets the graticule's stroke color.
- griddash
Parent:layout.geo.lonaxis
Type: string
Default:"solid"
Sets the dash style of lines. Set to a dash type string ("solid", "dot", "dash", "longdash", "dashdot", or "longdashdot") or a dash length list in px (eg "5px,10px,2px,2px").
- gridwidth
Parent:layout.geo.lonaxis
Type: number greater than or equal to 0
Default:1
Sets the graticule's stroke width (in px).
- range
Parent:layout.geo.lonaxis
Type: arraySets the range of this axis (in degrees), sets the map's clipped coordinates.
- showgrid
Parent:layout.geo.lonaxis
Type: booleanSets whether or not graticule are shown on the map.
- tick0
Parent:layout.geo.lonaxis
Type: number
Default:0
Sets the graticule's starting tick longitude/latitude.
- dtick
- oceancolor
Parent:layout.geo
Type: color
Default:"#3399FF"
Sets the ocean color
- projection
Parent:layout.geo
Type: object containing one or more of the keys listed below.- distance
Parent:layout.geo.projection
Type: number greater than or equal to 1.001
Default:2
For satellite projection type only. Sets the distance from the center of the sphere to the point of view as a proportion of the sphere’s radius.
- parallels
Parent:layout.geo.projection
Type: arrayFor conic projection types only. Sets the parallels (tangent, secant) where the cone intersects the sphere.
- rotation
Parent:layout.geo.projection
Type: object containing one or more of the keys listed below.- lat
Parent:layout.geo.projection.rotation
Type: numberRotates the map along meridians (in degrees North).
- lon
Parent:layout.geo.projection.rotation
Type: numberRotates the map along parallels (in degrees East). Defaults to the center of the `lonaxis.range` values.
- roll
Parent:layout.geo.projection.rotation
Type: numberRoll the map (in degrees) For example, a roll of "180" makes the map appear upside down.
- lat
- scale
Parent:layout.geo.projection
Type: number greater than or equal to 0
Default:1
Zooms in or out on the map view. A scale of "1" corresponds to the largest zoom level that fits the map's lon and lat ranges.
- tilt
Parent:layout.geo.projection
Type: number
Default:0
For satellite projection type only. Sets the tilt angle of perspective projection.
- type
Parent:layout.geo.projection
Type: enumerated , one of ("airy"
|"aitoff"
|"albers"
|"albers usa"
|"august"
|"azimuthal equal area"
|"azimuthal equidistant"
|"baker"
|"bertin1953"
|"boggs"
|"bonne"
|"bottomley"
|"bromley"
|"collignon"
|"conic conformal"
|"conic equal area"
|"conic equidistant"
|"craig"
|"craster"
|"cylindrical equal area"
|"cylindrical stereographic"
|"eckert1"
|"eckert2"
|"eckert3"
|"eckert4"
|"eckert5"
|"eckert6"
|"eisenlohr"
|"equal earth"
|"equirectangular"
|"fahey"
|"foucaut"
|"foucaut sinusoidal"
|"ginzburg4"
|"ginzburg5"
|"ginzburg6"
|"ginzburg8"
|"ginzburg9"
|"gnomonic"
|"gringorten"
|"gringorten quincuncial"
|"guyou"
|"hammer"
|"hill"
|"homolosine"
|"hufnagel"
|"hyperelliptical"
|"kavrayskiy7"
|"lagrange"
|"larrivee"
|"laskowski"
|"loximuthal"
|"mercator"
|"miller"
|"mollweide"
|"mt flat polar parabolic"
|"mt flat polar quartic"
|"mt flat polar sinusoidal"
|"natural earth"
|"natural earth1"
|"natural earth2"
|"nell hammer"
|"nicolosi"
|"orthographic"
|"patterson"
|"peirce quincuncial"
|"polyconic"
|"rectangular polyconic"
|"robinson"
|"satellite"
|"sinu mollweide"
|"sinusoidal"
|"stereographic"
|"times"
|"transverse mercator"
|"van der grinten"
|"van der grinten2"
|"van der grinten3"
|"van der grinten4"
|"wagner4"
|"wagner6"
|"wiechel"
|"winkel tripel"
|"winkel3"
)Sets the projection type.
- distance
- resolution
Parent:layout.geo
Type: enumerated , one of ("110"
|"50"
)
Default:"110"
Sets the resolution of the base layers. The values have units of km/mm e.g. 110 corresponds to a scale ratio of 1:110,000,000.
- rivercolor
Parent:layout.geo
Type: color
Default:"#3399FF"
Sets color of the rivers.
- riverwidth
Parent:layout.geo
Type: number greater than or equal to 0
Default:1
Sets the stroke width (in px) of the rivers.
- scope
Parent:layout.geo
Type: enumerated , one of ("africa"
|"asia"
|"europe"
|"north america"
|"south america"
|"usa"
|"world"
)
Default:"world"
Set the scope of the map.
- showcoastlines
Parent:layout.geo
Type: booleanSets whether or not the coastlines are drawn.
- showcountries
Parent:layout.geo
Type: booleanSets whether or not country boundaries are drawn.
- showframe
Parent:layout.geo
Type: booleanSets whether or not a frame is drawn around the map.
- showlakes
Parent:layout.geo
Type: booleanSets whether or not lakes are drawn.
- showland
Parent:layout.geo
Type: booleanSets whether or not land masses are filled in color.
- showocean
Parent:layout.geo
Type: booleanSets whether or not oceans are filled in color.
- showrivers
Parent:layout.geo
Type: booleanSets whether or not rivers are drawn.
- showsubunits
Parent:layout.geo
Type: booleanSets whether or not boundaries of subunits within countries (e.g. states, provinces) are drawn.
- subunitcolor
Parent:layout.geo
Type: color
Default:"#444"
Sets the color of the subunits boundaries.
- subunitwidth
Parent:layout.geo
Type: number greater than or equal to 0
Default:1
Sets the stroke width (in px) of the subunits boundaries.
- uirevision
Parent:layout.geo
Type: number or categorical coordinate stringControls persistence of user-driven changes in the view (projection and center). Defaults to `layout.uirevision`.
- visible
Parent:layout.geo
Type: boolean
Default:true
Sets the default visibility of the base layers.
- bgcolor