Skip to main content

Resolve Place

GET/v1/places/{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.

Path parameters​

place string

ID of place suggestion

Query parameters​

api_key string optional

API Key

Your unique identifier that allows access to our APIs.

Begins ak_. Available from your dashboard.

Example ak_test
tags string optional

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".

Example foo,bar

Response​

The result contains the full place record, including coordinates, timezone, country codes, and a native object with complete GeoNames metadata (admin levels, alternate names, population, elevation, etc.).

  • result Place

    A geographical place: an administrative division, capital or seat of administration city drawn from GeoNames. GET /places returns a suggestion for each match and GET /places/{place} resolves a suggestion id to the full place. native holds the underlying GeoNames record.

    • id string

      Global unique internally generated identifier for a place

    • dataset string

      Indicates the provenance of a place.

      Values
      • "geonames"
    • name string

      Place name

      Example
      Strumpshaw
    • descriptive_name string

      Longer form description of the place.

      Example
      Strumpshaw, Norfolk, England
    • country_iso string

      3 letter country code (ISO 3166-1)

      Example
      GBR
    • language string

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

      Values
      64 possible values
      • "en"
      • "ar"
      • "as"
      • "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"
      • "ja"
      • "ka"
      • "kk"
      • "km"
      • "kn"
      • "ko"
      • "lt"
      • "lv"
      • "mk"
      • "mn"
      • "ms"
      • "mt"
      • "my"
      • "nl"
      • "no"
      • "pl"
      • "pt"
      • "rm"
      • "ro"
      • "ru"
      • "sk"
      • "sl"
      • "sq"
      • "sr"
      • "sv"
      • "ta"
      • "th"
      • "tr"
      • "uk"
      • "uz"
      • "vi"
      • "wa"
      • "zh"
    • longitude Longitude

      The longitude of the address or postcode (WGS84).

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

      Returns an empty string if no location data is available.

      • string
      • number
    • latitude Latitude

      The latitude of the address or postcode (WGS84).

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

      Returns an empty string if no location data is available.

      • string
      • number
    • native one of

      Native representation of a place

      • GeoNames Place Full guide

        The GeoNames record backing a place, as indexed.

        Only administrative divisions (feature class A) and capital or seat-of-administration cities (feature codes PPLC and PPLA*) are indexed. Historical features (feature codes ending in H) are excluded.

        • id string

          Unique place ID

        • dataset string

          Indicates the provenance of a place

          Values
          • "geonames"
        • geonameid integer

          Unique identifier for GeoNames place

          Format
          int32
        • name string

          Place name (UTF8)

        • asciiname string

          Place name (ASCII). Empty string if not available

        • alternatenames string[]

          List of alternate names for the place

        • language string

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

          Values
          64 possible values
          • "en"
          • "ar"
          • "as"
          • "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"
          • "ja"
          • "ka"
          • "kk"
          • "km"
          • "kn"
          • "ko"
          • "lt"
          • "lv"
          • "mk"
          • "mn"
          • "ms"
          • "mt"
          • "my"
          • "nl"
          • "no"
          • "pl"
          • "pt"
          • "rm"
          • "ro"
          • "ru"
          • "sk"
          • "sl"
          • "sq"
          • "sr"
          • "sv"
          • "ta"
          • "th"
          • "tr"
          • "uk"
          • "uz"
          • "vi"
          • "wa"
          • "zh"
        • latitude Latitude

          The latitude of the address or postcode (WGS84).

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

          Returns an empty string if no location data is available.

          • string
          • number
        • longitude Longitude

          The longitude of the address or postcode (WGS84).

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

          Returns an empty string if no location data is available.

          • string
          • number
        • feature_class string

          GeoNames single letter feature class (http://www.geonames.org/export/codes.html). Only two are indexed

          • A Country, state, region
          • P City, village
          Values
          • "A"
          • "P"
        • feature_code string

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

        • country_code string

          2 letter ISO country code. Empty string if not available

        • country_iso string

          3 letter ISO country code derived from country_code. Empty string if the country cannot be resolved

        • cc2 string[]

          List of other country codes mapping to this place

        • admin1_name string

          Name of first administrative area. Empty string if not available

        • admin1_geonameid integer

          GeoName ID for first administrative area

          Format
          int32
        • admin1_code string

          Fipscode (subject to change to iso code)

        • admin2_name string

          Name of second administrative area. Empty string if not available

        • admin2_geonameid integer

          GeoName ID for second administrative area

          Format
          int32
        • admin2_code string

          Code for the second administrative division

        • admin3_code string

          Code for third level administrative division

        • admin4_code string

          Code for fourth level administrative division

        • population string

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

        • elevation integer

          Elevation in metres. null if not available

          Format
          int32
        • dem integer

          Digital elevation model (srtm3 or gtopo30), average elevation in metres

          Format
          int32
        • timezone string

          The IANA timezone ID. Empty string if not available

        • modification_date string

          Date the GeoNames record was last modified

          Format
          date-time

The result sits inside the standard { result, code, message } envelope — see the API reference for the wrapper format.