Place Search

Resolve Place

Returns the full place for a place ID taken from a /places suggestion.

On top of the fields carried by the suggestion, the response adds coordinates, language and the underlying dataset record.

Each request decrements your lookup balance. An unknown ID returns 404.

get/places/{place}

Request

  • Base URL: https://api.addresszen.com/v1
  • URL: https://api.addresszen.com/v1/places/{place}
  • Auth: HTTP bearer

Path parameters

placestring required

ID of place suggestion

Query parameters

api_keystring

API Key

Your unique identifier that allows access to our APIs.

Begins ak_. Available from your dashboard.

tagsstring

Tags

A comma separated list of tags to query over.

Useful if you want to specify the circumstances in which the request was made.

If you specify multiple tags, the response comprises only requests that satisfy all of them. Searching "foo,bar" queries only requests tagged both "foo" and "bar".

Response

Success

code2000 required
message'Success' required

Example response

{
  "result": {
    "id": "geonames_7296662",
    "dataset": "geonames",
    "name": "Strumpshaw",
    "descriptive_name": "Strumpshaw, Norfolk, England",
    "country_iso": "GBR",
    "language": "en",
    "longitude": 1.47572,
    "latitude": 52.60599,
    "native": {
      "id": "geonames_7296662",
      "dataset": "geonames",
      "geonameid": 7296662,
      "name": "Strumpshaw",
      "asciiname": "Strumpshaw",
      "alternatenames": [],
      "language": "en",
      "latitude": 52.60599,
      "longitude": 1.47572,
      "feature_class": "A",
      "feature_code": "ADM4",
      "country_code": "GB",
      "country_iso": "GBR",
      "cc2": [],
      "admin1_name": "England",
      "admin1_geonameid": 6269131,
      "admin1_code": "ENG",
      "admin2_name": "Norfolk",
      "admin2_geonameid": 2641455,
      "admin2_code": "I9",
      "admin3_code": "33UC",
      "admin4_code": "33UC056",
      "population": "0",
      "elevation": null,
      "dem": 25,
      "timezone": "Europe/London",
      "modification_date": "2010-05-25T00:00:00.000Z"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.