All Top-level Files

Files in the top-level directory in any check-in

  • database
  • nearest
  • zip2coords
  • config.ini
  • index.php
  • README

ZIP2Coords
----------

This is a webservice that allows us to map US ZIP codes to a pair of
coordinates.

Usage is very simple, just query the service with a ZIP code as a parameter:
http://localhost/zip2coords/?zip=90210

And receive the coordinates in JSON format:

    {"latitude":"34.0901000","longitude":"-118.4065000"}

Data comes from GeoNames Postal Codes. It is distributed as a plain text file.
To build the MySQL database run the database/geonames.sh shell script. It'll
download the required data, setup the database structure and import the data
into it using MySQL's native load functionality.

Requires PHP with PDO and JSON support.


Nearest Location
----------------

A webservice to find the nearest location (for example the nearest office,
store, etc of a business) to the given location (typically the user's), either
by coordinates or ZIP code, in the latter case using the ZIP2Coords webservice.

Locations are stored in the file locations.json in JSON format.

To use just query the service with either a ZIP code or a pair of coordinates:
http://localhost/nearest/?zip=90210 or
http://localhost/nearest/?lat=40&lng=-73

To get a response such as:

    {
        "location": "Orlando",
        "URL": "http:\/\/localhost\/Orlando_FL.html",
        "distance": 198.46303408646,
        "latitude": 28.661653,
        "longitude": -81.354558
    }

Requires PHP with cURL support.