Module: ol/layer/Graticule

ol/layer/Graticule


Classes

Graticule

Type Definitions

GraticuleLabelDataType{Object}

Properties:
Name Type Description
geom Point

Geometry.
text string

Text.

Options{Object}

Properties:
Name Type Description
className string
(defaults to 'ol-layer')

A CSS class name to set to the layer element.
opacity number
(defaults to 1)

Opacity (0, 1).
visible boolean
(defaults to true)

Visibility.
extent Extent | undefined

The bounding extent for layer rendering. The layer will not be rendered outside of this extent.
zIndex number | undefined

The z-index for layer rendering. At rendering time, the layers will be ordered, first by Z-index and then by position. When undefined, a zIndex of 0 is assumed for layers that are added to the map's layers collection, or Infinity when the layer's setMap() method was used.
minResolution number | undefined

The minimum resolution (inclusive) at which this layer will be visible.
maxResolution number | undefined

The maximum resolution (exclusive) below which this layer will be visible.
minZoom number | undefined

The minimum view zoom level (exclusive) above which this layer will be visible.
maxZoom number | undefined

The maximum view zoom level (inclusive) at which this layer will be visible.
maxLines number
(defaults to 100)

The maximum number of meridians and parallels from the center of the map. The default value of 100 means that at most 200 meridians and 200 parallels will be displayed. The default value is appropriate for conformal projections like Spherical Mercator. If you increase the value, more lines will be drawn and the drawing performance will decrease.
strokeStyle Stroke | undefined

The stroke style to use for drawing the graticule. If not provided, the following stroke will be used:

new Stroke({
  color: 'rgba(0, 0, 0, 0.2)' // a not fully opaque black
});
targetSize number
(defaults to 100)

The target size of the graticule cells, in pixels.
showLabels boolean
(defaults to false)

Render a label with the respective latitude/longitude for each graticule line.
lonLabelFormatter function | undefined

Label formatter for longitudes. This function is called with the longitude as argument, and should return a formatted string representing the longitude. By default, labels are formatted as degrees, minutes, seconds and hemisphere.
latLabelFormatter function | undefined

Label formatter for latitudes. This function is called with the latitude as argument, and should return a formatted string representing the latitude. By default, labels are formatted as degrees, minutes, seconds and hemisphere.
lonLabelPosition number
(defaults to 0)

Longitude label position in fractions (0..1) of view extent. 0 means at the bottom of the viewport, 1 means at the top.
latLabelPosition number
(defaults to 1)

Latitude label position in fractions (0..1) of view extent. 0 means at the left of the viewport, 1 means at the right.
lonLabelStyle Text | undefined

Longitude label text style. If not provided, the following style will be used:

new Text({
  font: '12px Calibri,sans-serif',
  textBaseline: 'bottom',
  fill: new Fill({
    color: 'rgba(0,0,0,1)'
  }),
  stroke: new Stroke({
    color: 'rgba(255,255,255,1)',
    width: 3
  })
});

Note that the default's textBaseline configuration will not work well for lonLabelPosition configurations that position labels close to the top of the viewport.
latLabelStyle Text | undefined

Latitude label text style. If not provided, the following style will be used:

new Text({
  font: '12px Calibri,sans-serif',
  textAlign: 'end',
  fill: new Fill({
    color: 'rgba(0,0,0,1)'
  }),
  stroke: Stroke({
    color: 'rgba(255,255,255,1)',
    width: 3
  })
});

Note that the default's textAlign configuration will not work well for latLabelPosition configurations that position labels close to the left of the viewport.
intervals Array.<number>
(defaults to [90, 45, 30, 20, 10, 5, 2, 1, 30/60, 20/60, 10/60, 5/60, 2/60, 1/60, 30/3600, 20/3600, 10/3600, 5/3600, 2/3600, 1/3600])

Intervals (in degrees) for the graticule. Example to limit graticules to 30 and 10 degrees intervals:

[30, 10]
wrapX boolean
(defaults to true)

Whether to repeat the graticule horizontally.
properties Object.<string, *> | undefined

Arbitrary observable properties. Can be accessed with #get() and #set().