heremap

v2.2.6

Published

2 years ago

node/browser interface to HERE Maps REST API

Downloads

183

0High
0Medium
0Low

devbab

HERE Maps node.js geocode isoline routing

HEREMAP

A framework to simplify the use of HERE Maps, which a bunch of higher level functions. In addition, it brings geocoding and routing functions to Node.js

See examples in the demo directory, starting with demo/demo-basic.html.

Get your credentials at http://developer.here.com

Installation

1/ For use in Node.js, install the package:

npm install --save-dep heremap

To use in a js file

const hm = require("heremap");

hm.config({
	app_id: YOUR APP_ID,
	app_code: YOUR APP_CODE,
});

let res = await hm.geocode("avenue des champs elysees, paris);
console.log(res.coord);

2/ For use in browser, add these lines in your html file

<link rel="stylesheet" type="text/css" href="http://www.unpkg.com/[email protected]/css/heremap.css" />

<script src="http://www.unpkg.com/[email protected]/dist/libhere.min.js" type="text/javascript" charset="utf-8"></script>
<script src="http://www.unpkg.com/[email protected]/dist/heremap.min.js" type="text/javascript" charset="utf-8"></script>

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

Then in your JS script:

const hm = window.heremap;

hm.config({
	app_id: YOUR APP_ID,
	app_code: YOUR APP_CODE,
});

hm.map("map", {
	zoom:5,
	center: [48.8,2.3],
	click: function(coord,button,key) {console.log("clicked on",coord,"with button",button);}
});

Demo

See under directory demo:

demo-basic.html: how to display a simple map in a web pgae
demo-cluster.html: how to cluster thousands of points on a map
demo-markers.html: different kind of svg or png markers, with different size, anchor..
demo-screenshot.html: how to do a screenshot of the map
demo-asia.html: how to display high quality ap in Japan and Korea. (requires special credentials)
demo-autocomplete.html: autocomplete exemple
demo-touch.html: draw a polyline on a touch screen
demo-nearcity.html: find big cities around the mouse click
demo-locateme.html: display own location

Functions

hm:PDEManager(opt)

Manage PDE requests

Kind: global function
Params

opt Object - optional object {rps,concurrent}
- [.rps] int - requests per second. Default = 10
- [.concurrent] int - max concurrent requests. Default = 5

Example

const hm = window.heremap;
const pde = new hm.PDEManager({rps:10});

const layers = {
    ROAD_GEOM_FC: {
       callback: pdeGotRoadGeomFC,
       fcLayers: [1,2]
    }, 
    POI_BIGGER: {
      callback: pdeGotPOI,
      level: 6
  };

 let bb = hm.getViewBB();
 pde.setBoundingBox(bb);
 pde.setLayers(layers);
 pde.run().then(nbtile=> {console.log(nbtiles)});

hm:PDEManager(opt)
- .getQueue() ⇒ object
- .getQueue() ⇒ object
- .getTilesInfo() ⇒ array
- .getTilesInfo() ⇒ array
- .run() ⇒ Promise
- .run() ⇒ Promise
- .setBoundingBox(bb)
- .setBoundingBox(bb)
- .setBoundingCoords(coords, add)
- .setBoundingCoords(coords, add)
- .setBoundingPolys(polygons, add)
- .setBoundingPolys(polygons, add)
- .setLayers(layers)
- .setLayers(layers)
- .setQueue(queue)
- .setQueue(queue)

hm:PDEManager.getQueue() ⇒ object

returns the current queue to be processed

Kind: static method of hm:PDEManager
Returns: object - - {key:callback,key:callback,....} where key = "x/y/z/layername"

hm:PDEManager.getQueue() ⇒ object

returns the current queue to be processed

Kind: static method of hm:PDEManager
Returns: object - - {key:callback,key:callback,....} where key = "x/y/z/layername"

hm:PDEManager.getTilesInfo() ⇒ array

provides array of rectangle showing various info for each tile downloaded

Kind: static method of hm:PDEManager
Returns: array - of {bb,tileX,tileY,level} for each tiles downloaded

hm:PDEManager.getTilesInfo() ⇒ array

provides array of rectangle showing various info for each tile downloaded

Kind: static method of hm:PDEManager
Returns: array - of {bb,tileX,tileY,level} for each tiles downloaded

hm:PDEManager.run() ⇒ Promise

run the queries in the queue, with throttle in place

Kind: static method of hm:PDEManager
Returns: Promise - - returns promise with count of tiles as parameter

hm:PDEManager.run() ⇒ Promise

run the queries in the queue, with throttle in place

Kind: static method of hm:PDEManager
Returns: Promise - - returns promise with count of tiles as parameter

hm:PDEManager.setBoundingBox(bb)

sets a bounding box to retrieve all the tiles in it

Kind: static method of hm:PDEManager
Params

bb Object - bounding box {latm,latM,lngm,lngM}

const bb={
   latm: 43.3494,
   latM: 43.8325,
   lngm: 2.2221
   lngM: 2.5685
};
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingBox(bb)

sets a bounding box to retrieve all the tiles in it

Kind: static method of hm:PDEManager
Params

bb Object - bounding box {latm,latM,lngm,lngM}

const bb={
   latm: 43.3494,
   latM: 43.8325,
   lngm: 2.2221
   lngM: 2.5685
};
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingCoords(coords, add)

retrieve all tiles needed for a list of coords

Kind: static method of hm:PDEManager
Params

coords array - array of [lat,lng]
add boolean - false by default. set to true to add to existing queue

const bb={
   latm: 43.3494,
   latM: 43.8325,
   lngm: 2.2221
   lngM: 2.5685
};
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingCoords(coords, add)

retrieve all tiles needed for a list of coords

Kind: static method of hm:PDEManager
Params

coords array - array of [lat,lng]
add boolean - false by default. set to true to add to existing queue

const bb={
   latm: 43.3494,
   latM: 43.8325,
   lngm: 2.2221
   lngM: 2.5685
};
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingPolys(polygons, add)

sets a list of polygons to contain the tiles. A Til is IN if one of the corner is in one of the polygons

Kind: static method of hm:PDEManager
Params

polygons array - array of [[lat,lng],[lat,lng]..]
add boolean - false by default. set to true to add to existing queue

const poly=[
     [[43.3,2.8],[43.35,2.34],[43.37,2.38]],
     [[48.8,0.4],[48.81,0.456],48.82,0.433],[48.83,0.45]
];
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingPolys(polygons, add)

sets a list of polygons to contain the tiles. A Til is IN if one of the corner is in one of the polygons

Kind: static method of hm:PDEManager
Params

polygons array - array of [[lat,lng],[lat,lng]..]
add boolean - false by default. set to true to add to existing queue

const poly=[
     [[43.3,2.8],[43.35,2.34],[43.37,2.38]],
     [[48.8,0.4],[48.81,0.456],48.82,0.433],[48.83,0.45]
];
pde.setBoundingBox(bb);

hm:PDEManager.setLayers(layers)

define the layers to be fetched

Kind: static method of hm:PDEManager
Params

layers object - {layerName:{level,callback,fcLayers},.....}
- [.layerName] string - name of layer
- [.callback] function - function to be called for each PDE request. parameters for call: (content,x,y,z,layerName)
- [.level] integer - level for tile associated to specific layer. if not specified, layer.fcLayers is used
- [.fcLayers] array - array of FC level, from 1 to 5

const layers = {
    ROAD_GEOM_FC: {
       callback: pdeGotRoadGeomFC,
       fcLayers: [1,2]
    }, 
    POI_BIGGER: {
      callback: pdeGotPOI,
      level: 6
  };

 pde.setLayers(layers);

hm:PDEManager.setLayers(layers)

define the layers to be fetched

Kind: static method of hm:PDEManager
Params

layers object - {layerName:{level,callback,fcLayers},.....}
- [.layerName] string - name of layer
- [.callback] function - function to be called for each PDE request. parameters for call: (content,x,y,z,layerName)
- [.level] integer - level for tile associated to specific layer. if not specified, layer.fcLayers is used
- [.fcLayers] array - array of FC level, from 1 to 5

const layers = {
    ROAD_GEOM_FC: {
       callback: pdeGotRoadGeomFC,
       fcLayers: [1,2]
    }, 
    POI_BIGGER: {
      callback: pdeGotPOI,
      level: 6
  };

 pde.setLayers(layers);

hm:PDEManager.setQueue(queue)

set the queue to run, form a list of tiles

Kind: static method of hm:PDEManager
Params

queue object - {key:callback,key:callback,....} where key = "x/y/z/layername"

hm:PDEManager.setQueue(queue)

set the queue to run, form a list of tiles

Kind: static method of hm:PDEManager
Params

queue object - {key:callback,key:callback,....} where key = "x/y/z/layername"

hm:PDEManager(opt)

Manage PDE requests

Kind: global function
Params

opt Object - optional object {rps,concurrent}
- [.rps] int - requests per second. Default = 10
- [.concurrent] int - max concurrent requests. Default = 5

Example

const hm = window.heremap;
const pde = new hm.PDEManager({rps:10});

const layers = {
    ROAD_GEOM_FC: {
       callback: pdeGotRoadGeomFC,
       fcLayers: [1,2]
    }, 
    POI_BIGGER: {
      callback: pdeGotPOI,
      level: 6
  };

 let bb = hm.getViewBB();
 pde.setBoundingBox(bb);
 pde.setLayers(layers);
 pde.run().then(nbtile=> {console.log(nbtiles)});

hm:PDEManager(opt)
- .getQueue() ⇒ object
- .getQueue() ⇒ object
- .getTilesInfo() ⇒ array
- .getTilesInfo() ⇒ array
- .run() ⇒ Promise
- .run() ⇒ Promise
- .setBoundingBox(bb)
- .setBoundingBox(bb)
- .setBoundingCoords(coords, add)
- .setBoundingCoords(coords, add)
- .setBoundingPolys(polygons, add)
- .setBoundingPolys(polygons, add)
- .setLayers(layers)
- .setLayers(layers)
- .setQueue(queue)
- .setQueue(queue)

hm:PDEManager.getQueue() ⇒ object

returns the current queue to be processed

Kind: static method of hm:PDEManager
Returns: object - - {key:callback,key:callback,....} where key = "x/y/z/layername"

hm:PDEManager.getQueue() ⇒ object

returns the current queue to be processed

Kind: static method of hm:PDEManager
Returns: object - - {key:callback,key:callback,....} where key = "x/y/z/layername"

hm:PDEManager.getTilesInfo() ⇒ array

provides array of rectangle showing various info for each tile downloaded

Kind: static method of hm:PDEManager
Returns: array - of {bb,tileX,tileY,level} for each tiles downloaded

hm:PDEManager.getTilesInfo() ⇒ array

provides array of rectangle showing various info for each tile downloaded

Kind: static method of hm:PDEManager
Returns: array - of {bb,tileX,tileY,level} for each tiles downloaded

hm:PDEManager.run() ⇒ Promise

run the queries in the queue, with throttle in place

Kind: static method of hm:PDEManager
Returns: Promise - - returns promise with count of tiles as parameter

hm:PDEManager.run() ⇒ Promise

run the queries in the queue, with throttle in place

Kind: static method of hm:PDEManager
Returns: Promise - - returns promise with count of tiles as parameter

hm:PDEManager.setBoundingBox(bb)

sets a bounding box to retrieve all the tiles in it

Kind: static method of hm:PDEManager
Params

bb Object - bounding box {latm,latM,lngm,lngM}

const bb={
   latm: 43.3494,
   latM: 43.8325,
   lngm: 2.2221
   lngM: 2.5685
};
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingBox(bb)

sets a bounding box to retrieve all the tiles in it

Kind: static method of hm:PDEManager
Params

bb Object - bounding box {latm,latM,lngm,lngM}

const bb={
   latm: 43.3494,
   latM: 43.8325,
   lngm: 2.2221
   lngM: 2.5685
};
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingCoords(coords, add)

retrieve all tiles needed for a list of coords

Kind: static method of hm:PDEManager
Params

coords array - array of [lat,lng]
add boolean - false by default. set to true to add to existing queue

const bb={
   latm: 43.3494,
   latM: 43.8325,
   lngm: 2.2221
   lngM: 2.5685
};
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingCoords(coords, add)

retrieve all tiles needed for a list of coords

Kind: static method of hm:PDEManager
Params

coords array - array of [lat,lng]
add boolean - false by default. set to true to add to existing queue

const bb={
   latm: 43.3494,
   latM: 43.8325,
   lngm: 2.2221
   lngM: 2.5685
};
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingPolys(polygons, add)

sets a list of polygons to contain the tiles. A Til is IN if one of the corner is in one of the polygons

Kind: static method of hm:PDEManager
Params

polygons array - array of [[lat,lng],[lat,lng]..]
add boolean - false by default. set to true to add to existing queue

const poly=[
     [[43.3,2.8],[43.35,2.34],[43.37,2.38]],
     [[48.8,0.4],[48.81,0.456],48.82,0.433],[48.83,0.45]
];
pde.setBoundingBox(bb);

hm:PDEManager.setBoundingPolys(polygons, add)

sets a list of polygons to contain the tiles. A Til is IN if one of the corner is in one of the polygons

Kind: static method of hm:PDEManager
Params

polygons array - array of [[lat,lng],[lat,lng]..]
add boolean - false by default. set to true to add to existing queue

const poly=[
     [[43.3,2.8],[43.35,2.34],[43.37,2.38]],
     [[48.8,0.4],[48.81,0.456],48.82,0.433],[48.83,0.45]
];
pde.setBoundingBox(bb);

hm:PDEManager.setLayers(layers)

define the layers to be fetched

Kind: static method of hm:PDEManager
Params

layers object - {layerName:{level,callback,fcLayers},.....}
- [.layerName] string - name of layer
- [.callback] function - function to be called for each PDE request. parameters for call: (content,x,y,z,layerName)
- [.level] integer - level for tile associated to specific layer. if not specified, layer.fcLayers is used
- [.fcLayers] array - array of FC level, from 1 to 5

const layers = {
    ROAD_GEOM_FC: {
       callback: pdeGotRoadGeomFC,
       fcLayers: [1,2]
    }, 
    POI_BIGGER: {
      callback: pdeGotPOI,
      level: 6
  };

 pde.setLayers(layers);

hm:PDEManager.setLayers(layers)

define the layers to be fetched

Kind: static method of hm:PDEManager
Params

layers object - {layerName:{level,callback,fcLayers},.....}
- [.layerName] string - name of layer
- [.callback] function - function to be called for each PDE request. parameters for call: (content,x,y,z,layerName)
- [.level] integer - level for tile associated to specific layer. if not specified, layer.fcLayers is used
- [.fcLayers] array - array of FC level, from 1 to 5

const layers = {
    ROAD_GEOM_FC: {
       callback: pdeGotRoadGeomFC,
       fcLayers: [1,2]
    }, 
    POI_BIGGER: {
      callback: pdeGotPOI,
      level: 6
  };

 pde.setLayers(layers);

hm:PDEManager.setQueue(queue)

set the queue to run, form a list of tiles

Kind: static method of hm:PDEManager
Params

queue object - {key:callback,key:callback,....} where key = "x/y/z/layername"

hm:PDEManager.setQueue(queue)

set the queue to run, form a list of tiles

Kind: static method of hm:PDEManager
Params

queue object - {key:callback,key:callback,....} where key = "x/y/z/layername"

hm:bb2Poly(bb) ⇒ array

convert a bounding box into a list of five [lat,lng], last is same as first

Kind: global function
Returns: array - - [[latm,lngm],[latM,lngm],[latM,lngM],[latm,lngM],[latm,lngm]]
Params

bb Object - {latm,latM,lngm,lngM}

hm:bb2Poly(bb) ⇒ array

convert a bounding box into a list of five [lat,lng], last is same as first

Kind: global function
Returns: array - - [[latm,lngm],[latM,lngm],[latM,lngM],[latm,lngM],[latm,lngm]]
Params

bb Object - {latm,latM,lngm,lngM}

hm:bubbleUnique(coord, txt)

Display a unique bubble. Associated CSS style is .H_ib_body

Kind: global function
Params

coord Array - of the bubble
txt String - html text to display

hm:bubbleUnique(coord, txt)

Display a unique bubble. Associated CSS style is .H_ib_body

Kind: global function
Params

coord Array - of the bubble
txt String - html text to display

hm:bubbleUniqueHide()

hide a unique bubble

Kind: global function

hm:bubbleUniqueHide()

hide a unique bubble

Kind: global function

hm:buildIcon(opt) ⇒ promise

create an icon, to be used for a marker

Kind: global function
Returns: promise - the promise of created icon of type H.map.Icon
Params

opt object - options to specify the icon
- [.img] string - use a png/jpg image. Specify the url
- [.svg] string - url a svg. This can be an inline svg, a url, or a svg from heremap
- [.opt] object - style object
  - [.size] number | string - size of icon, as 24 or 24x32
  - [.ratio] number - for svg files, ratio of size. 0.5 = half
  - [.anchor] number | string - anchor of icon, as 24 or "24x32" or "center". By default, bottom-center
  - [.tag] string - for svg, any tag like {tag} within the svg file will be replaced by its associated value

Example

hm.buildIcon({
   img: "http://whatever.com/image.png",
   opt: {size:24}
});

hm.buildIcon({
   svg: "http://whatever.com/image.svg",
   opt: {
      ratio:0.5,
      anchor:24x32
   }
});
 
hm.buildIcon({
   svg: "@svg/cluster.svg",
   opt: {
      size:24,
      color:"red"
   }
});

const svg = `<svg width="16" height="16" xmlns="http://www.w3.org/2000/svg"> <ellipse stroke="null" ry="8" rx="7.618896" id="svg_1" cy="8" cx="7.837427" fill="{color}" fill-opacity="0.9"/></svg>`;
hm.buildIcon({
   svg: svg,
   opt: {
      size:24,
      color:"red"
   } 
});

hm:buildIcon(opt) ⇒ promise

create an icon, to be used for a marker

Kind: global function
Returns: promise - the promise of created icon of type H.map.Icon
Params

opt object - options to specify the icon
- [.img] string - use a png/jpg image. Specify the url
- [.svg] string - url a svg. This can be an inline svg, a url, or a svg from heremap
- [.opt] object - style object
  - [.size] number | string - size of icon, as 24 or 24x32
  - [.ratio] number - for svg files, ratio of size. 0.5 = half
  - [.anchor] number | string - anchor of icon, as 24 or "24x32" or "center". By default, bottom-center
  - [.tag] string - for svg, any tag like {tag} within the svg file will be replaced by its associated value

Example

hm.buildIcon({
   img: "http://whatever.com/image.png",
   opt: {size:24}
});

hm.buildIcon({
   svg: "http://whatever.com/image.svg",
   opt: {
      ratio:0.5,
      anchor:24x32
   }
});
 
hm.buildIcon({
   svg: "@svg/cluster.svg",
   opt: {
      size:24,
      color:"red"
   }
});

const svg = `<svg width="16" height="16" xmlns="http://www.w3.org/2000/svg"> <ellipse stroke="null" ry="8" rx="7.618896" id="svg_1" cy="8" cx="7.837427" fill="{color}" fill-opacity="0.9"/></svg>`;
hm.buildIcon({
   svg: svg,
   opt: {
      size:24,
      color:"red"
   } 
});

hm:circle(opt)

draw a circle

Kind: global function
Params

opt * - option for circle
- [.layer] String - optional layer to use
- [.coord] array - center of the circle, as [48.8,2.3]
- [.radius] number - radius in meter
- [.style] object - optional graphic style
  - [.strokeColor] string - color of perimeter
  - [.lineWidth] number - line width
  - [.fillColor] string - fill color

hm:circle(opt)

draw a circle

Kind: global function
Params

opt * - option for circle
- [.layer] String - optional layer to use
- [.coord] array - center of the circle, as [48.8,2.3]
- [.radius] number - radius in meter
- [.style] object - optional graphic style
  - [.strokeColor] string - color of perimeter
  - [.lineWidth] number - line width
  - [.fillColor] string - fill color

hm:cluster(coords, opt, cb) ⇒ H.map.layer.ObjectLayer

Creates a cluster of points

Kind: global function
Returns: H.map.layer.ObjectLayer - layer created
Params

coords Array - array of [lat,lng,payload]
opt object - options for cluster
- [.minZoom] number - min zoom for cluster to be visible
- [.maxZoom] number - max zoom for cluster to be visible
- [.noise] object - graphic to represent stand-alone point. {icon,size}
  - [.icon] string - png/jpg/svg file. @ as first character indicates a file from this package. Anchor will be bottom-center
  - [.size] number - optional size of icon
- [.cluster] object - { weight:{icon,size}, weight:{icon,size},... }
  - [.icon] string - png/jpg/svg file to represent group of pois. @ as first character indicates a file from this package. Anchor will be middle of icon
  - [.size] number - size of icon
cb function - callback to be called if click on item. Format cb(event, coord, payload, weigth). coord is coord of icon payload is payload associated to point. weight is number of points aggregated, when clicking on a cluster icon, 1 if single point

Example

let pois = [[48.8,2.3,"Hello world"],[48.5,2.4,"How are you"],[45.2,2.93,"Very well"]];

hm.cluster(pois);

// with more graphic options and callback defined
  let opt = {
   noise: {
         icon: "mcdo.png",
         size: 12
     },
   cluster: {
      200: {
          icon: "@svg/cluster_red.svg",
          size: 64
      },
      75: {
          icon: "@svg/cluster_orange.svg",
          size: 52
      },
      2: {
          icon: "@svg/cluster_green.svg",
          size: 40
       }
   }
  };
 hm.cluster(pois, opt,
          (event, coordinate, data, weight) => {
              if (data)
                  console.log("click on point ", data);
              else
                  console.log("click on cluster with weight", weight);
          });

hm:clusterHide()

Hide cluster layer

Kind: global function

hm:clusterShow()

Show cluster layer

Kind: global function

hm:config(opt)

To configure app_id, app_code and optionally use CIT and http

Kind: global function
Params

opt Object - opt with parameters.
- [.app_id] string - the app_id from developer.here.com (REST)
- [.app_code] string - the app_code from developer.here.com (REST)
- [.api_key] string - the api_key from developer.here.com (JS)
- [.useCIT] boolean = false - true to use CIT environment.
- [.useHTTP] string = false - true to use HTTP.
- [.useHTTPS] string = true - true to use HTTPS.
- [.rps] object - set rps limit {routing:1,gc:2,rgc:10,pde:10}

Example

 hm.config({
     app_id: "YOUR APP_ID",
     app_code: "YOUR APP_CODE",
     api_key: "YOUR API_KEY",
  });

hm:config(opt)

To configure app_id, app_code and optionally use CIT and http

Kind: global function
Params

opt Object - opt with parameters.
- [.app_id] string - the app_id from developer.here.com (REST)
- [.app_code] string - the app_code from developer.here.com (REST)
- [.api_key] string - the api_key from developer.here.com (JS)
- [.useCIT] boolean = false - true to use CIT environment.
- [.useHTTP] string = false - true to use HTTP.
- [.useHTTPS] string = true - true to use HTTPS.
- [.rps] object - set rps limit {routing:1,gc:2,rgc:10,pde:10}

Example

 hm.config({
     app_id: "YOUR APP_ID",
     app_code: "YOUR APP_CODE",
     api_key: "YOUR API_KEY",
  });

hm:coord2Point(coord) ⇒ object

Convert [lat,lng] to {lat,lng}

Kind: global function
Returns: object - - {lat,lng}
Params

coord array - [lat,lng]

hm:coord2Point(coord) ⇒ object

Convert [lat,lng] to {lat,lng}

Kind: global function
Returns: object - - {lat,lng}
Params

coord array - [lat,lng]

hm:coordA2O(arr) ⇒ array

Convert an array [lat,lng] to {lat,lng}

Kind: global function
Returns: array - {lat,lng}
Params

arr object - [lat,lng]

hm:coordA2O(arr) ⇒ array

Convert an array [lat,lng] to {lat,lng}

Kind: global function
Returns: array - {lat,lng}
Params

arr object - [lat,lng]

hm:coordO2A(obj) ⇒ array

Convert an object {lat,lng} to [lat,lng]

Kind: global function
Returns: array - [lat,lng]
Params

obj object - {lat,lng}

hm:coordO2A(obj) ⇒ array

Convert an object {lat,lng} to [lat,lng]

Kind: global function
Returns: array - [lat,lng]
Params

obj object - {lat,lng}

hm:coords2XY(coords) ⇒ array

Convert array of [lat,lng] to array of {x,y}

Kind: global function
Returns: array - array of {x,y}
Params

coords array - array of [lat,lng]

hm:coords2XY(coords) ⇒ array

Convert array of [lat,lng] to array of {x,y}

Kind: global function
Returns: array - array of {x,y}
Params

coords array - array of [lat,lng]

hm:coords2bb(coords) ⇒ Object

compute the bounding box of an array of corrds

Kind: global function
Returns: Object - - {latm,latM,lngm,lngM}
Params

coords array - [[lat,lng],[lat,lng]]

hm:coords2bb(coords) ⇒ Object

compute the bounding box of an array of corrds

Kind: global function
Returns: Object - - {latm,latM,lngm,lngM}
Params

coords array - [[lat,lng],[lat,lng]]

hm:coordsPDE2Array(lats, lng) ⇒ array

Convert coords of format PDE: lat or lng initial/100000, delta / 100000

Kind: global function
Returns: array - [lat,lng]
Params

lats array
lng array

hm:coordsPDE2Array(lats, lng) ⇒ array

Convert coords of format PDE: lat or lng initial/100000, delta / 100000

Kind: global function
Returns: array - [lat,lng]
Params

lats array
lng array

hm:countTiles(bbox, level) ⇒ int

count the number of tiles for a given bounding box and zoom level

Kind: global function
Returns: int - count of tiles
Params

bbox array - bounding box, as {latm,latM,lngm,lngM};
level int - zoom level

hm:countTiles(bbox, level) ⇒ int

count the number of tiles for a given bounding box and zoom level

Kind: global function
Returns: int - count of tiles
Params

bbox array - bounding box, as {latm,latM,lngm,lngM};
level int - zoom level

hm:detour(start, stop, waypoints) ⇒ Promise

Compute the detour for each waypoint provided, compared to normal route from A to B

Kind: global function
Returns: Promise - returns {reference: {start, stop, distance, distance2, time, time2} ,waypoints:[ {coord, distA, timeA, distB, timeB}]}
Params

start coord - starting point for route
stop coord - destination point of route
waypoints array - list of watypoints to test

hm:detour(start, stop, waypoints) ⇒ Promise

Compute the detour for each waypoint provided, compared to normal route from A to B

Kind: global function
Returns: Promise - returns {reference: {start, stop, distance, distance2, time, time2} ,waypoints:[ {coord, distA, timeA, distB, timeB}]}
Params

start coord - starting point for route
stop coord - destination point of route
waypoints array - list of watypoints to test

hm:geocode(address, opt) ⇒ Promise

geocode an address

Kind: global function
Returns: Promise - {coord,body}. coord is geocode as [lat,lng]. body is full json answer
Params

address string - address as string
opt object - optional additional parameter, for instance {additionaldata:"IncludeShapeLevel,city"}

Example

const res = await hm.geocode("avenue des chaps elysees, paris");
console.log (res.coord);

hm:geocode(address, opt) ⇒ Promise

geocode an address

Kind: global function
Returns: Promise - {coord,body}. coord is geocode as [lat,lng]. body is full json answer
Params

address string - address as string
opt object - optional additional parameter, for instance {additionaldata:"IncludeShapeLevel,city"}

Example

const res = await hm.geocode("avenue des chaps elysees, paris");
console.log (res.coord);

hm:geocoderAutocomplete(opt) ⇒ Promise

reverse geocode a coordinate. Can centered on a location or within a bounding box

Kind: global function
Returns: Promise - returns [{},{}]
Params

opt Object - {query, bb or center}
- .search String - text to search
- .center array - [lat,lng]
- .bb object - {latm,latM,lngm,lngM}

hm:geocoderAutocomplete(opt) ⇒ Promise

reverse geocode a coordinate. Can centered on a location or within a bounding box

Kind: global function
Returns: Promise - returns [{},{}]
Params

opt Object - {query, bb or center}
- .search String - text to search
- .center array - [lat,lng]
- .bb object - {latm,latM,lngm,lngM}

hm:getAvailableMapStyle() ⇒ json

list of all available map styles normal.day, night....

Kind: global function
Returns: json - list of map styles as json

hm:getAvailableMapStyle() ⇒ json

list of all available map styles normal.day, night....

Kind: global function
Returns: json - list of map styles as json

hm:getCenter() ⇒ coord

return coordinate of the center of the map

Kind: global function
Returns: coord - coord of the center as [lat,lng]

hm:getCenter() ⇒ coord

return coordinate of the center of the map

Kind: global function
Returns: coord - coord of the center as [lat,lng]

hm:getDefaultLayers() ⇒ object

return default layers, created by _platform.createDefaultLayers();

Kind: global function
Returns: object - defaultlayer

hm:getDefaultLayers() ⇒ object

return default layers, created by _platform.createDefaultLayers();

Kind: global function
Returns: object - defaultlayer

hm:getPlatform() ⇒ object

return platorm;

Kind: global function
Returns: object - platform

hm:getPlatform() ⇒ object

return platorm;

Kind: global function
Returns: object - platform

hm:getThrottleLimits() ⇒ string

get Throttle limts for various modules

Kind: global function
Returns: string - object with various limitsl

hm:getThrottleLimits() ⇒ string

get Throttle limts for various modules

Kind: global function
Returns: string - object with various limitsl

hm:getViewBB() ⇒ Object

return bounding box of visible part of map

Kind: global function
Returns: Object - bouding box of visible part of the map, as [latm,latM,longm,lngM]

hm:getViewBB() ⇒ Object

return bounding box of visible part of map

Kind: global function
Returns: Object - bouding box of visible part of the map, as [latm,latM,longm,lngM]

hm:getZoom() ⇒ number

return zoom value

Kind: global function
Returns: number - zoom level

hm:getZoom() ⇒ number

return zoom value

Kind: global function
Returns: number - zoom level

hm:htmlBounding() ⇒ object

provide bounding box of element hosting map, relative to window

Kind: global function
Returns: object - {top,left,width, height} relative to window

hm:htmlBounding() ⇒ object

provide bounding box of element hosting map, relative to window

Kind: global function
Returns: object - {top,left,width, height} relative to window

hm:isoline(opt) ⇒ Promise

compute an isoline. See more info on optional parameters

Kind: global function
Returns: Promise - returns { poly:array, body:object }. Poly is array of coords, body is full answer
Params

opt object - option for isoline
- [.start] coord - coord for starting point of isoline
- [.destination] coord - coord for destination point of isoline
- [.rangeType] string = ""time"" - time or distance
- [.range] number - range in seconds or in meters
- [.mode] String = "fastest;car;traffic:disabled" - routing mode
- [.linkattributes] String = sh - attributes to be returned

hm:isoline(opt) ⇒ Promise

compute an isoline. See more info on optional parameters

Kind: global function
Returns: Promise - returns { poly:array, body:object }. Poly is array of coords, body is full answer
Params

opt object - option for isoline
- [.start] coord - coord for starting point of isoline
- [.destination] coord - coord for destination point of isoline
- [.rangeType] string = ""time"" - time or distance
- [.range] number - range in seconds or in meters
- [.mode] String = "fastest;car;traffic:disabled" - routing mode
- [.linkattributes] String = sh - attributes to be returned

hm:layerCreate(name, visible)

create a layer

Kind: global function
Params

name string - name of layer
visible boolean - initial status

Example

hm.layerCreate("layer1");

hm:layerCreate(name, visible)

create a layer

Kind: global function
Params

name string - name of layer
visible boolean - initial status

Example

hm.layerCreate("layer1");

hm:layerDelete(name)

delete a layer

Kind: global function
Params

name String - name of layer

hm:layerDelete(name)

delete a layer

Kind: global function
Params

name String - name of layer

hm:layerEmpty(layer)

Empty a layer, or create it if not existing

Kind: global function
Params

layer string

hm:layerEmpty(layer)

Empty a layer, or create it if not existing

Kind: global function
Params

layer string

hm:layerFind(name)

find layer by its name or return null

Kind: global function
Params

name string

hm:layerFind(name)

find layer by its name or return null

Kind: global function
Params

name string

hm:layerSetVisibility(name, visible)

create a layer

Kind: global function
Params

name string - name of layer
visible boolean - visible or not

Example

hm.layerVisible("layer1",true);

hm:layerSetVisibility(name, visible)

create a layer

Kind: global function
Params

name string - name of layer
visible boolean - visible or not

Example

hm.layerVisible("layer1",true);

hm:linkid(linkid) ⇒ Promise

get linkid Information, based on routing

Kind: global function
Returns: Promise - - promise with {summary, coords, route ,body}
Params

linkid int - linkid for which information is needed

hm:linkid(linkid) ⇒ Promise

get linkid Information, based on routing

Kind: global function
Returns: Promise - - promise with {summary, coords, route ,body}
Params

linkid int - linkid for which information is needed

hm:locateMe(callback, opt)

watch position on HTML5 position. This requires HTTPS. Creates layer "_gps". To deactivate, call with null callback

Kind: global function
Params

callback function - callback when coord changes. Format: callback(coord,accuracy)
opt Object - optional graphic options
- [.position] object - graphic options for center. See buildIcon
  - [.svg] string - svg file
  - [.color] string - color for {color} tag
  - [.size] number - size of icon
  - [.anchor] number - anchor of icon
- [.accuracy] object - graphic options for accuracy representation
  - [.strokeColor] String - color of circle line representing accuracy area
  - [.lineWidth] number - width of line of circle
  - [.fillColor] String - fill color of circle representing accuracy area

hm:locateMe(callback, opt)

watch position on HTML5 position. This requires HTTPS. Creates layer "_gps". To deactivate, call with null callback

Kind: global function
Params

callback function - callback when coord changes. Format: callback(coord,accuracy)
opt Object - optional graphic options
- [.position] object - graphic options for center. See buildIcon
  - [.svg] string - svg file
  - [.color] string - color for {color} tag
  - [.size] number - size of icon
  - [.anchor] number - anchor of icon
- [.accuracy] object - graphic options for accuracy representation
  - [.strokeColor] String - color of circle line representing accuracy area
  - [.lineWidth] number - width of line of circle
  - [.fillColor] String - fill color of circle representing accuracy area

hm:map(htmlItem, opt)

create a map area within the specified item

Kind: global function
Params

htmlItem string - identifier of html div item on which to insert map
opt object - options
- [.zoom] number = 10 - zoom factor
- [.center] Coord = [48.86, 2.3] - Coord of the center
- [.scheme] string = "normal.day.grey" - any scheme defined by HERE, plus "satellite", "japan", "korea", "black", "white", "transparent". For japan/korea, one needs special credentials as APP_ID_JAPAN APP_KOREA APP_CODE_JAPAN APP_CODE_KOREA
- [.click] function - callback on mouse click: callback(coord,button,key)
- [.dbClick] function - callback on mouse double click: callback(coord,button,key)
- [.clickLeft] function - callback on mouse click left: callback(coord,button,key)
- [.clickRight] function - callback on mouse click right.: callback(coord,button,key)
- [.keyDown] function - callback on key down : callback(key)
- [.viewChange] function - callback if map is panned or zoomed : callback(zoom,coordCenter)
- [.loadTile] function - callback when a tile is loaded : callback(z,x,y,url)
- [.rendered] function - callback when render is completed : callback(event)

Example

const hm = window.heremap;

hm.config({
   app_id: "YOUR APP_ID",
   app_code: "YOUR APP_CODE",
});

hm.map("map", {
   zoom:5,
   center: [48.8,2.3],
   click: function(coord,button,key) {console.log("clicked on",coord,"with button",button);}
});

hm:map(htmlItem, opt)

create a map area within the specified item

Kind: global function
Params

htmlItem string - identifier of html div item on which to insert map
opt <code

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

HEREMAP

Installation

Demo

Functions

hm:PDEManager(opt)

hm:PDEManager.getQueue() ⇒ object

hm:PDEManager.getQueue() ⇒ object

hm:PDEManager.getTilesInfo() ⇒ array

hm:PDEManager.getTilesInfo() ⇒ array

hm:PDEManager.run() ⇒ Promise

hm:PDEManager.run() ⇒ Promise

hm:PDEManager.setBoundingBox(bb)

hm:PDEManager.setBoundingBox(bb)

hm:PDEManager.setBoundingCoords(coords, add)

hm:PDEManager.setBoundingCoords(coords, add)

hm:PDEManager.setBoundingPolys(polygons, add)

hm:PDEManager.setBoundingPolys(polygons, add)

hm:PDEManager.setLayers(layers)

hm:PDEManager.setLayers(layers)

hm:PDEManager.setQueue(queue)

hm:PDEManager.setQueue(queue)

hm:PDEManager(opt)

hm:PDEManager.getQueue() ⇒ object

hm:PDEManager.getQueue() ⇒ object

hm:PDEManager.getTilesInfo() ⇒ array

hm:PDEManager.getTilesInfo() ⇒ array

hm:PDEManager.run() ⇒ Promise

hm:PDEManager.run() ⇒ Promise

hm:PDEManager.setBoundingBox(bb)

hm:PDEManager.setBoundingBox(bb)

hm:PDEManager.setBoundingCoords(coords, add)

hm:PDEManager.setBoundingCoords(coords, add)

hm:PDEManager.setBoundingPolys(polygons, add)

hm:PDEManager.setBoundingPolys(polygons, add)

hm:PDEManager.setLayers(layers)

hm:PDEManager.setLayers(layers)

hm:PDEManager.setQueue(queue)

hm:PDEManager.setQueue(queue)

hm:bb2Poly(bb) ⇒ array

hm:bb2Poly(bb) ⇒ array

hm:bubbleUnique(coord, txt)

hm:bubbleUnique(coord, txt)

hm:bubbleUniqueHide()

hm:bubbleUniqueHide()

hm:buildIcon(opt) ⇒ promise

hm:buildIcon(opt) ⇒ promise

hm:circle(opt)

hm:circle(opt)

hm:cluster(coords, opt, cb) ⇒ H.map.layer.ObjectLayer

hm:clusterHide()

hm:clusterShow()

hm:config(opt)

hm:config(opt)

hm:coord2Point(coord) ⇒ object

hm:coord2Point(coord) ⇒ object

hm:coordA2O(arr) ⇒ array

hm:coordA2O(arr) ⇒ array

hm:coordO2A(obj) ⇒ array

hm:coordO2A(obj) ⇒ array

hm:coords2XY(coords) ⇒ array

hm:coords2XY(coords) ⇒ array

hm:coords2bb(coords) ⇒ Object

hm:coords2bb(coords) ⇒ Object

hm:coordsPDE2Array(lats, lng) ⇒ array

hm:coordsPDE2Array(lats, lng) ⇒ array

hm:countTiles(bbox, level) ⇒ int

hm:countTiles(bbox, level) ⇒ int

hm:detour(start, stop, waypoints) ⇒ Promise

hm:detour(start, stop, waypoints) ⇒ Promise

hm:geocode(address, opt) ⇒ Promise

hm:geocode(address, opt) ⇒ Promise

hm:geocoderAutocomplete(opt) ⇒ Promise

hm:geocoderAutocomplete(opt) ⇒ Promise

hm:getAvailableMapStyle() ⇒ json