Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads
A simple Laravel package to parse KML and KMZ files, extracting geographic data in a convenient format.
You can install the package via composer:
composer require plin-code/kml-parser
You can publish the config file with:
php artisan vendor:publish --tag="kml-parser-config"This is the contents of the published config file:
return [ /* |-------------------------------------------------------------------------- | Default KML Namespace |-------------------------------------------------------------------------- | | This value is the default namespace used for parsing KML files. | Usually you don't need to change this. | */ 'namespace' => 'http://www.opengis.net/kml/2.2', /* |-------------------------------------------------------------------------- | Temporary Directory |-------------------------------------------------------------------------- | | This value determines the temporary directory used for extracting KMZ files. | If null, the system temp directory will be used. | */ 'temp_directory' => null, ];
use PlinCode\KmlParser\KmlParser; // Parse a KML file $parser = new KmlParser(); $parser->loadFromFile('path/to/file.kml'); // Get placemarks (points of interest) $placemarks = $parser->getPlacemarks(); // Get styles $styles = $parser->getStyles(); // Get style maps $styleMaps = $parser->getStyleMaps(); // Get document name and description $name = $parser->getDocumentName(); $description = $parser->getDocumentDescription(); // Convert to GeoJSON $geoJson = $parser->toGeoJson();
KMZ files are ZIP archives that contain a KML file and possibly other assets like images:
// Parse a KMZ file $parser = new KmlParser(); $parser->loadFromKmz('path/to/file.kmz'); // Work with the data just like with KML $placemarks = $parser->getPlacemarks();
Extract all files from a KMZ:
use PlinCode\KmlParser\KmzExtractor; $extractor = new KmzExtractor(); $files = $extractor->extractAllFiles('path/to/file.kmz', 'extraction/directory');
You can also use the provided facade:
use PlinCode\KmlParser\Facades\KmlParser; $placemarks = KmlParser::loadFromFile('path/to/file.kml')->getPlacemarks();
composer testPlease see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.