Autocomplete API

Major Changes (v1.2 to 1.4)

No changes.

Example Request

http://free.rome2rio.com/api/1.4/xml/Autocomplete?key=&query=Bern
http://free.rome2rio.com/api/1.4/json/Autocomplete?key=&query=Bern

AutocompleteRequest

Name	Type	Description
key	string	API key
query	string	Text to autocomplete
countryCode	string	ISO 3166-1 two letter country code (optional hint)
languageCode	string	ISO 639-1 two letter language code (optional hint)

AutocompleteResponse

Name	Type	Description
query	string	Query specified in request
countryCode	string	ISO 3166-1 two letter country code (hint)
languageCode	string	ISO 639-1 two letter language code (hint)
places	Place[]	Array of places

Place

Name	Type	Description
kind	string	Type of place [1]
shortName	string	Short name of place (eg: Melbourne)
longName	string	Full name of plac (eg: Melbourne, VIC, Australia)
canonicalName	string	Unique name of place (eg: Melbourne)
code	string	Airport or Station code (eg: IATA)
lat	float	Latitude (WGS84)
lng	float	Longitude (WGS84)
rad	string	Radius (size of place in km)
regionName	string	Region display name (optional)
regionCode	string	Region code (ISO 3166-2 or FIPS) (optional)
countryName	string	Country display name (optional)
countryCode	string	Country code (ISO 3166-1) (optional)

[1] Currently, the following kinds are supported: unknown, continent, country, admin3, admin2, admin1, island, village, town, city, capital, landmark, place, road, accomodation, station, airport, seaport, sea, lake and river. Please note that this list will likely change in future revisions.