Server implementation

In order to use server implementation you'll need to:

  • Copy and amend the form field html
    • Add any filters or output classes you need
    • Add your appid to the hidden 'appid' field
    • Check the link to the geodata.js file you'll add to your site (detailed below)
  • Amend the geodata.js file, changing the directory location (if necessary) of the geodata.php file
  • Use the cURL examples to write code that will make a cURL request to the geodata service

Simple implementation (Client side)

You can simply copy and paste the code samples in the Examples pages in order to get things up and running quickly. This is a good place to start:

  1. Choose the code sample you'd like to implement
  2. Copy the code sample by highlighting the text and pressing Ctrl + C / Cmd + C or by right/Ctrl clicking and choosing copy
  3. Open the file containing your form code and paste the code sample in the position where you want the drop downs to appear
  4. Save the file and test out the form

What can I do with the data?

By default, the form delivers the ID codes and numbers into fields called 'country' , 'state' , 'county' and 'city' (depending on the variation chosen). In order for you to save this data you'll need to have some server-side code in place to capture this data. If you'd like the actual place names to be saved then you'll need to read about Outputting data, which should allow you to generate fields with the right names and value types to suit almost any existing data capture system.


  • You will be limited to 100 requests per day unless you subscribe to a paid plan.
  • Simple implementation doesn't have the security controls available in Server side implementation (available to subscribers only)