Skip to main content

Resolve Place

GET 
/places/:place

Resolves a place autocompletion by its place ID.

Request​

Path Parameters

    place stringrequired

    ID of place suggestion

Query Parameters

    api_key string

    API Key

    Your unique identifier that allows access to our APIs.

    Begins ak_. Available from your dashboard

    Example: ak_test
    Tags string

    A comma separated list of tags to query over.

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

    If multiple tags are specified, the response will only comprise of requests for which all the tags are satisfied - i.e. searching "foo,bar" will only query requests which tagged both "foo" and "bar".

    Example: foo,bar

Responses​

Success

Response Headers
    Schema
      code int32required

      Possible values: [2000]

      message stringrequired

      Possible values: [Success]

      result Placerequired

      Represents a geographical place

      id IDrequired

      Global unique internally generated identifier for a place

      dataset Datasetrequired

      Possible values: [geonames]

      Indicates the provenance of a place.

      • geonames GeoNames place
      name Place Namerequired

      Place name

      descriptive_name Descriptive Place Namerequired

      Longer form description of the place.

      country_iso Countryrequired

      3 letter country code (ISO 3166-1)

      language Languagerequired

      Possible values: [en, ar, az, be, bg, bn, bs, ca, cs, cy, da, de, el, es, et, eu, fi, fo, fr, ga, gl, gn, he, hi, hr, hu, hy, id, is, it, ka, kk, km, kn, lt, lv, mk, mn, ms, mt, my, nl, no, pl, pt, ro, ru, sk, sl, sq, sr, sv, ta, th, tr, uk, uz, vi, wa, zh]

      Language represented by 2 letter ISO Code (639-1)

      longitude object required

      The longitude of the postcode (WGS84/ETRS89).

      Can be a positive or negative decimal. E.g. -0.1283983

      Returns an empty string if no location data is available.

      oneOf

      string

      latitude object required

      The latitude of the postcode (WGS84/ETRS89).

      Can be a positive or negative decimal. E.g. 51.5083983.

      Returns an empty string if no location data is available.

      oneOf

      string

      native object

      Native representation of a place

      oneOf
      geonameid int32

      Unique identifier for GeoNames place

      name string

      Possible values: <= 200 characters

      Place name (UTF8)

      asciiname string

      Possible values: <= 200 characters

      Place Name (ASCII)

      alternatenames object[]

      List of alternate ASCII names

    • Array [
      • oneOf

      string

    • ]
      • latitude object

      The latitude of the postcode (WGS84/ETRS89).

      Can be a positive or negative decimal. E.g. 51.5083983.

      Returns an empty string if no location data is available.

      oneOf

      string

      longitude object

      The longitude of the postcode (WGS84/ETRS89).

      Can be a positive or negative decimal. E.g. -0.1283983

      Returns an empty string if no location data is available.

      oneOf

      string

      feature_class string

      Possible values: [A, H, L, P, R, S, T, U, V]

      GeoNames single letter feature code

      feature_code string

      Possible values: <= 7 characters

      Full GeoNames feature code (http://www.geonames.org/export/codes.html)

      country_code string

      Possible values: >= 2 characters and <= 2 characters

      2 Letter ISO country code

      cc2 object[]

      List of other countries codes mapping to this place

    • Array [
      • oneOf

      string

    • ]
      • admin1_name string

      Name of first administrative area

      admin1_geonameid int32nullable

      GeoName ID for first administrative area

      admin1_code string

      Possible values: <= 20 characters

      Fipscode (subject to change to iso code)

      admin2_name string

      Name of second administrative area

      admin2_geonameid int32nullable

      GeoName ID for second administrative area

      admin2_code string

      Possible values: <= 20 characters

      Code for the second administrative division

      admin3_code string

      Possible values: <= 20 characters

      Code for third level administrative division

      admin4_code string

      Possible values: <= 20 characters

      Code for fourth level administrative division

      population string

      Population at place. Represented as string as it could be a larger than a 32bit integer

      elevation int32nullable

      Elevation in meters

      dem int32nullable

      Digital elevation model

      timezone string

      Possible values: <= 40 characters

      The IANA timezone ID

      modification_date string

      Datetime format

      dataset string

      Possible values: [geonames]

      id string

      Unique place ID

    Loading...