dotup-node-geocoder/lib/geocoder/heregeocoder.js

Node Geocoder, node geocoding library, supports google maps, mapquest, open street map, tom tom, promise

var util = require('util'),
  AbstractGeocoder = require('./abstractgeocoder');

/**
 * Constructor
 * @param <object> httpAdapter Http Adapter
 * @param <object> options     Options (apiKey, language, politicalView, country, state, production)
 */
var HereGeocoder = function HereGeocoder(httpAdapter, options) {
  this.options = ['apiKey', 'language', 'politicalView', 'country', 'state', 'production'];

  HereGeocoder.super_.call(this, httpAdapter, options);

  if (!this.options.apiKey) {
    throw new Error('You must specify apiKey to use Here Geocoder');
  }
};

util.inherits(HereGeocoder, AbstractGeocoder);

Object.defineProperties(HereGeocoder.prototype, {
  // Here geocoding API endpoint
  "_geocodeEndpoint": {
    get: function () {
      return "https://geocoder.ls.hereapi.com/6.2/geocode.json";
    }
  },

  // Here reverse geocoding API endpoint
  "_reverseEndpoint": {
    get: function () {
      return 'https://reverse.geocoder.ls.hereapi.com/6.2/reversegeocode.json';
    }
  }
})

/**
 * Geocode
 * @param <string>   value    Value to geocode (Address)
 * @param <function> callback Callback method
 */
HereGeocoder.prototype._geocode = function (value, callback) {

  var _this = this;
  var params = this._prepareQueryString();

  if (value.address) {
    if (value.language) {
      params.language = value.language;
    }
    if (value.politicalView) {
      params.politicalview = value.politicalView;
    }
    if (value.country) {
      params.country = value.country;
      if (value.state) {
        params.state = value.state;
      } else {
        delete params.state;
      }
    }
    if (value.zipcode) {
      params.postalcode = value.zipcode;
    }
    params.searchtext = value.address;
  } else {
    params.searchtext = value;
  }

  this.httpAdapter.get(this._geocodeEndpoint, params, function (err, result) {
    var results = [];
    results.raw = result;

    if (err) {
      return callback(err, results);
    } else {
      var view = result.Response.View[0];
      if (!view) {
        return callback(false, results);
      }

      // Format each geocoding result
      results = view.Result.map(_this._formatResult);
      results.raw = result;

      callback(false, results);
    }
  });
};

HereGeocoder.prototype._prepareQueryString = function () {
  var params = {
    'additionaldata': 'Country2,true',
    'gen': 8
  };

  if (this.options.apiKey) {
    params.apiKey = this.options.apiKey;
  }
  if (this.options.language) {
    params.language = this.options.language;
  }
  if (this.options.politicalView) {
    params.politicalview = this.options.politicalView;
  }
  if (this.options.country) {
    params.country = this.options.country;
  }
  if (this.options.state) {
    params.state = this.options.state;
  }

  return params;
};

HereGeocoder.prototype._formatResult = function (result) {
  var location = result.Location || {};
  var address = location.Address || {};
  var i;

  var extractedObj = {
    formattedAddress: address.Label || null,
    latitude: location.DisplayPosition.Latitude,
    longitude: location.DisplayPosition.Longitude,
    country: null,
    countryCode: address.Country || null,
    state: address.State || null,
    county: address.County || null,
    city: address.City || null,
    zipcode: address.PostalCode || null,
    district: address.District || null,
    streetName: address.Street || null,
    streetNumber: address.HouseNumber || null,
    building: address.Building || null,
    extra: {
      herePlaceId: location.LocationId || null,
      confidence: result.Relevance || 0
    },
    administrativeLevels: {}
  };

  for (i = 0; i < address.AdditionalData.length; i++) {
    var additionalData = address.AdditionalData[i];
    switch (additionalData.key) {
      //Country 2-digit code
      case 'Country2':
        extractedObj.countryCode = additionalData.value;
        break;
      //Country name
      case 'CountryName':
        extractedObj.country = additionalData.value;
        break;
      //State name
      case 'StateName':
        extractedObj.administrativeLevels.level1long = additionalData.value;
        extractedObj.state = additionalData.value;
        break;
      //County name
      case 'CountyName':
        extractedObj.administrativeLevels.level2long = additionalData.value;
        extractedObj.county = additionalData.value;
    }
  }

  return extractedObj;
};

/**
 * Reverse geocoding
 * @param {lat:<number>,lon:<number>}  lat: Latitude, lon: Longitude
 * @param <function> callback Callback method
 */
HereGeocoder.prototype._reverse = function (query, callback) {
  var lat = query.lat;
  var lng = query.lon;

  var _this = this;
  var params = this._prepareQueryString();
  params.pos = lat + ',' + lng;
  params.mode = 'trackPosition';

  this.httpAdapter.get(this._reverseEndpoint, params, function (err, result) {
    var results = [];
    results.raw = result;

    if (err) {
      return callback(err, results);
    } else {
      var view = result.Response.View[0];
      if (!view) {
        return callback(false, results);
      }

      // Format each geocoding result
      results = view.Result.map(_this._formatResult);
      results.raw = result;

      callback(false, results);
    }
  });
};

module.exports = HereGeocoder;