gpx
GPX形式(GPSデータのやり取りに使用される軽量XMLデータフォーマット:ウェイポイント、ルート、トラック)のGPSデータを読み込み、操作し、保存するためのパッケージ。
GPX形式のGPSデータを読み込み、操作し、保存するためのDartパッケージ(GPSデータの交換に使用される軽量なXMLデータ形式—ウェイポイント、ルート、トラック)。
以下は英語原文のスナップショットです。最新版は GitHub をご覧ください。
A Dart library for loading, manipulating, and saving GPS data in GPX format (https://www.topografix.com/gpx.asp), a light-weight XML data format for the interchange of GPS data, including waypoints, routes, and tracks. View the official GPX 1.1 Schema at https://www.topografix.com/GPX/1/1/gpx.xsd.
It also supports exporting Gpx data into:
In your dart/flutter project add the dependency:
dependencies:
...
gpx: ^2.5.0
To read XML input use the GpxReader object and function Gpx fromString(String input):
import 'package:gpx/gpx.dart';
void main() {
// create gpx from xml string
final xmlGpx = GpxReader().fromString('<?xml version="1.0" encoding="UTF-8"?>'
'<gpx version="1.1" creator="dart-gpx library">'
'<wpt lat="-25.7996" lon="-62.8666"><ele>10.0</ele><name>Monte Quemado</name><desc>Argentina</desc></wpt>'
'</gpx>');
print(xmlGpx);
print(xmlGpx.wpts);
}
To write object to XML use the GpxWriter object and function String asString(Gpx gpx, {bool pretty = false}):
import 'package:gpx/gpx.dart';
void main() {
// create gpx object
final gpx = Gpx();
gpx.creator = "dart-gpx library";
gpx.wpts = [
Wpt(lat: 36.62, lon: 101.77, ele: 10.0, name: 'Xining', desc: 'China'),
];
// generate xml string
final gpxString1 = GpxWriter().asString(gpx, pretty: true);
print(gpxString1);
// generate xml string with namespaces
final gpxString2 = GpxWriter().asString(
gpx,
namespaces: {
'trp': 'http://www.garmin.com/xmlschemas/TripExtensions/v1',
},
attributes: {
'xsi:schemaLocation': 'http://www.topografix.com/GPX/1/1 '
'http://www.topografix.com/GPX/1/1/gpx.xsd',
},
);
print(gpxString2);
// generate GPX 1.1-compatible xml string with standard namespaces
final gpxString3 = GpxWriter().asString(
gpx,
pretty: true,
compatibility: GpxCompatibilityMode.gpx11,
);
print(gpxString3);
}
Some GPX applications expect the standard GPX 1.1 namespace and schema declarations on the root <gpx> element. Use
GpxCompatibilityMode.gpx11 when writing files for applications such as EasyGPS, JPX, Garmin BaseCamp, and other strict
GPX parsers:
final xml = GpxWriter().asString(
gpx,
pretty: true,
compatibility: GpxCompatibilityMode.gpx11,
);
This writes a root element with the standard GPX 1.1 declarations:
<gpx xmlns="http://www.topografix.com/GPX/1/1"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd"
version="1.1"
creator="dart-gpx library">
For Garmin BaseCamp files that also need the Garmin GpxExtensions/v3
namespace, combine the GPX 1.1 compatibility mode with GpxNamespaces.garmin:
final xml = GpxWriter().asString(
gpx,
pretty: true,
compatibility: GpxCompatibilityMode.gpx11,
namespaces: GpxNamespaces.garmin,
);
Custom namespaces and attributes are applied after the compatibility mode,
so they can extend or override the default GPX 1.1 declarations when needed.
The package includes typed models for the Garmin GpxExtensions/v3, TrackPointExtension/v1, and
WaypointExtension/v1 schemas:
GarminWaypointExtensionGarminWaypointExtensionV1GarminRouteExtensionGarminRoutePointExtensionGarminTrackExtensionGarminTrackPointExtensionGarminTrackPointExtensionV1final gpx = Gpx()
..creator = 'dart-gpx library'
..trks = [
Trk(
name: 'Morning track',
typedExtensions: TrkTypedExtensions(
garmin: GarminTrkExtensions(
track: GarminTrackExtension(
displayColor: GarminDisplayColor.darkRed,
),
),
),
trksegs: [
Trkseg(
trkpts: [
Wpt(
lat: 51.5,
lon: -0.1,
typedExtensions: WptTypedExtensions(
garmin: GarminWptExtensions(
waypointV1: GarminWaypointExtensionV1(
samples: 3,
expiration: DateTime.utc(2026, 1, 2, 3, 4, 5),
),
trackPoint: GarminTrackPointExtension(
temperature: 18.5,
depth: 4.2,
),
trackPointV1: GarminTrackPointExtensionV1(
airTemperature: 18.5,
heartRate: 142,
cadence: 81,
),
),
),
),
],
),
],
),
];
final xml = GpxWriter().asString(
gpx,
pretty: true,
compatibility: GpxCompatibilityMode.gpx11,
namespaces: GpxNamespaces.garmin,
);
To export object to KML use the KmlWriter object and function String asString(Gpx gpx, {bool pretty = false}):
import 'package:gpx/gpx.dart';
void main() {
// create gpx object
final gpx = Gpx();
gpx.creator = "dart-gpx library";
gpx.wpts = [
Wpt(lat: 36.62, lon: 101.77, ele: 10.0, name: 'Xining', desc: 'China'),
];
// generate xml string
final kmlString = KmlWriter().asString(gpx, pretty: true);
print(kmlString);
// generate xml string with altitude mode - clampToGround
final kmlStringWithAltitudeMode =
KmlWriter(altitudeMode: AltitudeMode.clampToGround)
.asString(gpx, pretty: true);
print(kmlStringWithAltitudeMode);
}
This is just an initial version of the package. There are still some limitations:
Please file feature requests and bugs at the issue tracker.
The Apache 2.0 License, see LICENSE.
依存関係一覧 4 件
>=1.16.0 <2.0.0>=7.0.0 <8.0.0>=6.0.0 <7.0.0>=1.31.0 <2.0.0用途で絞り込み、開発状況を比較し、採用前に元のリポジトリで要件を確認しましょう。
“A repository is the most basic element of GitHub.”
GitHub Docs — About repositories ↗