A wrapper making geocoding services like Google, Yahoo, and others easier to use
TinyGeocoder is a simple script and database which wraps around APIs like
Google, Yahoo, and other geocoding services. The point of this application is
to simply create latitude/longitude coordinates from an address, or in the case
of reverse geocoding, to give the closest address from the given coordinates.
When you run out of free queries by one provider for a day, it'll automatically
move to the next one, and then the next one until you're completely out of
free geocoding queries at all the providers implemented the script.
TinyGeocoder is currently a PHP script which runs on SQLite. Thus:
It has only been tested on a Linux/Apache configuration, but if someone tests it and finds that it works on other servers, please let us know and we will revise this README.
With the requirements installed, simply drop the script in a box with access to the outside (ie, Google, Yahoo, etc). It does not have to be a publicly known or accessible server, but it does need access to the internet to be able to use the publicly accessible APIs for geocoding.
Once all the files are added, just visit the index.php page in a browser to complete your setup with API information if you want to use the services which request your usage of one (optional).
It's probably a good idea to make your db/tinygeo.sqlite database read/write-able. Also, make the db folder writeable.
Copy includes/config.sample.php to includes/config.php and make it writeable.
Once it's installed and configured, you have a few options for usage. To test, just go to the root (ie, index.php) file in a browser and use the form by submitting an address or location. You should receive back a latitude and longitude coordinate. If you don't, you may have missed a step, have file permissions issues, or perhaps the server does not have access to the public web.
Alternatively, to being using it as a service programmatically, you can start using /create-api.php instead.
Here's an example using the previously public tinygeocoder.com service. For traditional geocoding, use the "q" param:
For reverse geocoding, use the "g" param:
For JSONP and JavaScript callback functions (which works with both traditional and reverse geocoding):
Please note that the db/tinygeo.sqlite database holds all unique queries so you don't have to go out and waste another hit to the providers for a query that you've already run. I suggest perhaps creating a cron job or otherwise dumping old (over a year) data since geocoding datasets are updated every now and then.
Yes, there are some extraneous files we don't need to have here. I just haven't bothered to remove them yet.
TBD for this script, but yea, you do have to abide by the TOS the actual data providers have.
Nate Ritter - Original author (loves receiving monetary "thank you" gifts) http://perfectspace.com [email protected]
Abbas Ali - Modifying original code to use SQLite instead of MySQL
David Evans - Assisting with the JSONP and JavaScript callback functionality