• JavaScript
  • HTML
 *  Renders specified a KML file on the map
 *  Note that the maps data module https://js.api.here.com/v3/3.1/mapsjs-data.js
 *  must be loaded for KML parsing to occcur
 * @param {H.Map} map A HERE Map instance within the application
function renderKML(map) {
  // Create a reader object passing in the URL of our KML file
  reader = new H.data.kml.Reader('https://heremaps.github.io/maps-api-for-javascript-examples/display-kml-on-map/data/us-states.kml');
  reader.addEventListener("statechange", function(evt){
    if (evt.state === H.data.AbstractReader.State.READY) {
      // Get KML layer from the reader object and add it to the map
      reader.getLayer().getProvider().addEventListener("tap", (evt) => {
    if (evt.state === H.data.AbstractReader.State.ERROR) {
      logEvent('KML parsing error')

  // Parse the document

 * 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
var map = new H.Map(document.getElementById('map'), defaultLayers.vector.normal.map, {
  zoom: 2.5,
  center: {lat: 48.30432303555956, lng: -104.94466241321628},
  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));

// Step 4: create the default UI component, for displaying bubbles
var ui = H.ui.UI.createDefault(map, defaultLayers);

// Step 5: create custom logging facilities
var logContainer = document.createElement('ul');
logContainer.className ='log';
logContainer.innerHTML = '
  • Try clicking on the map
  • '; map.getElement().appendChild(logContainer); // Helper for logging events function logEvent(str) { var entry = document.createElement('li'); entry.className = 'log-entry'; entry.textContent = str; logContainer.insertBefore(entry, logContainer.firstChild); } // Step 6: main logic goes here renderKML(map);
    <!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">
        <meta name="description" content="Parse a KML file and display the data on a map">
        <title>Display KML Data</title>
        <link rel="stylesheet" type="text/css" href="https://js.api.here.com/v3/3.1/mapsjs-ui.css" />
        <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="https://js.api.here.com/v3/3.1/mapsjs-data.js"></script>
        <link rel="stylesheet" type="text/css" href="../template.css" />
        <link rel="stylesheet" type="text/css" href="demo.css" />
        <script type="text/javascript" src='../test-credentials.js'></script>     
        <style type="text/css">
          .log {
            position: absolute;
            top: 5px;
            left: 5px;
            height: 150px;
            width: 250px;
            overflow: scroll;
            background: white;
            margin: 0;
            padding: 0;
            list-style: none;
            font-size: 12px;
          .log-entry {
            padding: 5px;
            border-bottom: 1px solid #d0d9e9;
          .log-entry:nth-child(odd) {
              background-color: #e1e7f1;
      <script type="text/javascript" src='../js-examples-rendering-helpers/iframe-height.js'></script></head>
        <h1>Display KML Data</h1>
        <p>This example shows a map of the <b>United States</b> from the <a href="https://www.census.gov">U.S. Census Bureau</a>, highlighting the borders of each state. 
          The data to display on the map has been read in from a KML file and loaded using the built-in KML parser.</p>
        <p>The name of the state is logged when the user taps on the state's shape</p>
        <div id="map"></div>
        <script type="text/javascript" src='demo.js'></script>