Download phpGPX - unduhan kode sumber phpGPX

phpGPX

Kategori lainnya

1.3.0

Unduh

phpgpx

Perpustakaan sederhana yang ditulis dalam PHP untuk membaca dan membuat file GPX. Dokumentasi tersedia menggunakan halaman GitHub yang dihasilkan oleh Jekyll.

Kontribusi dan umpan balik diterima! Silakan periksa masalah Todo. Saya akan senang setiap fitur atau permintaan menarik.

Cabang Repositori:

master : versi stabil terbaru
develop : Bekerja di 2.x

Fitur

Dukungan penuh dari spesifikasi resmi.
Perhitungan Statistik.
Ekstensi.
Output Array JSON & XML & PHP.

Ekstensi yang didukung

Garmin Trackpointextension: http://www.garmin.com/xmlschemas/trackpointextension/v1

Perhitungan Statistik

Jarak (smoothed) (m)
Kecepatan rata -rata (m/s)
Kecepatan rata -rata (s/km)
Min / Max Altitude (M)
Koordinat Min / Max ([LAT, LNG])
(Smoothed) Elevation Gain / Loss (M)
Mulai / Akhir (objek DateTime)
Koordinat Mulai / Akhir ([LAT, LNG])
Durasi (detik)

Instalasi

Anda dapat dengan mudah menginstal pustaka phpgpx dengan komposer. Belum ada rilis yang stabil, jadi silakan gunakan kandidat rilis.

 composer require sibyx/phpgpx:1.3.0

Contoh

Buka file GPX dan muat statistik dasar

 <?php
use phpGPX  phpGPX ;

$ gpx = new phpGPX ();
	
$ file = $ gpx -> load ( ' example.gpx ' );
	
foreach ( $ file -> tracks as $ track )
{
    // Statistics for whole track
    $ track -> stats -> toArray ();
    
    foreach ( $ track -> segments as $ segment )
    {
    	// Statistics for segment of track
    	$ segment -> stats -> toArray ();
    }
}

Menulis ke File

 <?php
use phpGPX  phpGPX ;

$ gpx = new phpGPX ();
	
$ file = $ gpx -> load ( ' example.gpx ' );

// XML
$ file -> save ( ' output.gpx ' , phpGPX:: XML_FORMAT );
	
//JSON
$ file -> save ( ' output.json ' , phpGPX:: JSON_FORMAT );

Membuat file dari awal

 <?php

use phpGPX  Models  GpxFile ;
use phpGPX  Models  Link ;
use phpGPX  Models  Metadata ;
use phpGPX  Models  Point ;
use phpGPX  Models  Segment ;
use phpGPX  Models  Track ;

require_once ' /vendor/autoload.php ' ;

$ sample_data = [
	[
		' longitude ' => 9.860624216140083 ,
		' latitude ' => 54.9328621088893 ,
		' elevation ' => 0 ,
		' time ' => new  DateTime ( " + 1 MINUTE " )
	],
	[
		' latitude ' => 54.83293237320851 ,
		' longitude ' => 9.76092208681491 ,
		' elevation ' => 10.0 ,
		' time ' => new  DateTime ( " + 2 MINUTE " )
	],
	[
		' latitude ' => 54.73327743521187 ,
		' longitude ' => 9.66187816543752 ,
		' elevation ' => 42.42 ,
		' time ' => new  DateTime ( " + 3 MINUTE " )
	],
	[
		' latitude ' => 54.63342326167919 ,
		' longitude ' => 9.562439849679859 ,
		' elevation ' => 12 ,
		' 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 = " 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 = " 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 ' ];

	$ segment -> points [] = $ point ;
}

// Add segment to segment array of track
$ track -> segments [] = $ segment ;

// Recalculate stats based on received data
$ track -> recalculateStats ();

// Add track to file
$ gpx_file -> tracks [] = $ track ;

// GPX output
$ gpx_file -> save ( ' CreatingFileFromScratchExample.gpx ' ,  phpGPX phpGPX:: XML_FORMAT );

// Serialized data as JSON
$ gpx_file -> save ( ' CreatingFileFromScratchExample.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 ();

Saat ini, format output yang didukung:

Xml
Json

Konfigurasi

Gunakan konstanta statis di phpgpx untuk memodifikasi perilaku.

 /**
 * Create Stats object for each track, segment and route
 */
public static $ CALCULATE_STATS = true ;

/**
 * Additional sort based on timestamp in Routes & Tracks on XML read.
 * Disabled by default, data should be already sorted.
 */
public static $ SORT_BY_TIMESTAMP = false ;

/**
 * Default DateTime output format in JSON serialization.
 */
public static $ DATETIME_FORMAT = ' c ' ;

/**
 * Default timezone for display.
 * Data are always stored in UTC timezone.
 */
public static $ DATETIME_TIMEZONE_OUTPUT = ' UTC ' ;

/**
 * Pretty print.
 */
public static $ PRETTY_PRINT = true ;

/**
 * In stats elevation calculation: ignore points with an elevation of 0
 * This can happen with some GPS software adding a point with 0 elevation
 */
public static $ IGNORE_ELEVATION_0 = true ;

/**
 * Apply elevation gain/loss smoothing? If true, the threshold in
 * ELEVATION_SMOOTHING_THRESHOLD and ELEVATION_SMOOTHING_SPIKES_THRESHOLD (if not null) applies
 */
public static $ APPLY_ELEVATION_SMOOTHING = false ;

/**
 * if APPLY_ELEVATION_SMOOTHING is true
 * the minimum elevation difference between considered points in meters
 */
public static $ ELEVATION_SMOOTHING_THRESHOLD = 2 ;

/**
 * if APPLY_ELEVATION_SMOOTHING is true
 * the maximum elevation difference between considered points in meters
 */
public static $ ELEVATION_SMOOTHING_SPIKES_THRESHOLD = null ;

/**
 * Apply distance calculation smoothing? If true, the threshold in
 * DISTANCE_SMOOTHING_THRESHOLD applies
 */
public static $ APPLY_DISTANCE_SMOOTHING = false ;

/**
 * if APPLY_DISTANCE_SMOOTHING is true
 * the minimum distance between considered points in meters
 */
public static $ DISTANCE_SMOOTHING_THRESHOLD = 2 ;