Download the PHP package joomla/openstreetmap without Composer
On this page you can find all versions of the php package joomla/openstreetmap. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download joomla/openstreetmap
More information about joomla/openstreetmap
Files in joomla/openstreetmap
Package openstreetmap
Short Description Joomla OpenStreetMap Package
License GPL-2.0-or-later
Homepage https://github.com/joomla-framework/openstreetmap-api
Informations about the package openstreetmap
The OpenStreetMap Package
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:
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.
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
.
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.
More Information
Following resources contain more information: OpenStreetMap API
Installation via Composer
Add "joomla/openstreetmap": "2.0.*@dev"
to the require block in your composer.json and then run composer install
.
Alternatively, you can simply run the following from the command line:
All versions of openstreetmap with dependencies
joomla/application Version ~1.0
joomla/http Version ~1.0
joomla/input Version ~1.0
joomla/oauth1 Version ^1.1.1