Creating a Map

In OpenLayers, a map is a collection of layers and various interactions and controls for dealing with user interaction. A map is generated with three basic ingredients: markup, style declarations, and initialization code.

Working Example

Let's take a look at a fully working example of an OpenLayers map.

<!doctype html>
<html lang="en">
    <link rel="stylesheet" href="/ol.css" type="text/css">
      #map {
        height: 256px;
        width: 512px;
    <title>OpenLayers example</title>
    <script src="/loader.js" type="text/javascript"></script>
    <h1>My Map</h1>
    <div id="map"></div>
    <script type="text/javascript">
      var map = new ol.Map({
        target: 'map',
        layers: [
          new ol.layer.Tile({
            title: 'Global Imagery',
            source: new ol.source.TileWMS({
              url: '',
              params: {LAYERS: 'nasa:bluemarble', TILED: true}
        view: new ol.View({
          projection: 'EPSG:4326',
          center: [0, 0],
          zoom: 0,
          maxResolution: 0.703125


  1. Make sure you've completed the setup instructions to install dependencies and get the debug server running.

  2. Copy the text above into a new file called map.html, and save it in the root of the workshop directory.

  3. Open the working map in your web browser: http://localhost:4000/map.html

A working map displaying imagery of the world
A working map displaying imagery of the world

Having successfully created our first map, we'll continue by looking more closely at the parts.