Ukeoppgave: Oppsett og bruk av WMTS-tjenester på Mapserver
(Ikke pensum i GEOM2430)

Forutsetninger - bakgrunnskunnskaper

Mapserver er installert (se ukeoppgave om dette)
Lærestoffet fra WMS-forelesning er kjent
Lærestoffet fra WMTS-forelesning er kjent

Oppgave

Ukeoppgaven består i å sette seg inn i hvordan WMTS-tjenester settes opp med Mapserver og Mapcache. Denne ukeoppgaven viser i detalj hvordan undertegnede har satt opp en WMTS-tjeneste. Din oppgave blir å gjenta dette på egen PC, og gjøre nødvendige endringer basert på forskjeller i datagrunnlag, filnavn, brukernavn, mappenavn, etc. Hvis alt går bra skal du få vist din WMTS-tjeneste på et Open Layers webkart. Oppgaven bygger i stor grad på forrige ukeoppgave (om WMS-oppsett).

Video-gjennomgang av oppsettet

NB: Videoen er basert på et oppsett der alle konfigurasjonsfiler og datafiler installeres under mappen C:\ntnugeo. Filene nedenfor er basert på installasjon under C:\ms4w\apps, f.eks C:\ms4w\apps\innlandet\innlandet.

Eksempel på Mapserver-oppsett (mapfile)

innlandet.map:

/*
 Description:  NTNU Demo WMS Server WMS service to display on MS4W localhost (http://127.0.0.1)
 Data source:  Innlandet fylke, in FGDB format.
 Author:       sverre.stikbakke@ntnu.no
 Last updated: 2025-03-18
*/

MAP

NAME "innlandet"

WEB
  METADATA
    "wms_title"                     "NTNU Demo WMS Server"
    "wms_onlineresource"            "http://127.0.0.1/cgi-bin/mapserv.exe?map=/ms4w/apps/innlandet/wms.map"
    "wms_srs"                       "EPSG:4326 EPSG:4269 EPSG:3857 EPSG:25832"
    "wms_feature_info_mime_type"    "text/plain"
    "wms_abstract"                  "Demo-WMS for NTNU, GEOM2430"
    "ows_enable_request"            "*"
  END
END

PROJECTION
  "init=epsg:25832"
END

LAYER
  NAME "kommune"
  METADATA
    "wms_title"          "Innlandet kommuner"
    "wms_include_items"  "all"
  END
  
  TYPE POLYGON
  CONNECTIONTYPE ogr
  CONNECTION "/ms4w/apps/innlandet/Basisdata_34_Innlandet_25832_Kommuner_FGDB.gdb"
  DATA "kommune"

  PROJECTION
    "init=epsg:25832"
  END

  CLASSITEM "kommunenummer"
  CLASS
      NAME "Østre Toten"
      EXPRESSION "3442"
      STYLE
        COLOR 255 110 41
        OUTLINECOLOR 12 105 128
      END
  END
  CLASS
      NAME "Hedmark"
      EXPRESSION ( ( '[kommunenummer]' LT "3431" ) AND NOT ( '[kommunenummer]' IN "3407,3405" ) )
      STYLE
        COLOR 0 168 168
        OUTLINECOLOR 12 105 128
      END
  END
  CLASS
      NAME "Resten - dvs. Oppland unntatt Østre Toten"
      STYLE
        COLOR 46 181 224
        OUTLINECOLOR 12 105 128
      END 
  END
END

END

GetCapabilities-kall mot denne tjenesten:

http://127.0.0.1/cgi-bin/mapserv.exe
?MAP=/ms4w/apps/innlandet/wms.map
&SERVICE=WMS
&VERSION=1.3.0
&REQUEST=GetCapabilities

GetMap-kall mot denne tjenesten:

http://127.0.0.1/cgi-bin/mapserv.exe
?MAP=/ms4w/apps/innlandet/wms.map
&VERSION=1.3.0
&REQUEST=GetMap
&CRS=EPSG:25832
&BBOX=592000,6741000,652000,6801000
&WIDTH=600
&HEIGHT=600
&LAYERS=kommune
&FORMAT=image/png
&STYLES=default

Kallet ovenfor gir dette bildet:

Open Layers-fil for denne WMS-tjenesten - UTM-projeksjon

<!doctype html>
<html lang="en">

<head>
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/openlayers/openlayers.github.io@master/en/v6.15.1/css/ol.css"
    type="text/css">
    <style>
    .map {
        height: 800px;
        width: 100%;
        border:1px solid DarkSlateGray;
    }
    </style>
    <script src="https://cdn.jsdelivr.net/gh/openlayers/openlayers.github.io@master/en/v6.15.1/build/ol.js"></script>
    <title>Innlandet</title>
</head>

<body>
    <h2>Innlandet</h2>
    <div id="map" class="map"></div>
    <script type="text/javascript">
    var extentKartverketWMS25832 = [234068, 6338450, 1351516, 8051673];

    var projection = new ol.proj.Projection({
        code: 'EPSG:25832',
        extent: extentKartverketWMS25832
    });

    var kommune = new ol.layer.Tile({
        extent: extentKartverketWMS25832,
        source: new ol.source.TileWMS({
        url: 'http://127.0.0.1/cgi-bin/mapserv.exe?map=/ms4w/apps/innlandet/wms.map?',
        params: {
            'LAYERS': 'kommune',
            'STYLES': 'default'
        },
        })
    });

    var map = new ol.Map({
        layers: [kommune],
        target: 'map',
        view: new ol.View({
        projection: projection,
        center: [591500, 6740500],
        zoom: 3
        })
    });
    </script>
</body>

</html>

Innlandet kommuner

(Virker bare hvis du har tjenesten installert på samme måte på egen PC)

Mapbox-fil for denne WMS-tjenesten - Web Mercator

<!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, initial-scale=1.0">

    <script src='https://api.mapbox.com/mapbox-gl-js/v3.10.0/mapbox-gl.js'></script>
    <link href='https://api.mapbox.com/mapbox-gl-js/v3.10.0/mapbox-gl.css' rel='stylesheet' />

    <style>
        #map {
            width: 1500px;
            height: 900px;
        }
    </style>

    <title>Mapserver - innlandet</title>

</head>

<body>

    <div id='map'></div>
    <script>
        mapboxgl.accessToken = 'pk.eyJ1Ijoic3ZlcnJlc3QiLCJhIjoiY2l1Y2VqcmRzMDAxMTJ0cGl6c3ZteGozMyJ9.ieY0kEubUisIWVVwjZiuBg';

        var map = new mapboxgl.Map({
            container: 'map',
            style: 'mapbox://styles/mapbox/streets-v11',
            center: [10.5, 60.7],
            zoom: 5
        });

        map.on('load', function () {

            map.addLayer({
                'id': 'innlandet',
                'type': 'raster',
                'source': {
                    'type': 'raster',
                    'tiles': [
                        'http://127.0.0.1/cgi-bin/mapserv.exe'
                        + '?MAP=/ms4w/apps/innlandet/wms.map'
                        + '&bbox={bbox-epsg-3857}'
                        + '&format=image/png'
                        + '&service=WMS'
                        + '&version=1.3.0'
                        + '&request=GetMap'
                        + '&crs=EPSG:3857'
                        + '&width=256'
                        + '&height=256'
                        + '&layers=kommune'
                        + '&styles='
                        + '&transparent=true'
                    ],
                    'tileSize': 256
                },
                'layout': {},
                'paint': { 'raster-opacity': 0.70 }
            });
        });
    </script>
</body>

</html>

Innlandet kommuner - Mapbox/Web Mercator

(Virker bare hvis du har tjenesten installert på samme måte på egen PC)

WMTS-tjenester med Mapcache (maxcache.xml)

Se forklaringer til oppsettet i mapcache.xml under Mapcache-dokumentasjonen.

Nedenfor vises en tilpasset versjon av mapcache.xml, som ligger i mappen /ms4w/apps/innlandet

I oppsettet her kan man merke seg følgende:

det er bare én cache-type: disk
kilden (source ) for kartflisene er WMS-tjenesten som er definert ovenfor.
det er definert et kartflis-skjema (grid ): UTM32EUREF89
resolutions-verdiene for dette skjemaet er beregnet ut fra verdiene under Zoom-nivå på denne siden: Bruke tjenester og API-er
I tabellen der vises Tilestørelse x/y i meter. Disse verdiene deles med 256 for å få resolutions-verdiene.
det er definert en utstrekning for dette skjemaet (extent ) som dekker Innlandet fylke
det er brukt origin: top-left som utgangspunkt for kartkoordinatene
det er definert ett tileset, ‘innlandet’, som bruker kartflis-skjemaet UTM32EUREF89.
levetiden for kartflisene er satt til 600 sekunder.

<?xml version="1.0" encoding="UTF-8"?>

<mapcache>
   <cache name="disk" type="disk">
      <base>/ms4w/apps/innlandet/cache</base>
   </cache>

   <source name="innlandet" type="wms">
      <getmap>
         <params>
            <FORMAT>image/png</FORMAT>
            <LAYERS>kommune</LAYERS>
            <TRANSPARENT>true</TRANSPARENT>
         </params>
      </getmap>

      <http>
         <url>http://127.0.0.1/cgi-bin/mapserv.exe?MAP=/ms4w/apps/innlandet/wms.map</url>
      </http>
   </source>

   <grid name="UTM32EUREF89">
      <metadata>
         <title>UTM32EUREF89</title>
      </metadata>
      <extent>413293 6637090 706922 6953227</extent>
      <origin>top-left</origin>
      <srs>EPSG:25832</srs>
      <units>m</units>
      <size>256 256</size>
      <resolutions>21664 10832 5416 2708 1354 677 338.5 169.25 84.625 42.3125 21.15625 10.578125 5.2890625 2.64453125 1.322265625 0.6611328125 0.33056640625 0.165283203125 0.0826416015625</resolutions>
   </grid>

   <tileset name="innlandet">
      <source>innlandet</source>
      <cache>disk</cache>
      <grid>UTM32EUREF89</grid>
      <format>PNG</format>
      <metatile>5 5</metatile>
      <metabuffer>10</metabuffer>
      <expires>600</expires>
   </tileset>


   <default_format>JPEG</default_format>

   <service type="wms" enabled="true">
      <full_wms>assemble</full_wms>
      <resample_mode>bilinear</resample_mode>
      <format>JPEG</format>
      <maxsize>4096</maxsize>
   </service>

   <service type="wmts" enabled="true"/>
   <service type="tms" enabled="true"/>
   <service type="kml" enabled="true"/>
   <service type="gmaps" enabled="true"/>
   <service type="ve" enabled="true"/>
   <service type="demo" enabled="true"/>

   <errors>report</errors>
   <lock_dir>/ms4w/apps/innlandet/cache</lock_dir>

</mapcache>

Alias for WMTS-tjenesten i Apache konfigurasjonsfil

For at Mapserver skal vite hvor oppsettet for WMTS-tjenesten ligger, må det legges inn et alias til aktuell mappe i
C:\ms4w\Apache\conf\httpd.conf.

Ca. ved linje 412 vil du finne dette:

<IfModule mapcache_module>
   <Directory "C:/ms4w/apps/mapcache/">
      AllowOverride None
      Options None
      Require all granted
   </Directory>
   MapCacheAlias /mapcache "C:/ms4w/apps/mapcache/mapcache.xml"
</IfModule>

Rett under disse linjene legger du inn ditt eget alias, f.eks. slik:

<IfModule mapcache_module>
   <Directory "C:/ms4w/apps/innlandet/">
      AllowOverride None
      Options None
      Require all granted
   </Directory>
   MapCacheAlias /innlandet "C:/ms4w/apps/innlandet/mapcache.xml"
</IfModule>

Bildefilene skal lagres i en egen mappe som angitt i mapcache.xml under

   <cache name="disk" type="disk">
      <base>/ms4w/apps/innlandet/cache</base>
   </cache>

Denne mappen, cache, må opprettes manuelt.

Aktivering av WMS- og WMTS-tjenester

Både WMS- og WMTS-tjenester er avhengige av Apache web-server for å kjøre.

endringer i WMS-tjenester basert på endringer i mapfile-oppsettet er umiddelbart tilgjengelige
endringer i WMTS-tjenester basert på endinger i mapcache.xml-fila krever omstart av Apache for å aktiveres

Etter omstart av Apache kan WMTS-tjenestene testes med GetCapabilities- og GetTile-kall:

http://localhost/innlandet/wmts
?SERVICE=WMTS
&VERSION=1.0.0
&REQUEST=GetCapabilities

http://localhost/innlandet/wmts
?SERVICE=WMTS
&VERSION=1.0.0
&REQUEST=GetTile
&LAYER=innlandet
&TILEMATRIXSET=UTM32EUREF89
&TILEMATRIX=5
&TILEROW=1
&TILECOL=1

GetTile-kallet ovenfor gir dette bildet:

Open Layers-fil for WMTS-tjeneste

innlandet-wmts.html:

<!DOCTYPE html>
<html>

<head>
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/openlayers/openlayers.github.io@master/en/v6.15.1/css/ol.css"
    type="text/css">
  <style>
    #map {
      height: 800px;
      width: 1200px;
      border: solid 1px darkslategray;
    }
  </style>
  <title>Innlandet WMTS</title>
</head>

<body>

  <div id="map"></div>

  <script src="https://cdn.jsdelivr.net/gh/openlayers/openlayers.github.io@master/en/v6.15.1/build/ol.js"></script>
  <script src="innlandet-wmts.js" type="text/javascript"></script>

</body>

</html>

innlandet-wmts.js:

const url = 'http://localhost/innlandet/wmts/?';

const layer = 'innlandet';

const extentKartverket = [-2000000, 3500000, 3545984, 9045984];
const extentInnlandet = [413293, 6637090, 706922, 6953227];

// Datum og projeksjon: EUREF89, UTM zone 32
const projection = new ol.proj.Projection({
    code: 'EPSG:25832',
    extent: extentKartverket
});

const resolutionsKartverket = [
    21664,
    10832,
    5416,
    2708,
    1354,
    677,
    338.5,
    169.25,
    84.625,
    42.3125,
    21.15625,
    10.578125,
    5.2890625,
    2.64453125,
    1.322265625,
    0.6611328125,
    0.33056640625,
    0.165283203125,
    0.0826416015625
  ];
  

const matrixSet = 'UTM32EUREF89';
const matrixIds = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18];

const center = [500000, 6777400]; // Easting, Northing
const zoom = 5;

const kommuner = new ol.layer.Tile({
    opacity: 0.8,
    source: new ol.source.WMTS({
        url: url,
        layer: layer,
        matrixSet: matrixSet,
        format: 'image/png',
        tileGrid: new ol.tilegrid.WMTS({
            extent: extentInnlandet,
            resolutions: resolutionsKartverket,
            matrixIds: matrixIds
        }),
        style: 'default',
    })
});

const topograatone = new ol.layer.Tile({
    extent: extentKartverket,
    source: new ol.source.TileWMS({
        url: 'https://wms.geonorge.no/skwms1/wms.topograatone',
        params: {
            'LAYERS': 'topograatone',
            'STYLES': 'default'
        },
    })
});

const map = new ol.Map({
    layers: [topograatone, kommuner],
    target: 'map',
    view: new ol.View({
        extent: extentKartverket,
        projection: projection,
        center: center,
        resolutions: resolutionsKartverket,
        zoom: zoom
    })
});

Innlandet kommuner - WMTS

(Virker bare hvis du har tjenesten installert på samme måte på egen PC)

NTNU 16.02.2021 Sverre Stikbakke
NTNU 18.03.2025 Forenklet oppsett med alle filer i /ms4w/apps/innlandet/

This site is open source. Improve this page.

Ukeoppgave: Oppsett og bruk av WMTS-tjenester på Mapserver(Ikke pensum i GEOM2430)

Forutsetninger - bakgrunnskunnskaper

Oppgave

Video-gjennomgang av oppsettet

Eksempel på Mapserver-oppsett (mapfile)

Open Layers-fil for denne WMS-tjenesten - UTM-projeksjon

Mapbox-fil for denne WMS-tjenesten - Web Mercator

WMTS-tjenester med Mapcache (maxcache.xml)

Alias for WMTS-tjenesten i Apache konfigurasjonsfil

Aktivering av WMS- og WMTS-tjenester

Open Layers-fil for WMTS-tjeneste

Ukeoppgave: Oppsett og bruk av WMTS-tjenester på Mapserver
(Ikke pensum i GEOM2430)