API - Search for a location

Returns details of a location

URL: http://api.smynx.com/locations/place_search

HTTP Method: Get

Parameters

  • key - Your API key Required
  • full_name - The name of the location e.g. 'Cardiff'
  • country - The country of the location
  • page - Results page number (default is 1)

Error codes

  • 401 - Not Authorized
  • 404 - Not Found
  • 500 - Internal Server Error

Available API methods

The following API methods are available to use.

Ideas

Locations

Try-outs

Users

Example Response

<locations type="array">
  <location>
    <administrative_division_1_code>WLS</administrative_division_1_code>
    <administrative_division_1_name>Wales</administrative_division_1_name>
    <administrative_division_2_code>X5</administrative_division_2_code>
    <administrative_division_2_name>City and County of Cardiff</administrative_division_2_name>
    <country>United Kingdom</country>
    <fips>UK</fips>
    <full_name>Cardiff</full_name>
    <full_name_ascii>Cardiff</full_name_ascii>
    <id type="integer">710923</id>
    <iso>GB</iso>
    <latitude>51.5</latitude>
    <longitude>-3.2</longitude>
    <updated_at>Fri Jun 06 12:59:25 UTC 2008</updated_at>
  </location>
</locations>