php nominatim

php-nominatim

A PHP client for Nominatim, the search engine for OpenStreetMap data.

Build	Stable	License

Installation

• If Composer is already installed

composer require riverside/php-nominatim

• If Composer is not installed on your system yet, you may go ahead and install it using this command line:

$ curl -sS https://getcomposer.org/installer | php

Next, add the following require entry to the composer.json file in the root of your project.

{"require" : {"riverside/php-nominatim" : "^2.0"}
}

Finally, use Composer to install php-nominatim and its dependencies:

$ php composer.phar install

Loading

require __DIR__ . '/vendor/autoload.php';

Search (geocoding)

Look up a location from a textual description or address.

$client = new RiversideNominatimClient();try {$response = $client->search('Madison Square Garden, NY');if ($response->isOK()) {echo $response->getLat(0) . ", " . $response->getLng(0);
    } else {echo 'Location not found.';
    }
} catch (InvalidArgumentException $e) {echo $e->getMessage();
} catch (Exception $e) {echo $e->getMessage();
}

Reverse geocoding

Generates an address from a latitude and longitude.

$client = new RiversideNominatimClient();try {$response = $client->reverse(48.8539373, 2.2825966);if ($response->isOK()) {echo $response->getAddress(0);
    } else {echo 'Address not found';
    }
} catch (InvalidArgumentException $e) {echo $e->getMessage();
} catch (Exception $e) {echo $e->getMessage();
}

Address lookup

Query the address and other details of one or multiple OSM objects like node, way or relation.

$client = new RiversideNominatimClient();try {$client->setAddressDetails(1);$response = $client->lookup('R146656,W104393803,N240109189');if ($response->isOK()) {echo '<pre>';print_r($response->toArray());
    } else {echo 'Address not found';
    }
} catch (InvalidArgumentException $e) {echo $e->getMessage();
} catch (Exception $e) {echo $e->getMessage();
}

Place details

Show all details about a single place saved in the database.

$client = new RiversideNominatimClient();try {$client->setAddressDetails(1);$response = $client->details(199375150);if ($response->isOK())
    {echo '<pre>';print_r($response->toArray());
    } else {echo 'Place not found';
    }
} catch (InvalidArgumentException $e) {echo $e->getMessage();
} catch (Exception $e) {echo $e->getMessage();
}

Status

Check if the service and database is running, and when the database was last updated.

$client = new RiversideNominatimClient();try {$response = $client->status();if ($response->isOK())
    {echo '<pre>';print_r($response->toArray());
    } else {echo 'Status not found';
    }
} catch (InvalidArgumentException $e) {echo $e->getMessage();
} catch (Exception $e) {echo $e->getMessage();
}

Deletable

List objects that have been deleted in OSM but are held back in Nominatim in case the deletion was accidental.

$client = new RiversideNominatimClient();try {$response = $client->deletable();if ($response->isOK())
    {echo '<pre>';print_r($response->toArray());
    } else {echo 'Deletable objects not found';
    }
} catch (InvalidArgumentException $e) {echo $e->getMessage();
} catch (Exception $e) {echo $e->getMessage();
}

Polygons

List of broken polygons detected by Nominatim.

$client = new RiversideNominatimClient();try {$response = $client->polygons();if ($response->isOK())
    {echo '<pre>';print_r($response->toArray());
    } else {echo 'Polygons not found';
    }
} catch (InvalidArgumentException $e) {echo $e->getMessage();
} catch (Exception $e) {echo $e->getMessage();
}

Links

• https://wiki.openstreetmap.org/wiki/Nominatim

• https://github.com/openstreetmap/Nominatim

• https://nominatim.openstreetmap.org/

• https://nominatim.org/