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

Last Updated		Ratings				Unique User Downloads		Download Rankings
2025-05-07 (Less than 1 hour ago)		58%				Total: 238		All time: 8,055 This week: 86

Version		License		PHP version		Categories
`phpgpx` 17		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

Name:	Jakub Dubec `<contact>`
Classes:	1 package by Jakub Dubec
Country:	United Kingdom
Age:	???
All time rank:	4028	177 in United Kingdom
Week rank:	195	9 in United Kingdom

Level 1

Innovation award

Nominee: 1x

Example


<?php

/**

 * @author            Jakub Dubec <[email protected]>

 */



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 (130)

File	Role	Description
`.github` (1 file, 1 directory)
`docs` (37 files, 1 directory)
`example` (7 files)
`src` (1 directory)
`tests` (3 files, 2 directories)
`.codeclimate.yml`	Data	Auxiliary data
`.php-cs-fixer.php`	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
`codesee-arch-diagram.yml`	Data	Auxiliary data
`phpunit.yml`	Data	Auxiliary data

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
`CreateFileFromScratch.php`	Example	Example script
`endomondo.gpx`	Data	Auxiliary data
`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
`Helpers` (6 files)
`Models` (16 files, 1 directory)
`Parsers` (12 files, 1 directory)
`phpGPX.php`	Class	Class source

File	Role	Description
`BoundsCalculator.php`	Class	Class source
`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
`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
`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
`PointParserTest.json`	Data	Auxiliary data
`PointParserTest.php`	Class	Class source
`PointParserTest.xml`	Data	Auxiliary data
`SegmentParserTest.json`	Data	Auxiliary data
`SegmentParserTest.php`	Class	Class source
`SegmentParserTest.xml`	Data	Auxiliary data

	phpgpx-2025-05-07.zip
	phpgpx-2025-05-07.tar.gz
	Install with Composer