Download the PHP package rvkulikov/geophp without Composer

geophp.net

The GeoPHP project has stated that it intends to restrict their project to pure geometry data. In other words, no features data such as what you might find in a GPX file.

GeoPHPwithFeatures is a fork of the popular GeoPHP project that adds features metadata to geometries.

The primary purpose of this fork is to add support for GPX file features data and convert that to and from GeoJSON making it easier to handle the kinds of features data you might find in a GPS generated GPX file and render that on a LeafLet map. I needed this capability for the next version of the maps on my site: miles-by-motorcycle.com

The other adaptors (KML, etc) simply ignore the metadata as of this writing.

GPX files with extension metadata can be read and written. They can also be converted to the GeoJSON format where geometries with metadata are converted to GeoJSON Features objects with a properties property that includes a verbatim copy of the GPX meta data extensions. The GeoJSON spec has no opinions on how the properties property is formatted so I've chosen to simply mimic the metadata structure found in GPX files keeping all the extension names the same (e.g. Garmin's gpxx:RouteExtension, gpxx:WaypointExtension, et al.)

Please note:

• A properties property is included at the top level FeaturesCollection, in violation of the standard.
• A metadata object is included in the LineString point type to represent elevation, time, and other metadata (from the GPX file) also in violation of the standard.
• GPX trkseg's in a given trk are coalesced into a single trkseg.

For an example of a Garmin Zumo 550 generated GPX file converted to GeoJSON see the tests/input/gpx and tests/input/json directories.

A simple command line tool, bin/geo_convert.php, is included to convert files manually. You may find the xmllint and json_pp useful for formatting the output so that it is human readable. For an example try:

$ cd geoPHPwithFeatures/bin $ php geo_convert.php --input-path=../test/input/gpx/2_test.gpx --input-format=gpx --output-path=test.json --output-format=geojson

For documentation please refer to the GeoPHP project.

The only public changes are the addition of an additional "metadata" parameter to all geometry constructors in addition to setMetaData() and getMetaData(). In all cases, they simply take an arbitrary associative array. Everything else should be backwards compatible with the main GeoPHP project.

Packages:

libxerces-c-samples - needed to validate GPX files. See http://www.topografix.com/gpx_validation.asp (SAXCount)

Original GeoPHP README

GeoPHP is a open-source native PHP library for doing geometry operations. It is written entirely in PHP and can therefore run on shared hosts. It can read and write a wide variety of formats: WKT (including EWKT), WKB (including EWKB), GeoJSON, KML, GPX, and GeoRSS. It works with all Simple-Feature geometries (Point, LineString, Polygon, GeometryCollection etc.) and can be used to get centroids, bounding-boxes, area, and a wide variety of other useful information.

geoPHP also helpfully wraps the GEOS php extension so that applications can get a transparent performance increase when GEOS is installed on the server. When GEOS is installed, geoPHP also becomes fully compliant with the OpenGIS® Implementation Standard for Geographic information. With GEOS you get the full-set of openGIS functions in PHP like Union, IsWithin, Touches etc. This means that applications get a useful "core-set" of geometry operations that work in all environments, and an "extended-set"of operations for environments that have GEOS installed.

See the 'getting started' section below for references and examples of everything that geoPHP can do.

This project is currently looking for co-maintainers. If you think you can help out, please send me a message. Forks are also welcome, please issue pull requests and I will merge them into the main branch.

Getting Started

• The lastest stable version can always be downloaded at: https://phayes.github.io/bin/current/geoPHP/geoPHP.tar.gz
• Read the API Reference at: https://geophp.net/api.html
• Examples
  • Using geoPHP as a GIS format converter: http://github.com/phayes/geoPHP/wiki/Example-format-converter
• Other Interesting Links:
  • Learn about GEOS integration at: https://geophp.net/geos.html

Example usage

=======

More Examples

The Well Known Text (WKT) and Well Known Binary (WKB) support is ideal for integrating with MySQL's or PostGIS's spatial capability. Once you have SELECTed your data with 'AsText('geo_field')' or 'AsBinary('geo_field')', you can put it straight into geoPHP (can be wkt or wkb, but must be the same as how you extracted it from your database):

$geom = geoPHP::load($dbRow,'wkt');

You can collect multiple geometries into one (note that you must use wkt for this):

$geom = geoPHP::load("GEOMETRYCOLLECTION(".$dbString1.",".$dbString2.")",'wkt');

Calling get components returns the sub-geometries within a geometry as an array.

$geom2 = geoPHP::load("GEOMETRYCOLLECTION(LINESTRING(1 1,5 1,5 5,1 5,1 1),LINESTRING(2 2,2 3,3 3,3 2,2 2))");
$geomComponents = $geom2->getComponents();    //an array of the two linestring geometries
$linestring1 = $geomComponents[0]->getComponents(); //an array of the first linestring's point geometries
$linestring2 = $geomComponents[1]->getComponents();
echo $linestring1[0]->x() . ", " . $linestring1[0]->y();    //outputs '1, 1'

An alternative is to use the asArray() method. Using the above geometry collection of two linestrings,

$geometryArray = $geom2->asArray();
echo $geometryArray[0][0][0] . ", " . $geometryArray[0][0][1];    //outputs '1, 1'

Clearly, more complex analysis is possible.

echo $geom2->envelope()->area();

Working with PostGIS

geoPHP, through it's EWKB adapter, has good integration with postGIS. Here's an example of reading and writing postGIS geometries

Credit

GeoPHPwithFeatures Maintainer: Yermo Lamers https://github.com/yermo

GeoPHP Maintainer: Patrick Hayes

Additional Contributors:

• GeoMemes Research (http://www.geomemes.com)
• HighWire Press (http://www.highwire.org) and GeoScienceWorld (http://www.geoscienceworld.org)
• Arnaud Renevier (gisconverter.php) https://github.com/arenevier/gisconverter.php
• Dave Tarc https://github.com/dtarc
• Elliott Hunston (documentation) https://github.com/ejh

This library is open-source and dual-licensed under both the Modified BSD License and GPLv2. Either license may be used at your option.