PHP GPX Library: Parser and generator of GPS Exchange files

Recommend this page to a friend!

Download

Info

Example

Files

Install with Composer

Download

Reputation

Support forum

Blog

Links

Ratings				Unique User Downloads		Download Rankings
58%				Total: 238		All time: 8,055 This week: 86

Version		License		PHP version		Categories
`phpgpx` 16		MIT/X Consortium ...		5		XML, PHP 5, Geography

Description

Author

Jakub Dubec

This package is a parser and generator of GPS Exchange files.

It can create a new GPX file adding coordinates of the geographic points of the tracks. It can save the track information in GPX XML format or JSON.

The package can also read and parse a GPX file and extract its track statistics like distance, average speed, average pace, minimum and maximum altitude, start and end time, and duration.

Innovation Award

March 2017
Number 13

GPX is a format for exchanging geographic information like waypoints, tracks and routes.

This package parse and write geographic file information in the GPX format.

Manuel Lemos

Jakub Dubec

Performance

Level

Level 1

Innovation award

Nominee: 1x

Example


<?php

/**

 * @author            Jakub Dubec <jakub.dubec@gmail.com>

 */



use phpGPX\Models\GpxFile;

use phpGPX\Models\Link;

use phpGPX\Models\Metadata;

use phpGPX\Models\Point;

use phpGPX\Models\Segment;

use phpGPX\Models\Track;

use phpGPX\Models\Extensions;

use phpGPX\Models\Extensions\TrackPointExtension;



require_once '../vendor/autoload.php';



$sample_data = [

    [

        'longitude' => 9.860624216140083,

        'latitude' => 54.9328621088893,

        'elevation' => 0,

        'aTemp' => 22,

        'time' => new \DateTime("+ 1 MINUTE")

    ],

    [

        'latitude' => 54.83293237320851,

        'longitude' => 9.76092208681491,

        'elevation' => 10.0,

        'aTemp' => 23,

        'time' => new \DateTime("+ 2 MINUTE")

    ],

    [

        'latitude' => 54.73327743521187,

        'longitude' => 9.66187816543752,

        'elevation' => 42.42,

        'aTemp' => 24,

        'time' => new \DateTime("+ 3 MINUTE")

    ],

    [

        'latitude' => 54.63342326167919,

        'longitude' => 9.562439849679859,

        'elevation' => 12,

        'aTemp' => 25,

        'time' => new \DateTime("+ 4 MINUTE")

    ]

];



// Creating sample link object for metadata

$link                             = new Link();

$link->href                     = "https://sibyx.github.io/phpgpx";

$link->text                     = 'phpGPX Docs';



// GpxFile contains data and handles serialization of objects

$gpx_file                         = new GpxFile();



// Creating sample Metadata object

$gpx_file->metadata             = new Metadata();



// Time attribute is always \DateTime object!

$gpx_file->metadata->time         = new \DateTime();



// Description of GPX file

$gpx_file->metadata->description = "My pretty awesome GPX file, created using phpGPX library!";



// Adding link created before to links array of metadata

// Metadata of GPX file can contain more than one link

$gpx_file->metadata->links[]     = $link;



// Creating track

$track                             = new Track();



// Name of track

$track->name                     = sprintf("Some random points in logical order. Input array should be already ordered!");



// Type of data stored in track

$track->type                     = 'RUN';



// Source of GPS coordinates

$track->source                     = sprintf("MySpecificGarminDevice");



// Creating Track segment

$segment                         = new Segment();





foreach ($sample_data as $sample_point) {

    // Creating trackpoint

    $point                         = new Point(Point::TRACKPOINT);

    $point->latitude             = $sample_point['latitude'];

    $point->longitude             = $sample_point['longitude'];

    $point->elevation             = $sample_point['elevation'];

    $point->time                 = $sample_point['time'];



    // Creating trackpoint extension

    $point->extensions             = new Extensions();

    $trackPointExtension         = new TrackPointExtension();

    $trackPointExtension->aTemp = $sample_point['aTemp'];

    $point->extensions->trackPointExtension = $trackPointExtension;



    $segment->points[]             = $point;

}



// Add segment to segment array of track

$track->segments[]                 = $segment;



// Add track to file

$gpx_file->tracks[]             = $track;



// Create waypoint

$point                             = new Point(Point::WAYPOINT);

$point->name                     = 'Example Waypoint';

$point->latitude                 = $sample_point['latitude'];

$point->longitude                 = $sample_point['longitude'];

$point->elevation                 = $sample_point['elevation'];

$point->time                     = $sample_point['time'];



// Add waypoint to file

$gpx_file->waypoints[]             = $point;



// GPX output

$gpx_file->save('CreateFileFromScratchExample.gpx', \phpGPX\phpGPX::XML_FORMAT);



// Serialized data as JSON

$gpx_file->save('CreateFileFromScratchExample.json', \phpGPX\phpGPX::JSON_FORMAT);



// Direct GPX output to browser



header("Content-Type: application/gpx+xml");

header("Content-Disposition: attachment; filename=CreatingFileFromScratchExample.gpx");



echo $gpx_file->toXML()->saveXML();

exit();

Files (119)

File	Role	Description
`docs` (37 files, 1 directory)
`example` (6 files)
`src` (1 directory)
`tests` (3 files, 2 directories)
`.codeclimate.yml`	Data	Auxiliary data
`.php_cs`	Example	Example script
`.travis.yml`	Data	Auxiliary data
`CHANGELOG.md`	Data	Auxiliary data
`CODE_OF_CONDUCT.md`	Data	Auxiliary data
`composer.json`	Data	Auxiliary data
`ISSUE_TEMPLATE.md`	Data	Auxiliary data
`LICENSE`	Lic.	License text
`phpunit.xml`	Data	Auxiliary data
`README.md`	Doc.	Documentation

File	Role	Description
`_data` (1 file)
`index.md`	Example	Example script
`phpGPX-Helpers-DateTimeHelper.md`	Data	Auxiliary data
`phpGPX-Helpers-GeoHelper.md`	Data	Auxiliary data
`phpGPX-Helpers-SerializationHelper.md`	Data	Auxiliary data
`phpGPX-Models-Bounds.md`	Data	Auxiliary data
`phpGPX-Models-Collection.md`	Data	Auxiliary data
`phpGPX-Models-Copyright.md`	Data	Auxiliary data
`phpGPX-Models-Email.md`	Data	Auxiliary data
`phpGPX-Models-Exte...bstractExtension.md`	Data	Auxiliary data
`phpGPX-Models-Exte...ckPointExtension.md`	Data	Auxiliary data
`phpGPX-Models-Extensions.md`	Data	Auxiliary data
`phpGPX-Models-GpxFile.md`	Data	Auxiliary data
`phpGPX-Models-Link.md`	Data	Auxiliary data
`phpGPX-Models-Metadata.md`	Data	Auxiliary data
`phpGPX-Models-Person.md`	Data	Auxiliary data
`phpGPX-Models-Point.md`	Data	Auxiliary data
`phpGPX-Models-Route.md`	Data	Auxiliary data
`phpGPX-Models-Segment.md`	Data	Auxiliary data
`phpGPX-Models-Stats.md`	Data	Auxiliary data
`phpGPX-Models-StatsCalculator.md`	Data	Auxiliary data
`phpGPX-Models-Summarizable.md`	Data	Auxiliary data
`phpGPX-Models-Track.md`	Data	Auxiliary data
`phpGPX-Parsers-BoundsParser.md`	Data	Auxiliary data
`phpGPX-Parsers-CopyrightParser.md`	Data	Auxiliary data
`phpGPX-Parsers-EmailParser.md`	Data	Auxiliary data
`phpGPX-Parsers-ExtensionParser.md`	Data	Auxiliary data
`phpGPX-Parsers-Ext...tExtensionParser.md`	Data	Auxiliary data
`phpGPX-Parsers-LinkParser.md`	Data	Auxiliary data
`phpGPX-Parsers-MetadataParser.md`	Data	Auxiliary data
`phpGPX-Parsers-PersonParser.md`	Data	Auxiliary data
`phpGPX-Parsers-PointParser.md`	Data	Auxiliary data
`phpGPX-Parsers-RouteParser.md`	Data	Auxiliary data
`phpGPX-Parsers-SegmentParser.md`	Data	Auxiliary data
`phpGPX-Parsers-TrackParser.md`	Data	Auxiliary data
`phpGPX-Parsers-WaypointParser.md`	Data	Auxiliary data
`phpGPX-phpGPX.md`	Data	Auxiliary data
`_config.yml`	Data	Auxiliary data

File	Role	Description
`authors.yml`	Data	Auxiliary data

File	Role	Description
`CreateFileFromScratch.php`	Example	Example script
`Example.php`	Example	Example script
`output_waypoint_test.gpx`	Data	Auxiliary data
`waypoints_create.php`	Example	Example script
`waypoints_load.php`	Example	Example script
`waypoint_test.gpx`	Data	Auxiliary data

File	Role	Description
`phpGPX` (1 file, 3 directories)

File	Role	Description
`Helpers` (5 files)
`Models` (16 files, 1 directory)
`Parsers` (12 files, 1 directory)
`phpGPX.php`	Class	Class source

File	Role	Description
`DateTimeHelper.php`	Class	Class source
`DistanceCalculator.php`	Class	Class source
`ElevationGainLossCalculator.php`	Class	Class source
`GeoHelper.php`	Class	Class source
`SerializationHelper.php`	Class	Class source

File	Role	Description
`Extensions` (2 files)
`Bounds.php`	Class	Class source
`Collection.php`	Class	Class source
`Copyright.php`	Class	Class source
`Email.php`	Class	Class source
`Extensions.php`	Class	Class source
`GpxFile.php`	Class	Class source
`Link.php`	Class	Class source
`Metadata.php`	Class	Class source
`Person.php`	Class	Class source
`Point.php`	Class	Class source
`Route.php`	Class	Class source
`Segment.php`	Class	Class source
`Stats.php`	Class	Class source
`StatsCalculator.php`	Class	Class source
`Summarizable.php`	Class	Class source
`Track.php`	Class	Class source

File	Role	Description
`AbstractExtension.php`	Class	Class source
`TrackPointExtension.php`	Class	Class source

File	Role	Description
`Extensions` (1 file)
`BoundsParser.php`	Class	Class source
`CopyrightParser.php`	Class	Class source
`EmailParser.php`	Class	Class source
`ExtensionParser.php`	Class	Class source
`LinkParser.php`	Class	Class source
`MetadataParser.php`	Class	Class source
`PersonParser.php`	Class	Class source
`PointParser.php`	Class	Class source
`RouteParser.php`	Class	Class source
`SegmentParser.php`	Class	Class source
`TrackParser.php`	Class	Class source
`WaypointParser.php`	Class	Class source

File	Role	Description
`TrackPointExtensionParser.php`	Class	Class source

File	Role	Description
`fixtures` (3 files)
`UnitTests` (1 directory)
`CreateWaypointTest.php`	Class	Class source
`LoadFileTest.php`	Class	Class source
`LoadRouteFileTest.php`	Class	Class source

File	Role	Description
`gps-track.gpx`	Data	Auxiliary data
`route.gpx`	Data	Auxiliary data
`timezero.gpx`	Data	Auxiliary data

File	Role	Description
`phpGPX` (2 directories)

File	Role	Description
`Helpers` (3 files)
`Parsers` (19 files)

File	Role	Description
`DateTimeHelperTest.php`	Class	Class source
`GeoHelperTest.php`	Class	Class source
`SerializationHelperTest.php`	Class	Class source

File	Role	Description
`AbstractParserTest.php`	Class	Class source
`BoundsParserTest.json`	Data	Auxiliary data
`BoundsParserTest.php`	Class	Class source
`BoundsParserTest.xml`	Data	Auxiliary data
`CopyrightParserTest.json`	Data	Auxiliary data
`CopyrightParserTest.php`	Class	Class source
`CopyrightParserTest.xml`	Data	Auxiliary data
`EmailParserTest.json`	Data	Auxiliary data
`EmailParserTest.php`	Class	Class source
`EmailParserTest.xml`	Data	Auxiliary data
`ExtensionParserTest.json`	Data	Auxiliary data
`ExtensionParserTest.php`	Class	Class source
`ExtensionParserTest.xml`	Data	Auxiliary data
`LinkParserTest.json`	Data	Auxiliary data
`LinkParserTest.php`	Class	Class source
`LinkParserTest.xml`	Data	Auxiliary data
`PersonParserTest.json`	Data	Auxiliary data
`PersonParserTest.php`	Class	Class source
`PersonParserTest.xml`	Data	Auxiliary data

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.

Install with Composer

	phpgpx-2018-09-25.zip 90KB
	phpgpx-2018-09-25.tar.gz 43KB
	Install with Composer

Version Control

Unique User Downloads

Download Rankings

100%

Total:	238
This week:	0

All time:	8,055
This week:	86

User Ratings

User Comments (1)

	All time
Utility:	75%
Consistency:	68%
Documentation:	68%
Examples:	75%
Tests:	-
Videos:	-
Overall:	58%
Rank:	1398

nice
8 years ago (muabshir)

80%

Applications that use this package

No pages of applications that use this class were specified.

If you know an application of this package, send a message to the author to add a link here.

About us

Advertise on this site

For more information send a message to info at phpclasses dot org.