• JavaScript
  • HTML
 * Alters the UI to use imperial measurements.
 * @param  {H.Map} map      A HERE Map instance within the application
 * @param  {Object.} defaultLayers
 *         an object holding the three default HERE Map types
function useImperialMeasurements(map, defaultLayers){
  // Create the default UI components
  var ui = H.ui.UI.createDefault(map, defaultLayers);

  // Set the UI unit system to imperial measurement

 * Boilerplate map initialization code starts below:

//Step 1: initialize communication with the platform
// In your own code, replace variable window.apikey with your own apikey
var platform = new H.service.Platform({
  apikey: window.apikey
var defaultLayers = platform.createDefaultLayers();

//Step 2: initialize a map - this map is centered over Boston.
var map = new H.Map(document.getElementById('map'),
  center: {lat:42.3572, lng:-71.0596},
  zoom: 14,
  pixelRatio: window.devicePixelRatio || 1
// add a resize listener to make sure that the map occupies the whole container
window.addEventListener('resize', () => map.getViewPort().resize());

//Step 3: make the map interactive
// MapEvents enables the event system
// Behavior implements default interactions for pan/zoom (also on mobile touch environments)
var behavior = new H.mapevents.Behavior(new H.mapevents.MapEvents(map));

// Now use the map as required...
useImperialMeasurements(map, defaultLayers);
<!DOCTYPE html>
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=yes">
    <meta http-equiv="Content-type" content="text/html;charset=UTF-8">
    <title>Changing from the Metric System</title>
    <link rel="stylesheet" type="text/css" href="https://js.api.here.com/v3/3.1/mapsjs-ui.css" />
    <link rel="stylesheet" type="text/css" href="demo.css" />
    <link rel="stylesheet" type="text/css" href="styles.css" />
    <link rel="stylesheet" type="text/css" href="../template.css" />
    <script type="text/javascript" src='../test-credentials.js'></script>    
    <script type="text/javascript" src="https://js.api.here.com/v3/3.1/mapsjs-core.js"></script>
    <script type="text/javascript" src="https://js.api.here.com/v3/3.1/mapsjs-service.js"></script>
    <script type="text/javascript" src="https://js.api.here.com/v3/3.1/mapsjs-ui.js"></script>
    <script type="text/javascript" src="https://js.api.here.com/v3/3.1/mapsjs-mapevents.js"></script>
  <script type="text/javascript" src='../js-examples-rendering-helpers/iframe-height.js'></script></head>
  <body id="markers-on-the-map">
    <div class="page-header">
        <h1>Changing from the Metric System</h1>
        <p>Display a map including a scale bar in miles or yards</p>
    <p>This example displays a movable map centered over the business district of <b>Boston</b> <i>(42.3572°N, 71.0596°W)</i>. 
      The scale bar of the map is displayed in miles, yards or feet dependent upon the zoom level.</p>
    <div id="map"></div>
    The system of units displayed on the scale bar can be changed by calling the <code>setUnitSystem()</code> method, 
    and providing one of the <code>H.ui.UnitSystem</code> enum values.
    <script type="text/javascript" src='demo.js'></script>