0.4.1 • Published 7 months ago
@drivie/geometry v0.4.1
@drivie/geometry
A lightweight and efficient JavaScript library for parsing, simplifying, encoding, and compressing geospatial track data.
Supports multiple GPS data formats including MyTracks CSV, GPX, and NMEA.
Installation
npm install @drivie/geometryUsage
Compress and Decompress Geometry
Compresses and decompresses geometries using geobuf and Gzip for efficient storage and transmission.
import { compress, decompress } from '@drivie/geometry';
const geometry = {
type: 'LineString',
coordinates: [
[11.638033333333333, 34.21195000000000, 553.0, 1.000],
[11.638016666666665, 34.21195000000000, 552.5, 3.000],
[11.637983333333333, 34.21196666666666, 552.5, 5.000],
],
};
const compressed = compress(geometry);
const decompressed = decompress(compressed);
assert.deepEqual(geometry, decompressed);Parse MyTracks CSV
import { parseMyTracksCSV } from '@drivie/geometry';
const data = `"Name","Activity type","Description"
"6/18/2016 10:58","driving",""
"Segment","Point","Latitude (deg)","Longitude (deg)","Altitude (m)","Bearing (deg)","Accuracy (m)","Speed (m/s)","Time","Power (W)","Cadence (rpm)","Heart rate (bpm)"
"1","1","37.75429","140.457896","104.0","1.0","5","0.52","2016-06-18T01:58:05.503Z","","",""
"1","2","37.754369","140.457894","107.0","0.0","5","2.17","2016-06-18T01:58:12.539Z","","",""
"1","3","37.754388","140.457893","108.0","356.0","5","1.99","2016-06-18T01:58:13.491Z","","",""
"1","4","37.754469","140.457907","106.0","26.0","6","1.7","2016-06-18T01:58:18.531Z","","",""
"1","5","37.75448","140.457922","106.0","44.0","7","1.71","2016-06-18T01:58:19.494Z","","",""
`;
const result: Track = parseMyTracksCSV(data);
assert.deepEqual(result.departure_time, new Date('2016-06-18T01:58:05.503Z'));
assert.deepEqual(result.overview_polyline, 'i{leF{dhxYO@C?OCAA');
assert.deepEqual(result.geometry, {
type: 'LineString',
coordinates: [
[140.457896, 37.754290, 104.0, 0.000],
[140.457894, 37.754369, 107.0, 7.036],
[140.457893, 37.754388, 108.0, 7.988],
[140.457907, 37.754469, 106.0, 13.028],
[140.457922, 37.754480, 106.0, 13.991],
],
});Parse GPX
import { parseGPX } from '@drivie/geometry';
const data = `<?xml version='1.0' encoding='UTF-8' standalone='no' ?>
<gpx creator="jp.drivie.recorder" version="1.1">
<trk>
<name>5/11/2019 19:58</name>
<trkseg>
<trkpt lat="35.690184" lon="139.70149"><ele>83.1</ele><time>2019-05-11T19:58:24+0900</time></trkpt>
<trkpt lat="35.690175" lon="139.701505"><ele>83.3</ele><time>2019-05-11T19:58:27+0900</time></trkpt>
<trkpt lat="35.690167" lon="139.701501"><ele>83.3</ele><time>2019-05-11T19:58:29+0900</time></trkpt>
<trkpt lat="35.690099" lon="139.701291"><ele>82.4</ele><time>2019-05-11T19:58:33+0900</time></trkpt>
<trkpt lat="35.690131" lon="139.701363"><ele>83.3</ele><time>2019-05-11T19:58:35+0900</time></trkpt>
</trkseg>
</trk>
</gpx>
`;
const result: Track = await parseGPX(data);
assert.deepEqual(result.departure_time, new Date('2019-05-11T10:58:24.000Z'));
assert.deepEqual(result.overview_polyline, 'svyxEimtsY?C@@Lh@EM');
assert.deepEqual(result.geometry, {
type: 'LineString',
coordinates: [
[139.701490, 35.690184, 83.1, 0.000],
[139.701505, 35.690175, 83.3, 3.000],
[139.701501, 35.690167, 83.3, 5.000],
[139.701291, 35.690099, 82.4, 9.000],
[139.701363, 35.690131, 83.3, 11.000],
],
});Parse NMEA
import { parseNMEA } from '@drivie/geometry';
const data = `$PGRMM,WGS 84*06
$GPBOD,000.6,T,000.0,M,CB,AC*42
$GPWPL,4806.712,N,01138.293,E,BB*46
$GPRMC,133716,A,3412.717,N,01138.282,E,000.0,185.1,140900,000.6,E*7B
$GPRMB,A,0.00,R,AC,CB,3412.999,N,01138.290,E,000.3,001.1,,V*06
$GPGGA,133717,3412.717,N,01138.282,E,1,05,3.9,553.0,M,46.8,M,,*4F
$GPGSA,A,3,05,,18,21,25,,29,,,,,,5.6,3.9,4.0*3C
$GPGSV,2,1,08,05,18,052,48,16,22,303,00,18,63,159,44,21,62,175,49*7A
$GPGSV,2,2,08,25,25,127,40,26,53,299,00,29,54,061,51,31,43,231,00*7D
$PGRME,38.9,M,40.2,M,55.9,M*13
$GPGLL,3412.717,N,01138.281,E,133717,A*22
$PGRMZ,1815,f,3*26
$PGRMM,WGS 84*06
$GPBOD,000.6,T,000.0,M,CB,AC*42
$GPRTE,1,1,c,0,AC,CB,BB*28
$GPWPL,4804.712,N,01138.270,E,AC*4B
$GPRMC,133718,A,3412.717,N,01138.281,E,000.0,185.1,140900,000.6,E*76
$GPRMB,A,0.00,R,AC,CB,3412.999,N,01138.290,E,000.3,001.3,,V*04
$GPGGA,133719,3412.717,N,01138.281,E,1,05,3.9,552.5,M,46.8,M,,*46
$GPGSA,A,3,05,,18,21,25,,29,,,,,,5.6,3.9,4.0*3C
$GPGSV,2,1,08,05,18,052,48,16,22,303,00,18,63,159,44,21,62,175,49*7A
$GPGSV,2,2,08,25,24,128,40,26,53,299,00,29,54,061,51,31,43,231,00*73
$PGRME,38.9,M,40.2,M,55.9,M*13
$GPGLL,3412.717,N,01138.281,E,133719,A*2C
$PGRMZ,1813,f,3*20
$PGRMM,WGS 84*06
$GPBOD,000.6,T,000.0,M,CB,AC*42
$GPWPL,3412.999,N,01138.290,E,CB*4A
$GPRMC,133720,A,3412.718,N,01138.279,E,000.0,185.1,140900,000.6,E*75
$GPRMB,A,0.00,R,AC,CB,3412.999,N,01138.290,E,000.3,001.5,,V*02
$GPGGA,133721,3412.718,N,01138.279,E,1,05,3.9,552.5,M,46.8,M,,*45
$GPGSA,A,3,05,,18,21,25,,29,,,,,,5.6,3.9,4.0*3C
$GPGSV,2,1,08,05,18,052,48,16,22,303,00,18,63,159,44,21,62,175,49*7A
`;
const result: Track = parseNMEA(data);
assert.deepEqual(result.departure_time, new Date('2000-09-14T13:37:16.000Z'));
assert.deepEqual(result.overview_polyline, 'u_yoEu``fACH');
assert.deepEqual(result.geometry, {
type: 'LineString',
coordinates: [
[11.638033333333333, 34.21195000000000, 553.0, 1.000],
[11.638016666666665, 34.21195000000000, 552.5, 3.000],
[11.637983333333333, 34.21196666666666, 552.5, 5.000],
],
});Automatically Detect and Parse Any Supported Format
import { detect } from '@drivie/geometry';
const result: Track | null = await detect(data);
if (result) {
console.log(result.departure_time);
console.log(result.overview_polyline);
console.log(result.geometry);
} else {
throw new Error('Unsupported format');
}Track Object Format
interface Track {
departure_time: Date;
overview_polyline: string;
geometry: {
type: 'LineString';
coordinates: (number | null)[][];
};
}departure_time: Start time of the track.overview_polyline: Simplified polyline (encoded in Google Maps Polyline Encoding).geometry.coordinates: Array of[longitude, latitude, altitude, timestamp].
License
MIT