Hide Table of Contents
esri
Map
toolbars
Class: OpenStreetMapLayer
[ AMD Module Require | Legacy Module Require ]

Module Require

require(["esri/layers/OpenStreetMapLayer", ... ], function(OpenStreetMapLayer, ... ){ ... });

Description

Class added 2.0
Allows you to use basemaps from OpenStreetMap . Set the tileservers property to change which OpenStreetMap tiles you want to use.

Samples

Search for samples that use this class.

Class hierarchy

esri.layers.OpenStreetMapLayer

Constructors

ConstructorDescription
new OpenStreetMapLayer(options?)Creates a new OpenStreetMapLayer object.

Properties

PropertyTypeDescription
copyrightStringThe copyright text.
Constructor Details

new OpenStreetMapLayer(options?)

Creates a new OpenStreetMapLayer object.
Parameters:
<Object> optionsOptionalOptional parameters. See options list.
Options:
<Number[]> displayLevelsAn array of levels at which to draw.
<String> idId to assign to the layer. If not assigned, esri.Map assigns value.
<Number> opacityInitial opacity or transparency of layer. Values range from 0.0 to 1.0, where 0.0 is 100% transparent and 1.0 has no transparency. The default value is 1.0.
<Boolean> resamplingWhen true, tile resampling is enabled. Default value is false.
<Number> resamplingToleranceNumber of levels beyond the last level where tiles are available. If not specified, resampling is enabled at all levels where tiles are not available.
<String[]> tileServersAn array of tile servers
<Boolean> visibleInitial visibility of the layer. Default is true.
Code Snippet:

Create a default OpenStreetMapLayer

require([
  "esri/map", "esri/layers/OpenStreetMapLayer", ... 
], function(Map, OpenStreetMapLayer, ... ) {
  var map = new Map( ... );
  var osmLayer = new OpenStreetMapLayer();
  map.addLayer(osmLayer);
  ...
});

Specify optional parameters when creating a new OpenStreetMapLayer

require([
  "esri/map", "esri/layers/OpenStreetMapLayer", ... 
], function(Map, OpenStreetMapLayer, ... ) {
  var map = new Map( ... );
  var osmLayer = new OpenStreetMapLayer({
    id: "myOSMLayer",
    visible: true,
    opacity: .75,
    displayLevels: [0,1,2]
  });
  ...
});
Property Details

<String> copyright

The copyright text. (Added at v3.1)