README.markdown

Services_Openstreetmap

OpenStreetMap is a global project with an aim of collaboratively collecting map data. This package aims to make communicating with the OSM API intuitive.

Usage

Initialisation

Simply require and initialize the Services_Openstreetmap class:

require_once 'Services/Openstreetmap.php';
$osm = new Services_Openstreetmap();

Downloading Data, saving to an OSM file

$osm->get(-8.3564758, 52.821022799999994, -7.7330017, 53.0428644);
file_put_contents("area_covered.osm", $osm->getXML());

Search for a specific POI, in a saved OSM file

$osm = new Services_Openstreetmap();

$osm->loadXML("./osm.osm");
$results = $osm->search(array("amenity" => "pharmacy"));
echo "List of Pharmacies\n";
echo "==================\n\n";

foreach ($results as $result) {
    $name = null;
    $addr_street = null;
    $addr_city = null;
    $addr_country = null;
    $addr_housename = null;
    $addr_housenumber = null;
    $opening_hours = null;
    $phone = null;

    extract($result);
    $line1 = ($addr_housenumber) ? $addr_housenumber : $addr_housename;
    if ($line1 != null) {
        $line1 .= ', ';
    }
    echo  "$name\n{$line1}{$addr_street}\n$phone\n$opening_hours\n\n";
}

Get a specific Node

require_once 'Services/Openstreetmap.php';

$osm = new Services_Openstreetmap();

var_dump($osm->getNode(52245107));

Getting specific changesets, ways etc follow the same pattern.

Updating a way, or several.

require_once 'Services/Openstreetmap.php';

// A password file, is a colon delimited file.
// Eg. [email protected]:yabbadabbado
$config = array('passwordfile' => './credentials');
$osm = new Services_Openstreetmap($config);

$changeset = $osm->createChangeset();
$changeset->begin("These ways are lit");
$ways = $osm->getWays($wayId, $way2Id);
foreach ($ways as $way) {
    $way->setTag('highway', 'residential');
    $way->setTag('lit', 'yes');
    $changeset->add($way);
}
$changeset->commit();

Creating a node.

require_once 'Services/Openstreetmap.php';

// A password file, is a colon delimited file.
// Eg. [email protected]:yabbadabbado
$config = array('passwordfile' => './credentials');
$osm = new Services_Openstreetmap($config);

$changeset = $osm->createChangeset();
$changeset->begin("Added Acme Vets.");
$lat = 52.8638729;
$lon = -8.1983611;
$node = $osm->createNode($lat, $lon, array(
    'name' => 'Acme Vets',
    'building' => 'yes',
    'amenity' => 'vet')
);
$changeset->add($node);
$changeset->commit();

Working with user information.

$config = array(
    'user' => '[email protected]',
    'password' => 'w1lma4evah'
);

$osm = new Services_Openstreetmap($config);
$user = $osm->getUser();

echo 'My OSM Mugshot is at ', $user->getImage(), "\n";