heremap-node

HEREMAP-NODE

Set of node.js interfaces to HERE Maps REST APIs

• HEREMAP-NODE
  • Installation
  • Config, Credentials
  • Geocoding
  • Parallel Geocoding
  • Reverse Geocoding
  • Routing
  • Matrix Routing
  • Useful Documentation from HERE Developer Portal

Installation

npm install heremap-node

Config, Credentials

const heremap = require("heremap-node");

// your own credentials, to be obtained from developer.here.com
// by default, use production environemnt you may specify cit:true to use CIT
heremap.config({
    app_id: "YOUR APP_ID", app_code: "YOUR APP_CODE"
});

Geocoding

const res = await heremap.geocode("avenue des champs elysees, Paris");
console.log(res);  // return {coord, body, respTime}

Parallel Geocoding

const addresses = [
    "avenue des champs-elysees, Paris",
    "Versailles, France",
    "Bordeaux,France",
];

// Array of promises from geocoder
const promises = addresses.map(addr => heremap.geocode(addr));  

// wait for all geocodes to be performed
const result = await Promise.all(promises);                     

// get array of coords
const coords = result.map(resp => resp.coord); 

Reverse Geocoding

const res = await heremap.reverseGeocode([48.3,2.3]);
console.log(res);  // return {location, address, body, respTime}

Routing

const waypoints = [
    "avenue des champs-elysees, Paris",
    "Versailles, France",
    "Bordeaux,France",
];
const promises = waypoints.map(addr => heremap.geocode(addr));  // Array of promises from geocoder
const result = await Promise.all(promises);                     // wait for all geocodes to be performed
const coords = result.map(resp => resp.coord);                  // extrct coords
const start = coords.shift();                                   // get start points and remove from list of waypoints
const resp = await heremap.route(start, coords);                // compute the route
console.log(result);                                            // return {summary, route, body, respTime

Matrix Routing

// Addresses are geocoding in parallel, and then first one is used as start point, all other as end points
const addresses = [
    "8 rue Benjamin Franklin Paris",
    "Perpignan, france",
    "Vannes, france",
    "Lyon,France",
    "Marseille,France",
    "Versailles,France"
];

const promises = addresses.map(addr => heremap.geocode(addr));  // array of promises
const result = await Promise.all(promises);                     // awaits all promises (geocodes) to be performed
const coords = result.map(resp => resp.coord);                  // get array of coords
const start = coords.shift();                                   // extract start point
const result = await heremap.matrix(start, coords);             // does matrix routing
console.log(result);                                            // return {entries, body, respTime}

Useful Documentation from HERE Developer Portal

• HERE Developer web site
• HERE Developer's User guides in PDF