Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Set up an HTML file and include the JavaScript and CSS files

    Code Block
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=device-width, user-scalable=no initial-scale=1.0">
        <title>LiteMap - Example guide</title>
        <link rel="stylesheet" href="https://ol-ishare.services.astuntechnology.com/v1/apps/lite/lite.css">
    </head>
    <body>
        <script src="https://ol-ishare.services.astuntechnology.com/v1/apps/lite/lite.js"></script>
    </body>
    </html>
  2. Create a basic styling and a map element that will hold your map.

    Code Block
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <meta name="viewport" content="width=device-width, user-scalable=no initial-scale=1.0">
        <title>LiteMap - Example guide</title>
        <link rel="stylesheet" href="https://ol-ishare.services.astuntechnology.com/v1/apps/lite/lite.css">
        <style type="text/css">
            html,
            body {
                height: 100%;
                padding: 0;
                margin: 0;
                font-family: sans-serif;
                font-size: small;
            }
    
            #map {
                width: 100%;
                height: 100%;
            }
        </style>
    </head>
    <body>
        <div id="map"></div>
        <script src="https://ol-ishare.services.astuntechnology.com/v1/apps/lite/lite.js"></script>
    </body>
    </html>
  3. Configure and load your map with the layers you desire. Add a new script element below the script where you point to the LiteMap JS file and create a new LiteMap with the following options as indicated in the documentation 📖 :

    • target 👉 the id of an element on the page in which the map will be created (in this case the map element)

    • iShareUrl 👉 the iShare Maps server to load data from (in this case the Astun Technology demo server)

    • profile 👉 the iShare profile (also known as a MapSource). The profile determines the available layers. To find the available profiles (MapSources) of your iShare instance you can use the GetData.aspx request with the following parameters (for this case, we used the Astun Technology demo server to do the request):

      • RequestType=JSON

      • ms=root

      • Type=MapSource

    • layers 👉 the names of any layers to display. To find the available layers of the profile you like to load you can use the GetData.aspx request with the following parameters (for this case, we used the Astun Technology demo server to do the request):

      • RequestType=JSON

      • ms=mapsources/AllMaps

      • Type=MapSource

    • view  👉 the initial view of the map in the same coordinate system and units as the profile, in this case, British National Grid in meters.

      Code Block
      <!DOCTYPE html>
      <html lang="en">
      
      <head>
          <meta charset="UTF-8">
          <meta http-equiv="X-UA-Compatible" content="IE=edge">
          <meta name="viewport" content="width=device-width, user-scalable=no initial-scale=1.0">
          <title>LiteMap - Example guide</title>
          <link rel="stylesheet" href="https://ol-ishare.services.astuntechnology.com/v1/apps/lite/lite.css">
          <style type="text/css">
              html,
              body {
                  height: 100%;
                  padding: 0;
                  margin: 0;
                  font-family: sans-serif;
                  font-size: small;
              }
      
              #map {
                  width: 100%;
                  height: 100%;
              }
          </style>
      </head>
      
      <body>
          <div id="map"></div>
          <script src="https://ol-ishare.services.astuntechnology.com/v1/apps/lite/lite.js"></script>
          <script>
              //Lite map code here
              const lite = new oli.litemap.LiteMap({
                  target: 'map',
                  iShareUrl: 'https://demo.astuntechnology.com/maps/',
                  profile: 'mapsources/AllMaps',
                  layers:
                      [
                          "nhsdoctors",
                          "nhshospitals",
                          "nhspharmacies",
                          "ward",
                      ],
                  view: {
                      easting: 521000,
                      northing: 161000,
                      zoom: 10000
                  }
              });
              lite.on('load', function (evt) {
              });
          </script>
      </body>
      
      </html>
  4. The result will be this basic LiteMap 🗺

...

  1. Image Added

Additional MapOptions 📖

  1. defaultLayers 👉 You can use the defaultLayers property with 3 parameters:

    • “all” which create all layers that have been configured in iShare to be visible in the certain profile

    • “initial” which will create and enable all the layers that have been configured in iShare given the property "initaillyVisible":true

    • “none” which create no additional layers

  2. The LiteMap is configured to use the default baseMap in the specified profile. If you would like to change the baseMap you can use the baseMap property as indicated in the code below (for this case we used baseMap: "mapsources/base_ospremium_bw" )👇

...