Updated bower dependencies for client.
This commit is contained in:
baldo
parent
1b47de7c5f
commit
fe5b68e1c4
136 changed files with 7596 additions and 9284 deletions
308
app/bower_components/geolib/README.md
vendored
308
app/bower_components/geolib/README.md
vendored
|
|
@ -1,133 +1,79 @@
|
|||
# Geolib v2.0.21
|
||||
# Geolib
|
||||
[](http://travis-ci.org/manuelbieh/Geolib)
|
||||
|
||||
Library to provide basic geospatial operations like distance calculation, conversion of decimal coordinates to sexagesimal and vice versa, etc.
|
||||
A small library to provide some basic geo functions like distance calculation, conversion of decimal coordinates to sexagesimal and vice versa, etc.
|
||||
|
||||
[View demo](http://www.manuel-bieh.de/publikationen/scripts/geolib/demo.html)
|
||||
|
||||
<h2>Methods</h2>
|
||||
|
||||
<h3>geolib.getDistance(object start, object end[, int accuracy, int precision])</h3>
|
||||
<h3>geolib.getDistance(object start, object end[, int accuracy])</h3>
|
||||
|
||||
Calculates the distance between two geo coordinates
|
||||
|
||||
Takes 2 or 4 arguments. First 2 arguments must be objects that each have latitude and longitude properties (e.g. `{latitude: 52.518611, longitude: 13.408056}`)Works with:. Coordinates can be in sexagesimal or decimal format. 3rd argument is accuracy (in meters). So a calculated distaWorks with:nce of 1248 meters with an accuracy of 100 is returned as `1200` (accuracy 10 = `1250` etc.). 4th argument is precision in sub-meters (1 is meter presicion, 2 is decimeters, 3 is centimeters, etc).
|
||||
Takes 2 or 3. First 2 arguments must be an object with a latitude and a longitude property (e.g. {latitude: 52.518611, longitude: 13.408056}). Coordinates can be in sexagesimal or decimal format. 3rd argument is accuracy (in meters). So a calculated distance of 1248 meters with an accuracy of 100 is returned as 1200.
|
||||
|
||||
Return value is always float and represents the distance in meters.
|
||||
Return value is always an integer and represents the distance in meters.
|
||||
|
||||
<h4>Examples</h4>
|
||||
|
||||
<pre>geolib.getDistance(
|
||||
{latitude: 51.5103, longitude: 7.49347},
|
||||
{latitude: "51° 31' N", longitude: "7° 28' E"}
|
||||
{latitude: 51.5103, longitude: 7.49347},
|
||||
{latitude: "51° 31' N", longitude: "7° 28' E"}
|
||||
);
|
||||
geolib.getDistance(
|
||||
{latitude: 51.5103, longitude: 7.49347},
|
||||
{latitude: "51° 31' N", longitude: "7° 28' E"}
|
||||
{latitude: 51.5103, longitude: 7.49347},
|
||||
{latitude: "51° 31' N", longitude: "7° 28' E"}
|
||||
);
|
||||
|
||||
// Working with W3C Geolocation API
|
||||
navigator.geolocation.getCurrentPosition(
|
||||
function(position) {
|
||||
alert('You are ' + geolib.getDistance(position.coords, {
|
||||
latitude: 51.525,
|
||||
longitude: 7.4575
|
||||
}) + ' meters away from 51.525, 7.4575');
|
||||
},
|
||||
function() {
|
||||
alert('Position could not be determined.')
|
||||
},
|
||||
{
|
||||
enableHighAccuracy: true
|
||||
}
|
||||
function(position) {
|
||||
alert('You are ' + geolib.getDistance(position.coords, {
|
||||
latitude: 51.525,
|
||||
longitude: 7.4575
|
||||
}) + ' meters away from 51.525, 7.4575');
|
||||
},
|
||||
function() {
|
||||
alert('Position could not be determined.')
|
||||
},
|
||||
{
|
||||
enableHighAccuracy: true
|
||||
}
|
||||
);
|
||||
</pre>
|
||||
|
||||
<h3>geolib.getDistanceSimple(object start, object end[, int accuracy])</h3>
|
||||
|
||||
Calculates the distance between two geo coordinates but this method is far more inaccurate as compared to getDistance.
|
||||
|
||||
It can take up 2 to 3 arguments. start, end and accuracy can be defined in the same as in getDistance.
|
||||
|
||||
Return value is always float that represents the distance in meters.
|
||||
|
||||
<h4>Examples</h4>
|
||||
|
||||
<pre>geolib.getDistanceSimple(
|
||||
{latitude: 51.5103, longitude: 7.49347},
|
||||
{latitude: "51° 31' N", longitude: "7° 28' E"}
|
||||
);</pre>
|
||||
|
||||
<h3>geolib.getCenter(array coords)</h3>
|
||||
|
||||
Calculates the geographical center of all points in a collection of geo coordinates
|
||||
|
||||
Takes an object or array of coordinates and calculates the center of it.
|
||||
|
||||
Returns an object: `{"latitude": centerLat, "longitude": centerLng}`
|
||||
Returns an object: `{"latitude": centerLat, "longitude": centerLng, "distance": diagonalDistance}`
|
||||
|
||||
<h4>Examples</h4>
|
||||
|
||||
<pre>var spots = {
|
||||
"Brandenburg Gate, Berlin": {latitude: 52.516272, longitude: 13.377722},
|
||||
"Dortmund U-Tower": {latitude: 51.515, longitude: 7.453619},
|
||||
"London Eye": {latitude: 51.503333, longitude: -0.119722},
|
||||
"Kremlin, Moscow": {latitude: 55.751667, longitude: 37.617778},
|
||||
"Eiffel Tower, Paris": {latitude: 48.8583, longitude: 2.2945},
|
||||
"Riksdag building, Stockholm": {latitude: 59.3275, longitude: 18.0675},
|
||||
"Royal Palace, Oslo": {latitude: 59.916911, longitude: 10.727567}
|
||||
"Brandenburg Gate, Berlin": {latitude: 52.516272, longitude: 13.377722},
|
||||
"Dortmund U-Tower": {latitude: 51.515, longitude: 7.453619},
|
||||
"London Eye": {latitude: 51.503333, longitude: -0.119722},
|
||||
"Kremlin, Moscow": {latitude: 55.751667, longitude: 37.617778},
|
||||
"Eiffel Tower, Paris": {latitude: 48.8583, longitude: 2.2945},
|
||||
"Riksdag building, Stockholm": {latitude: 59.3275, longitude: 18.0675},
|
||||
"Royal Palace, Oslo": {latitude: 59.916911, longitude: 10.727567}
|
||||
}
|
||||
|
||||
geolib.getCenter(spots);
|
||||
|
||||
geolib.getCenter([
|
||||
{latitude: 52.516272, longitude: 13.377722},
|
||||
{latitude: 51.515, longitude: 7.453619},
|
||||
{latitude: 51.503333, longitude: -0.119722}
|
||||
{latitude: 52.516272, longitude: 13.377722},
|
||||
{latitude: 51.515, longitude: 7.453619},
|
||||
{latitude: 51.503333, longitude: -0.119722}
|
||||
]);
|
||||
</pre>
|
||||
|
||||
<h3>geolib.getCenterOfBounds(array coords)</h3>
|
||||
<h3>geolib.isPointInside(object latlng, array coords)</h3>
|
||||
|
||||
Calculates the center of the bounds of geo coordinates.
|
||||
|
||||
Takes an array of coordinates, calculate the border of those, and gives back
|
||||
the center of that rectangle.
|
||||
|
||||
On polygons like political borders (eg. states), this may gives a closer
|
||||
result to human expectation, than `getCenter`, because that function can be
|
||||
disturbed by uneven distribution of point in different sides.
|
||||
|
||||
Imagine the US state Oklahoma: `getCenter` on that gives a southern
|
||||
point, because the southern border contains a lot more nodes, than the others.
|
||||
|
||||
Returns an object: `{"latitude": centerLat, "longitude": centerLng}`
|
||||
|
||||
<h3>geolib.getBounds(array coords)</h3>
|
||||
|
||||
Calculates the bounds of geo coordinates.
|
||||
|
||||
It returns maximum and minimum, latitude, longitude, and elevation (if provided) in form of an object of form:
|
||||
<pre>{
|
||||
"minLat": minimumLatitude,
|
||||
"maxLat": maximumLatitude,
|
||||
"minLng": minimumLongitude,
|
||||
"maxLng": maximumLongitude,
|
||||
"minElev": minimumElevation,
|
||||
"maxElev": maximumElevation
|
||||
}</pre>
|
||||
|
||||
<h4>Example</h4>
|
||||
|
||||
<pre>geolib.getCenter([
|
||||
{latitude: 52.516272, longitude: 13.377722},
|
||||
{latitude: 51.515, longitude: 7.453619},
|
||||
{latitude: 51.503333, longitude: -0.119722}
|
||||
]);</pre>
|
||||
|
||||
<h3>geolib.isPointInside(object latlng, array polygon)</h3>
|
||||
|
||||
Checks whether a point is inside of a polygon or not.
|
||||
Checks whether a point is inside of a polygon or not.
|
||||
Note: the polygon coords must be in correct order!
|
||||
|
||||
Returns true or false
|
||||
|
|
@ -136,18 +82,18 @@ Returns true or false
|
|||
|
||||
<pre>
|
||||
geolib.isPointInside(
|
||||
{latitude: 51.5125, longitude: 7.485},
|
||||
[
|
||||
{latitude: 51.50, longitude: 7.40},
|
||||
{latitude: 51.555, longitude: 7.40},
|
||||
{latitude: 51.555, longitude: 7.625},
|
||||
{latitude: 51.5125, longitude: 7.625}
|
||||
]
|
||||
{latitude: 51.5125, longitude: 7.485},
|
||||
[
|
||||
{latitude: 51.50, longitude: 7.40},
|
||||
{latitude: 51.555, longitude: 7.40},
|
||||
{latitude: 51.555, longitude: 7.625},
|
||||
{latitude: 51.5125, longitude: 7.625}
|
||||
]
|
||||
); // -> true</pre>
|
||||
|
||||
<h3>geolib.isPointInCircle(object latlng, object center, integer radius)</h3>
|
||||
|
||||
Similar to is point inside: checks whether a point is inside of a circle or not.
|
||||
Similar to is point inside: checks whether a point is inside of a circle or not.
|
||||
|
||||
Returns true or false
|
||||
|
||||
|
|
@ -155,60 +101,11 @@ Returns true or false
|
|||
|
||||
<pre>// checks if 51.525, 7.4575 is within a radius of 5km from 51.5175, 7.4678
|
||||
geolib.isPointInCircle(
|
||||
{latitude: 51.525, longitude: 7.4575},
|
||||
{latitude: 51.5175, longitude: 7.4678},
|
||||
5000
|
||||
{latitude: 51.525, longitude: 7.4575},
|
||||
{latitude: 51.5175, longitude: 7.4678},
|
||||
5000
|
||||
);</pre>
|
||||
|
||||
<h3>geolib.getRhumbLineBearing(object originLL, object destLL)</h3>
|
||||
|
||||
Gets rhumb line bearing of two points. Find out about the difference between rhumb line and
|
||||
great circle bearing on Wikipedia. Rhumb line should be fine in most cases:
|
||||
|
||||
http://en.wikipedia.org/wiki/Rhumb_line#General_and_mathematical_description
|
||||
|
||||
Function is heavily based on Doug Vanderweide's great PHP version (licensed under GPL 3.0)
|
||||
http://www.dougv.com/2009/07/13/calculating-the-bearing-and-compass-rose-direction-between-two-latitude-longitude-coordinates-in-php/
|
||||
|
||||
Returns calculated bearing as integer.
|
||||
|
||||
<h4>Example</h4>
|
||||
|
||||
<pre>geolib.getRhumbLineBearing(
|
||||
{latitude: 52.518611, longitude: 13.408056},
|
||||
{latitude: 51.519475, longitude: 7.46694444}
|
||||
);</pre>
|
||||
|
||||
<h3>geolib.getBearing(object originLL, object destLL)</h3>
|
||||
|
||||
Gets great circle bearing of two points. See description of getRhumbLineBearing for more information.
|
||||
Returns calculated bearing as integer.
|
||||
|
||||
<h4>Example</h4>
|
||||
|
||||
<pre>geolib.getBearing(
|
||||
{latitude: 52.518611, longitude: 13.408056},
|
||||
{latitude: 51.519475, longitude: 7.46694444}
|
||||
);</pre>
|
||||
|
||||
<h3>geolib.getCompassDirection(object originLL, object destLL, string bearingMode (optional))</h3>
|
||||
|
||||
Gets the compass direction from an origin coordinate (originLL) to a destination coordinate (destLL).
|
||||
Bearing mode. Can be either circle or rhumbline (default).
|
||||
Returns an object with a rough (NESW) and an exact direction (NNE, NE, ENE, E, ESE, etc).
|
||||
|
||||
<h4>Example</h4>
|
||||
|
||||
<pre>geolib.getCompassDirection(
|
||||
{latitude: 52.518611, longitude: 13.408056},
|
||||
{latitude: 51.519475, longitude: 7.46694444}
|
||||
);
|
||||
//Output
|
||||
{
|
||||
rough: 'W',
|
||||
exact: 'WSW'
|
||||
}</pre>
|
||||
|
||||
<h3>geolib.orderByDistance(object latlng, mixed coords)</h3>
|
||||
|
||||
Sorts an object or array of coords by distance from a reference coordinate
|
||||
|
|
@ -220,58 +117,59 @@ Returns a sorted array [{latitude: x, longitude: y, distance: z, key: property}]
|
|||
<pre>
|
||||
// coords array
|
||||
geolib.orderByDistance({latitude: 51.515, longitude: 7.453619}, [
|
||||
{latitude: 52.516272, longitude: 13.377722},
|
||||
{latitude: 51.518, longitude: 7.45425},
|
||||
{latitude: 51.503333, longitude: -0.119722}
|
||||
{latitude: 52.516272, longitude: 13.377722},
|
||||
{latitude: 51.518, longitude: 7.45425},
|
||||
{latitude: 51.503333, longitude: -0.119722}
|
||||
]);
|
||||
|
||||
// coords object
|
||||
geolib.orderByDistance({latitude: 51.515, longitude: 7.453619}, {
|
||||
a: {latitude: 52.516272, longitude: 13.377722},
|
||||
b: {latitude: 51.518, longitude: 7.45425},
|
||||
c: {latitude: 51.503333, longitude: -0.119722}
|
||||
a: {latitude: 52.516272, longitude: 13.377722},
|
||||
b: {latitude: 51.518, longitude: 7.45425},
|
||||
c: {latitude: 51.503333, longitude: -0.119722}
|
||||
});
|
||||
</pre>
|
||||
|
||||
<h3>geolib.findNearest(object latlng, mixed coords[[, int offset], int limit])</h3>
|
||||
<h3>geolib.findNearest(object latlng, mixed coords[, int offset])</h3>
|
||||
|
||||
Finds the nearest coordinate to a reference coordinate.
|
||||
|
||||
<h4>Examples</h4>
|
||||
|
||||
<pre>var spots = {
|
||||
"Brandenburg Gate, Berlin": {latitude: 52.516272, longitude: 13.377722},
|
||||
"Dortmund U-Tower": {latitude: 51.515, longitude: 7.453619},
|
||||
"London Eye": {latitude: 51.503333, longitude: -0.119722},
|
||||
"Kremlin, Moscow": {latitude: 55.751667, longitude: 37.617778},
|
||||
"Eiffel Tower, Paris": {latitude: 48.8583, longitude: 2.2945},
|
||||
"Riksdag building, Stockholm": {latitude: 59.3275, longitude: 18.0675},
|
||||
"Royal Palace, Oslo": {latitude: 59.916911, longitude: 10.727567}
|
||||
"Brandenburg Gate, Berlin": {latitude: 52.516272, longitude: 13.377722},
|
||||
"Dortmund U-Tower": {latitude: 51.515, longitude: 7.453619},
|
||||
"London Eye": {latitude: 51.503333, longitude: -0.119722},
|
||||
"Kremlin, Moscow": {latitude: 55.751667, longitude: 37.617778},
|
||||
"Eiffel Tower, Paris": {latitude: 48.8583, longitude: 2.2945},
|
||||
"Riksdag building, Stockholm": {latitude: 59.3275, longitude: 18.0675},
|
||||
"Royal Palace, Oslo": {latitude: 59.916911, longitude: 10.727567}
|
||||
}
|
||||
|
||||
// in this case set offset to 1 otherwise the nearest point will always be your reference point
|
||||
geolib.findNearest(spots['Dortmund U-Tower'], spots, 1)
|
||||
geolib.findNearest(spots['Dortmund U-Tower'], spots, 1)
|
||||
</pre>
|
||||
|
||||
<h3>geolib.getPathLength(mixed coords)</h3>
|
||||
|
||||
Calculates the length of a collection of coordinates
|
||||
|
||||
Returns the length of the path in meters
|
||||
Returns the length of the path in kilometers
|
||||
|
||||
<h4>Example</h4>
|
||||
|
||||
<pre>
|
||||
// Calculate distance from Berlin via Dortmund to London
|
||||
geolib.getPathLength([
|
||||
{latitude: 52.516272, longitude: 13.377722}, // Berlin
|
||||
{latitude: 51.515, longitude: 7.453619}, // Dortmund
|
||||
{latitude: 51.503333, longitude: -0.119722} // London
|
||||
{latitude: 52.516272, longitude: 13.377722}, // Berlin
|
||||
{latitude: 51.515, longitude: 7.453619}, // Dortmund
|
||||
{latitude: 51.503333, longitude: -0.119722} // London
|
||||
]); // -> 945235</pre>
|
||||
|
||||
|
||||
<h3>geolib.getSpeed(coords, coords[, options])</h3>
|
||||
|
||||
Calculates the speed between two points within a given time span.
|
||||
Calculates the speed between to points within a given time span.
|
||||
|
||||
Returns the speed in <em>options.unit</em> (default is km/h).
|
||||
|
||||
|
|
@ -279,29 +177,12 @@ Returns the speed in <em>options.unit</em> (default is km/h).
|
|||
|
||||
<pre>
|
||||
geolib.getSpeed(
|
||||
{lat: 51.567294, lng: 7.38896, time: 1360231200880},
|
||||
{lat: 52.54944, lng: 13.468509, time: 1360245600880},
|
||||
{unit: 'mph'}
|
||||
{lat: 51.567294, lng: 7.38896, time: 1360231200880},
|
||||
{lat: 52.54944, lng: 13.468509, time: 1360245600880},
|
||||
{unit: 'mph'}
|
||||
); // -> 66.9408 (mph)</pre>
|
||||
|
||||
<h3>geolib.isPointInLine(object point, object start, object end</h3>
|
||||
|
||||
Calculates if given point lies in a line formed by start and end.
|
||||
|
||||
Returns true or false
|
||||
|
||||
<h4>Examples</h4>
|
||||
|
||||
<pre>var point1 = {latitude: 0.5, longitude: 0};
|
||||
var point2 = {latitude: 0, longitude: 10};
|
||||
var point3 = {latitude: 0, longitude: 15.5};
|
||||
var start = {latitude: 0, longitude: 0};
|
||||
var end = {latitude: 0, longitude: 15};
|
||||
|
||||
var isInLine1 = geolib.isPointInLine(point1, start, end) //-> false;
|
||||
var isInLine2 = geolib.isPointInLine(point2, start, end) //-> true;
|
||||
var isInLine3 = geolib.isPointInLine(point3, start, end) //-> false;
|
||||
</pre>
|
||||
|
||||
<h3>geolib.convertUnit(string unit, float distance[, int round])</h3>
|
||||
|
||||
|
|
@ -341,63 +222,16 @@ Converts a sexagesimal coordinate to decimal format
|
|||
|
||||
Converts a decimal coordinate to sexagesimal format
|
||||
|
||||
|
||||
<h4>Example</h4>
|
||||
|
||||
`geolib.decimal2sexagesimal(51.49611111); // -> 51° 29' 46.00`
|
||||
|
||||
<h3>geolib.latitude(object latlng)</h3>
|
||||
<h3>geolib.longitude(object latlng)</h3>
|
||||
<h3>geolib.elevation(object latlng)</h3>
|
||||
|
||||
Returns the latitude/longitude/elevation for a given point and converts it to decimal.
|
||||
|
||||
Works with:
|
||||
- longitude: `longitude`, `lng`, `lon`, 0 (GeoJSON array)
|
||||
- latitude: `latitude`, `lat`, 1 (GeoJSON array)
|
||||
- elevation: `elevation`, `elev`, `alt`, `altitude`, 2 (GeoJSON array)
|
||||
|
||||
<h4>Examples</h4>
|
||||
|
||||
`geolib.latitude({lat: 51.49611, lng: 7.38896}); // -> 51.49611`
|
||||
`geolib.longitude({lat: 51.49611, lng: 7.38896}); // -> 7.38896`
|
||||
|
||||
<h3>geolib.useDecimal(mixed latlng)</h3>
|
||||
<h3>geolib.useDecimal(mixed coordinate)</h3>
|
||||
|
||||
Checks if a coordinate is already in decimal format and, if not, converts it to
|
||||
|
||||
<h4>Example</h4>
|
||||
|
||||
<pre>geolib.useDecimal("51° 29' 46\" N"); // -> 51.59611111
|
||||
geolib.useDecimal(51.59611111) // -> 51.59611111</pre>
|
||||
|
||||
<h3>geolib.computeDestinationPoint(start, distance, bearing, radius(optional))</h3>
|
||||
|
||||
Computes the destination point given an initial point, a distance and a bearing
|
||||
|
||||
If no radius is given it defaults to the mean earth radius of 6371000 meter.
|
||||
|
||||
Returns an object: `{"latitude": destLat, "longitude": destLng}`
|
||||
|
||||
(Attention: this formula is not *100%* accurate (but very close though))
|
||||
|
||||
<h4>Example</h4>
|
||||
|
||||
<pre>var initialPoint = {lat: 51.516272, lon: 0.45425}
|
||||
var dist = 1234;
|
||||
var bearing = 45;
|
||||
|
||||
geolib.computeDestinationPoint(initialPoint, dist, bearing);
|
||||
// -> {"latitude":51.52411853234181,"longitude":0.4668623365950795}
|
||||
</pre>
|
||||
|
||||
<h2>Changelog</h2>
|
||||
<h3>v2.0.0+beta1</h3>
|
||||
- Dropped support for IE6, IE7, IE8
|
||||
- Added new methods `geolib.latitude()`, `geolib.longitude()`, `geolib.elevation()` to get latitude, longitude or elevation of points. Will be converted to decimal format automatically
|
||||
- Added new method `geolib.extend()` to extend geolib object
|
||||
- Added support for GeoJSON format (`[lon, lat, elev]`)
|
||||
- Added property `geolib.version` to query the currently used version
|
||||
- Moved `geolib.elevation` to an optional module (`geolib.elevation.js`)
|
||||
- Using `Object.create(Geolib.prototype)` instead of object literal `{}`
|
||||
- New folder structure: compiled `geolib.js` can now be found in `dist/` instead of root dir
|
||||
- Improved Grunt build task
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue