A library for the geocoding and reverse geocoding service.
The geocoding library provides functionality to determine a geographic coordinate given a location (geocoding), and conversely, to determine a location given a geographic coordinate (reverse geocoding). Location here can mean a specific street address, a city, or a country, and so on. A geographic coordinate is specified by a latitude and longitude, relative to the WGS84 datum.
For both geocoding and reverse geocoding searches, the location results are provided in a reply. A reply consists of a list of one or more location results. A location result contains the following fields:
- postal code
- time zone
- mobile country code
- ISO alpha-2 country code
- ISO alpha-3 country code
- ISO country id
Depending on the search and the geographic location of the result, some of the result fields may be empty. As well, depending on the geographic location, the formatting, interpretation, and even language of the fields may vary.
Successful use of these functions requires a Wi-Fi or cellular network data connection. Search operations are free, although each call of the geocoding and reverse geocoding functions may incur network access (and possible data charges). Searches are carried out by a remote server.