Joomla Framework OpenStreetMap Package
PHP
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
Tests Prep release May 25, 2018
src Another round of PHPCS adjustments Aug 13, 2018
.gitattributes Enable PHP 5.6 testing, enable PHPCS, pull test dependencies via Comp… Aug 29, 2014
.gitignore Initialize repository May 21, 2014
.travis.yml Disallow PHP 7.2 failures, run dev dep build on PHP 7.1 Apr 8, 2018
LICENSE Initialize repository May 21, 2014
README.md Deprecate the package May 15, 2018
composer.json Update license identifier Jan 30, 2018
phpunit.xml.dist Initialize repository May 21, 2014
ruleset.xml Switch to PHPCS 2 ruleset and fix issues Aug 6, 2017

README.md

The OpenStreetMap Package Build Status

Deprecated

The joomla/openstreetmap package is deprecated with no further updates planned.

Using the OpenStreetMap Package

The intention of the OpenStreetMap package is to provide an easy straightforward interface to work with OpenStreetMap. This is based on version 0.6 of the OpenStreetMap API. You can find more information about the OpenStreetMap API at https://wiki.openstreetmap.org/wiki/API_v0.6. The OpenStreetMap package is built upon the Joomla\OAuth1 package which provides OAuth 1.0 security infrastructure for the communications. The Joomla\Http package is also used as an easy way for the non-secure information exchanges.

Initiating the OpenStreetMap class

Initiating OpenStreetMap is just a couple lines of code:

use Joomla\OpenStreetMap\OpenStreetMap;

$osm = new OpenStreetMap;

This creates basic OpenStreetMap object which can access publically available GET methods. But when you want to send data or get private data, you need to use the Joomla\OpenStreetMap\OAuth object too.

To initialise the Joomla\OpenStreetMap\OAuth object, you must supply an options array, a Joomla\Http\Http instance for HTTP requests, a Joomla\Input\Input instance to process request data from OAuth requests, and a Joomla\Application\AbstractWebApplication instance to handle OAuth requests.

use Joomla\Http\Http;
use Joomla\OpenStreetMap\OAuth;
use Joomla\OpenStreetMap\OpenStreetMap;

$key    = 'your_key';
$secret = 'your_secret';

$options = array('consumer_key' => $key, 'consumer_secret' => $secret, 'sendheaders' => true);

$client = new Http;

$application = $this->getApplication();

$oauth = new OAuth($options, $client, $application->input, $application);
$oauth->authenticate();

$osm = new OpenStreetMap($oauth);

To obtain a key and secret, you have to obtain an account at OpenStreetMap. Through your account you need to register your application along with a callback URL.

Accessing OpenStreetMap API

This API will do all types of interactions with OpenStreetMap API. This has been categorized in to 5 main sections: Changeset, Element, GPS, Info and User. All those inherit from Joomla\OpenStreetMap\OpenStreetMapObject and can be initiated through the magic __get method of the OpenStreetMap class. Methods contained in each type of object are closely related to the OpenStreetMap API calls.

General Usage

For an example, to get an element with a known identifier you need to just add following two lines additionally after creating $osm .

$element = $osm->elements;
$result = $element->readElement('node', 123);

// To view the \SimpleXMLElement object
print_r($result);

For sending information to server you must use OAuth authentication. Following is a complete sample application of creating a new changeset. Later you can use your own changeset to add elements you want.

use Joomla\Http\Http;
use Joomla\OpenStreetMap\OAuth;
use Joomla\OpenStreetMap\OpenStreetMap;

$key    = 'your_key';
$secret = 'your_secret';

$options = array('consumer_key' => $key, 'consumer_secret' => $secret, 'sendheaders' => true);

$client = new Http;

$application = $this->getApplication();

$oauth = new OAuth($options, $client, $application->input, $application);
$oauth->authenticate();

$osm = new OpenStreetMap($oauth);

$changeset = $osm->changesets;

$changesets = array(
	'comment'    => 'My First Changeset',
	'created_by' => 'JoomlaOpenStreetMap'
);

$result = $changeset->createChangeset($changesets);

// Returned value contains the identifier of new changeset
print_r($result);

More Information

Following resources contain more information: OpenStreetMap API

Installation via Composer

Add "joomla/openstreetmap": "~1.0" to the require block in your composer.json and then run composer install.

{
	"require": {
		"joomla/openstreetmap": "~1.0"
	}
}

Alternatively, you can simply run the following from the command line:

composer require joomla/openstreetmap "~1.0"