Location Ids may be specified in several different formats:
Numeric id. This is a unique and stable identifier assigned to a location. Numeric identifiers do not change.
Textual id in the form country/city. Please note that although those ids can be guessed easily, it should be confirmed that they actually specify the city you want to query – e.g.
usa/augustadoes not refer to the city Augusta, GA, but to Augusta, ME (the id for Augusta, GA is
IATA/ICAO codes for airports.
Geographic coordinates. It is possible to specify coordinates instead of an id. The
service will then try to determine the nearest known location within the same
time zone and country. By using the
radius parameter, the
search radius can be limited. Coordinates within the territorial waters of a
country will be treated as belonging to this country. Coordinates that cannot
be resolved to a country will be resolved to their corresponding nautical time
zone. Coordinates that have not been resolved to a location (because they have
been resolved to a nautical time zone, or no location was found within the
search radius) are not valid for all services – most notably the dialcode service will return an error message if called with
Please note that specifying coordinates is not supported in all license packages – this feature is only possible with license packages which allow querying of all available locations.
Two different ways can be used to specify coordinates:
Coordinates in decimal format. Directly concatenate the coordinates including the leading sign, first the latitude, then the longitude. Negative latitudes indicate southern hemisphere, whereas positive values for the latitude indicate northern hemisphere. For longitude, negative values indicate the western hemisphere and positive values the eastern hemisphere.
Coordinates in degree/minutes/seconds format. Specify latitude followed by an uppercase
Scharacter. Directly after this value specify the longitude followed by an uppercase
Wcharacter to indicate which hemisphere it belongs to. Degree, minute, second and fraction values shall be separated with a
.(dot) character. Only degrees are mandatory, the other values can be omitted.
All coordinates shall be expressed in the WGS 84 coordinate system (typically used by e.g. GPS devices).
IATA/ICAO codes for airports. This way of specifying a location is only supported for the astronomy, the converttime and the
timeservice services. The respective code shall be
prefixed with the string
a-. The service will then respond
with information corresponding to the indicated airport or with an error if no
matching airport could be located.
|EBNF specification of accepted location ids|