<commit_before>getcoordinates [![Code Climate](https://codeclimate.com/github/arneheggestad/getcoordinates/badges/gpa.svg)](https://codeclimate.com/github/arneheggestad/getcoordinates) [![Test Coverage](https://codeclimate.com/github/arneheggestad/getcoordinates/badges/coverage.svg)](https://codeclimate.com/github/arneheggestad/getcoordinates) [![Build Status](https://travis-ci.org/arneheggestad/getcoordinates.svg?branch=master)](https://travis-ci.org/arneheggestad/getcoordinates)
=====


A general geocoding module for node.js.

-----

This module is intended to be a way to access as many geocoding services as possible. The module currently works with the API provided by [geocoder.us](http://geocoder.us), with plans to expand to [MapQuest's open API](http://www.mapquestapi.com/geocoding/) next. Services may be selected with the `options` object as described below.

#Use

```
var getcoordinates = require('getcoordinates');

getcoordinates.(location, options, callback);
```

#options

`options` is an object that can be used to select the geocoding service desired and provide the necessary credentials. Presently, only `options.service = 'geocoder.us'` is functional.

If an API offers more than one endpoint and you have a preference, that preference can be set in `options.<service>.type`. For example, the geocoder.us service can return data in either csv or xml format, which can be selected with `options.geocoder.type: 'csv'` or `'xml'`.

Authentication credentials will be passed in the `options.<service>.auth` namespace, as appropriate for the service. Username and password for the geocoder.us service are stored as `options.geocoder.auth.username` and `options.geocoder.auth.password` respectively.

-----
#API Keys

NB: Developers using this package will need their own API keys to use the geocoding services.

* geocoder.us: [geocoder.us/user/signup](http://geocoder.us/user/signup)
* Google Maps: ...
* Here.com: [developer.here.com](http://developer.here.com)<commit_msg>updated here.com API link<commit_after>getcoordinates [![Code Climate](https://codeclimate.com/github/arneheggestad/getcoordinates/badges/gpa.svg)](https://codeclimate.com/github/arneheggestad/getcoordinates) [![Test Coverage](https://codeclimate.com/github/arneheggestad/getcoordinates/badges/coverage.svg)](https://codeclimate.com/github/arneheggestad/getcoordinates) [![Build Status](https://travis-ci.org/arneheggestad/getcoordinates.svg?branch=master)](https://travis-ci.org/arneheggestad/getcoordinates)
=====


A general geocoding module for node.js.

-----

This module is intended to be a way to access as many geocoding services as possible. The module currently works with the API provided by [geocoder.us](http://geocoder.us), with plans to expand to [MapQuest's open API](http://www.mapquestapi.com/geocoding/) next. Services may be selected with the `options` object as described below.

#Use

```
var getcoordinates = require('getcoordinates');

getcoordinates.(location, options, callback);
```

#options

`options` is an object that can be used to select the geocoding service desired and provide the necessary credentials. Presently, only `options.service = 'geocoder.us'` is functional.

If an API offers more than one endpoint and you have a preference, that preference can be set in `options.<service>.type`. For example, the geocoder.us service can return data in either csv or xml format, which can be selected with `options.geocoder.type: 'csv'` or `'xml'`.

Authentication credentials will be passed in the `options.<service>.auth` namespace, as appropriate for the service. Username and password for the geocoder.us service are stored as `options.geocoder.auth.username` and `options.geocoder.auth.password` respectively.

-----
#API Keys

NB: Developers using this package will need their own API keys to use the geocoding services.

* geocoder.us: [geocoder.us/user/signup](http://geocoder.us/user/signup)
* Google Maps: ...
* Here.com: [developer.here.com/get-started](http://developer.here.com)
{'fraction_non_alphanumeric': 0.11903578528827037, 'fraction_numerical': 0.0, 'mean_word_length': 5.182795698924731, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 7, 'https://': 12, 'lorem ipsum': 0, 'www.': 2, 'xml': 4}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4452526', 'n_tokens_mistral': 1219, 'n_tokens_neox': 1190, 'n_words': 376}