vendor/sibyx/phpgpx/src/phpGPX/phpGPX.php line 109

Open in your IDE?
  1. <?php
  2. /**
  3. * Created 26/08/16 13:45
  4. * @author Jakub Dubec <jakub.dubec@gmail.com>
  5. */
  7. namespace phpGPX;
  9. use phpGPX\Models\GpxFile;
  10. use phpGPX\Parsers\MetadataParser;
  11. use phpGPX\Parsers\RouteParser;
  12. use phpGPX\Parsers\TrackParser;
  13. use phpGPX\Parsers\WaypointParser;
  15. /**
  16. * Class phpGPX
  17. * @package phpGPX
  18. */
  19. class phpGPX
  20. {
  21. const JSON_FORMAT = 'json';
  22. const XML_FORMAT = 'xml';
  24. const PACKAGE_NAME = 'phpGPX';
  25. const VERSION = '1.3.0';
  27. /**
  28. * Create Stats object for each track, segment and route
  29. * @var bool
  30. */
  31. public static $CALCULATE_STATS = true;
  33. /**
  34. * Additional sort based on timestamp in Routes & Tracks on XML read.
  35. * Disabled by default, data should be already sorted.
  36. * @var bool
  37. */
  38. public static $SORT_BY_TIMESTAMP = false;
  40. /**
  41. * Default DateTime output format in JSON serialization.
  42. * @var string
  43. */
  44. public static $DATETIME_FORMAT = 'c';
  46. /**
  47. * Default timezone for display.
  48. * Data are always stored in UTC timezone.
  49. * @var string
  50. */
  51. public static $DATETIME_TIMEZONE_OUTPUT = 'UTC';
  53. /**
  54. * Pretty print.
  55. * @var bool
  56. */
  57. public static $PRETTY_PRINT = true;
  59. /**
  60. * In stats elevation calculation: ignore points with an elevation of 0
  61. * This can happen with some GPS software adding a point with 0 elevation
  62. *
  63. * @var bool
  64. */
  65. public static $IGNORE_ELEVATION_0 = true;
  67. /**
  68. * Apply elevation gain/loss smoothing? If true, the threshold in
  69. * ELEVATION_SMOOTHING_THRESHOLD and ELEVATION_SMOOTHING_SPIKES_THRESHOLD (if not null) applies
  70. * @var bool
  71. */
  72. public static $APPLY_ELEVATION_SMOOTHING = false;
  74. /**
  75. * if APPLY_ELEVATION_SMOOTHING is true
  76. * the minimum elevation difference between considered points in meters
  77. * @var int
  78. */
  79. public static $ELEVATION_SMOOTHING_THRESHOLD = 2;
  81. /**
  82. * if APPLY_ELEVATION_SMOOTHING is true
  83. * the maximum elevation difference between considered points in meters
  84. * @var int|null
  85. */
  86. public static $ELEVATION_SMOOTHING_SPIKES_THRESHOLD = null;
  88. /**
  89. * Apply distance calculation smoothing? If true, the threshold in
  90. * DISTANCE_SMOOTHING_THRESHOLD applies
  91. * @var bool
  92. */
  93. public static $APPLY_DISTANCE_SMOOTHING = false;
  95. /**
  96. * if APPLY_DISTANCE_SMOOTHING is true
  97. * the minimum distance between considered points in meters
  98. * @var int
  99. */
  100. public static $DISTANCE_SMOOTHING_THRESHOLD = 2;
  102. /**
  103. * Load GPX file.
  104. * @param $path
  105. * @return GpxFile
  106. */
  107. public static function load($path)
  108. {
  109. $xml = file_get_contents($path);
  111. return self::parse($xml);
  112. }
  114. /**
  115. * Parse GPX data string.
  116. * @param $xml
  117. * @return GpxFile
  118. */
  119. public static function parse($xml)
  120. {
  121. $xml = simplexml_load_string($xml);
  123. $gpx = new GpxFile();
  125. // Parse creator
  126. $gpx->creator = isset($xml['creator']) ? (string)$xml['creator'] : null;
  128. // Parse metadata
  129. $gpx->metadata = isset($xml->metadata) ? MetadataParser::parse($xml->metadata) : null;
  131. // Parse waypoints
  132. $gpx->waypoints = isset($xml->wpt) ? WaypointParser::parse($xml->wpt) : [];
  134. // Parse tracks
  135. $gpx->tracks = isset($xml->trk) ? TrackParser::parse($xml->trk) : [];
  137. // Parse routes
  138. $gpx->routes = isset($xml->rte) ? RouteParser::parse($xml->rte) : [];
  140. return $gpx;
  141. }
  143. /**
  144. * Create library signature from name and version.
  145. * @return string
  146. */
  147. public static function getSignature()
  148. {
  149. return sprintf("%s/%s", self::PACKAGE_NAME, self::VERSION);
  150. }
  151. }