Match cities
const url = 'https://api.wink.travel/reference-data/geo/city/search?term=Bangkok';const options = { method: 'GET', headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.wink.travel/reference-data/geo/city/search?term=Bangkok' \ --header 'Authorization: Bearer <token>' \ --header 'Wink-Version: 2.0'Returns cities and islands whose name phonetically matches the supplied term using a sounds-like search.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”City name term for phonetic matching
Example
BangkokHeader Parameters
Section titled “Header Parameters”Responses
Section titled “Responses”Successfully retrieved cities with phonetic match
GeoNames have been created at https://geonames.org and contain geographical destinations we use as geoname data to associate travel inventory with a location.
object
GeoNames first-level administrative division code, typically a state or province abbreviation (e.g. NY for New York)
GeoNames second-level administrative division code, typically a county or district
GeoNames third-level administrative division code, typically a municipality
GeoNames fourth-level administrative division code, typically a neighbourhood
Secondary ISO country codes for locations that span or border multiple countries
Array of alternate name
Ascii name of city
Country
object
Area in square kilometers
Country capital
Continent code
Currency code
Currency name
FIPS country code
Country GeoNames identifier
ISO code
3 character ISO code
Numeric ISO code
Country languages
Country name
Neighboring countries
Calling code
Country population
Postal code format
Postal code regular expression
Country TLD
ISO 3166-1 alpha-2 country code for the country this location belongs to
Digital elevation model height in meters above sea level from the SRTM dataset
City elevation
GeoNames broad feature category (e.g. P=populated place, A=administrative, L=parks, H=water, T=terrain)
GeoNames specific feature code identifying the place type (e.g. PPL=populated place, PPLC=national capital, ISL=island)
GeoName identifier
Coordinate points of the city
object
Date when this GeoNames record was last modified in the GeoNames dataset
Name of city
Population of the city
Search radius in meters used for proximity queries around this location (defaults to 50,000 m / 50 km)
Country sub division
object
Sub-country ascii name
Code
Country code
Sub-country GeoNames identifier
Sub-country name
Sub-country code
Country sub sub division
object
ASCII-transliterated name of the county or district, safe for URLs and sorting
Fully qualified subdivision code combining country, sub-country, and sub-sub-country codes
ISO 3166-1 alpha-2 country code
GeoNames.org unique identifier for this subdivision
Official name of the county or district in its local script
First-level subdivision (state/province) code within the country
Second-level subdivision (county/district) code within the state or province
IANA timezone identifier for the location
GeoNameLightweight type
Url name
Example
[ { "admin1Code": "40", "admin2Code": "2401", "admin3Code": "", "admin4Code": "", "alternateCountryCodes": [], "alternateNames": [ "Krung Thep", "BKK" ], "asciiName": "Bangkok", "country": { "area": 514000, "capital": "Bangkok", "continent": "AS", "currencyCode": "THB", "currencyName": "Baht", "fips": "TH", "geoNameId": "1605651", "iso": "TH", "iso3": "THA", "isoNumeric": 764, "languages": [ "th" ], "name": "Thailand", "neighbors": [ "LA", "MM", "KH", "MY" ], "phone": "66", "population": 69428524, "postalCodeFormat": "#####", "postalCodeRegEx": "^(\\d{5})$", "topLevelDomain": ".th" }, "countryCode": "TH", "digitalElevationModel": "3", "elevation": 5, "featureClass": "P", "featureCode": "PPLC", "geoNameId": "1609350", "location": { "coordinates": [ 100.5581533, 13.7370197 ], "type": "POINT" }, "modificationDate": "2023-06-15", "name": "Bangkok", "population": 10539415, "radiusInMeters": 50000, "subCountry": { "asciiName": "Bangkok", "code": "TH.40", "countryCode": "TH", "geoNameId": "1609350", "name": "Bangkok", "subCountryCode": "40" }, "subSubCountry": { "asciiName": "Bangkok District", "code": "TH.40.2401", "countryCode": "TH", "geoNameId": "1609352", "name": "Bangkok District", "subCountryCode": "40", "subSubCountryCode": "2401" }, "timezone": "Asia/Bangkok", "type": "CITY", "urlName": "bangkok-thailand" }]Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable