HERE Map Tile API

Example of a map with map tiles from HERE.

HERE Map Tile API used with ol/source/XYZ.

Be sure to respect the HERE Service Terms when using their tile API.

main.js

import 'ol/ol.css';
import Map from 'ol/Map';
import TileLayer from 'ol/layer/Tile';
import View from 'ol/View';
import XYZ from 'ol/source/XYZ';

var apiKey = 'Your HERE Maps API key from https://developer.here.com/';
var hereLayers = [
  {
    base: 'base',
    type: 'maptile',
    scheme: 'normal.day',
    apiKey: apiKey,
  },
  {
    base: 'base',
    type: 'maptile',
    scheme: 'normal.day.transit',
    apiKey: apiKey,
  },
  {
    base: 'base',
    type: 'maptile',
    scheme: 'pedestrian.day',
    apiKey: apiKey,
  },
  {
    base: 'aerial',
    type: 'maptile',
    scheme: 'terrain.day',
    apiKey: apiKey,
  },
  {
    base: 'aerial',
    type: 'maptile',
    scheme: 'satellite.day',
    apiKey: apiKey,
  },
  {
    base: 'aerial',
    type: 'maptile',
    scheme: 'hybrid.day',
    apiKey: apiKey,
  } ];
var urlTpl =
  'https://{1-4}.{base}.maps.ls.hereapi.com' +
  '/{type}/2.1/maptile/newest/{scheme}/{z}/{x}/{y}/256/png' +
  '?apiKey={apiKey}';
var layers = [];
var i, ii;
for (i = 0, ii = hereLayers.length; i < ii; ++i) {
  var layerDesc = hereLayers[i];
  layers.push(
    new TileLayer({
      visible: false,
      preload: Infinity,
      source: new XYZ({
        url: createUrl(urlTpl, layerDesc),
        attributions:
          'Map Tiles &copy; ' +
          new Date().getFullYear() +
          ' ' +
          '<a href="http://developer.here.com" target="_blank">HERE</a>',
      }),
    })
  );
}

var map = new Map({
  layers: layers,
  target: 'map',
  view: new View({
    center: [921371.9389, 6358337.7609],
    zoom: 10,
  }),
});

function createUrl(tpl, layerDesc) {
  return tpl
    .replace('{base}', layerDesc.base)
    .replace('{type}', layerDesc.type)
    .replace('{scheme}', layerDesc.scheme)
    .replace('{apiKey}', layerDesc.apiKey);
}

var select = document.getElementById('layer-select');
function onChange() {
  var scheme = select.value;
  for (var i = 0, ii = layers.length; i < ii; ++i) {
    layers[i].setVisible(hereLayers[i].scheme === scheme);
  }
}
select.addEventListener('change', onChange);
onChange();

index.html

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <title>HERE Map Tile API</title>
    <!-- Pointer events polyfill for old browsers, see https://caniuse.com/#feat=pointer -->
    <script src="https://unpkg.com/elm-pep"></script>
    <style>
      .map {
        width: 100%;
        height:400px;
      }
    </style>
  </head>
  <body>
    <div id="map" class="map"></div>
    <select id="layer-select">
      <option value="normal.day" selected>Normal Day</option>
      <option value="normal.day.transit">Normal Day Transit</option>
      <option value="pedestrian.day">Pedestrian Day</option>
      <option value="terrain.day">Terrain Day</option>
      <option value="satellite.day">Satellite Day</option>
      <option value="hybrid.day">Hybrid Day</option>
    </select>
    <script src="main.js"></script>
  </body>
</html>

package.json

{
  "name": "here-maps",
  "dependencies": {
    "ol": "6.5.1-dev"
  },
  "devDependencies": {
    "parcel": "^2.0.0-beta.1"
  },
  "scripts": {
    "start": "parcel index.html",
    "build": "parcel build --public-url . index.html"
  }
}