PHPackages                             knyazevdev/gpx2png - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. knyazevdev/gpx2png

ActiveLibrary[Image & Media](/categories/media)

knyazevdev/gpx2png
==================

Gpx and track to image on OSM and other tiles

1.3.1(6y ago)4843[1 PRs](https://github.com/knyazevdev/gpx2png/pulls)MITPHPPHP >=5.5.0CI failing

Since Apr 15Pushed 3y ago2 watchersCompare

[ Source](https://github.com/knyazevdev/gpx2png)[ Packagist](https://packagist.org/packages/knyazevdev/gpx2png)[ Docs](https://github.com/knyazevdev/gpx2png)[ RSS](/packages/knyazevdev-gpx2png/feed)WikiDiscussions master Synced today

READMEChangelog (9)Dependencies (3)Versions (10)Used By (0)

Gpx2Png
=======

[](#gpx2png)

Php class that helps draw track and points on OSM maps.

Install
-------

[](#install)

Via Composer

```
$ composer require knyazevdev/gpx2png
```

Basic usage
-----------

[](#basic-usage)

```
require "vendor/autoload.php";
use Gpx2Png\Gpx2Png;

$gpx = new Gpx2Png();
$gpx2png->loadFile($gpxTrackFile);

$res = $gpx2png->generateImage();
$res->saveToFile($target_file);
```

Extend usage
------------

[](#extend-usage)

```
require "vendor/autoload.php";
use Gpx2Png\Gpx2Png;
use Gpx2Png\Models\Overlays\DrawParamsPoint;
use Gpx2Png\Models\Point;

// prepare points set from own source

$points = array();
foreach ($mypoints as $mypoint) {
    $points[] = new Point($mypoint['lat'], $mypoint['lon'], $point['timestamp']);
}

// load points

$gpx2png->loadPoints($points);

// set custom draw params

$gpx2png->drawParams->track->color = "black";
$gpx2png->drawParams->track->opacity = "0.3";
$gpx2png->drawParams->track->startPoint->color = "yellow";
$gpx2png->drawParams->track->distanceLabel->text_size = 20;
$gpx2png->drawParams->track->distanceLabel->text_color = 'red';

// set osm source type

$gpx2png->setMapSourceName("osm_topo");

// set custom tiles cache directory
// default: sys_get_temp_dir().'/tiles'

$gpx2png->mapSource->setTilesDirectory(__DIR__.'/tiles');

// receive result

$res = $gpx2png->generateImage();

// add extra overlays

$extraPoint = $points[mt_rand(0, count($points)-1)];
$drawParamsPoint = new DrawParamsPoint();
$drawParamsPoint->setTemplate(DrawParamsPoint::TPL_LIVE_POINT);

$res->image->drawPoint($extraPoint, $drawParamsPoint);

// save or output file

$res->saveToFile("result.png");
$res->output();
```

Credits
-------

[](#credits)

- [Alexey Knyazev](https://github.com/knyazevdev)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity15

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

9

Last Release

2213d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fdad4028e56371f025cd5c51c98232d81368673de309a4d79f6f8b5ad4475428?d=identicon)[Alexey Knyazev](/maintainers/Alexey%20Knyazev)

---

Top Contributors

[![knyazevdev](https://avatars.githubusercontent.com/u/37297237?v=4)](https://github.com/knyazevdev "knyazevdev (26 commits)")

---

Tags

gpx2pngtrack2pnggpx2imagegpx2osm

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/knyazevdev-gpx2png/health.svg)

```
[![Health](https://phpackages.com/badges/knyazevdev-gpx2png/health.svg)](https://phpackages.com/packages/knyazevdev-gpx2png)
```

###  Alternatives

[bkwld/croppa

Image thumbnail creation through specially formatted URLs for Laravel

510496.0k22](/packages/bkwld-croppa)[goat1000/svggraph

Generates SVG graphs

132849.6k3](/packages/goat1000-svggraph)[cohensive/embed

Media Embed (for Laravel or as a standalone).

120370.4k](/packages/cohensive-embed)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

63991.3k4](/packages/netresearch-rte-ckeditor-image)[humanmade/tachyon-plugin

Rewrites WordPress image URLs to use Tachyon

87338.5k2](/packages/humanmade-tachyon-plugin)[spacecatninja/imager-x

Ninja powered image transforms.

29390.0k23](/packages/spacecatninja-imager-x)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)