FREE Client Side Reverse Geocoding to City API
Introduction
The Free Client-side Reverse Geocoding to City API is a free version of Reverse Geocoding to City API which is strictly limited to the client-side implementations only.
A client-side application often requires making external API calls from a script language code, visible to a third party, like javascript for example. Utilising authenticated API requests on such can compromise security. Therefore, to protect our customers, we've decided to offer client-side implemented Reverse Geocoding with no API key required, hence totally for free.
Fair Use Policy for Client-side implementation
- You're allowed to make free and unlimited API calls from a client's web browser using its own current coordinates obtained by getCurrentPosition() method
- You're allowed to make free and unlimited API calls from client's mobiles such as iOS, Android or IoT devices using their own current coordinates only
For example, check out our free Where am I? iOS and Android app. The app demonstrates how you can implement the API for a mobile app to obtain real-time locality information for your users.
IMPORTANT! Any user detected abusing the service by implementing
it on a server-side or a client-side but with elsewhere obtained coordinates, will be blacklisted from all
of our free API Services. If you wish to utilise this Reverse Geocoding API in your backend applications,
please visit our server-side variation of this API for details.
Learn
how to avoid getting your IP address banned.
https://api.bigdatacloud.net/data/reverse-geocode-client
CURL Example
Visit our SDK page to access API clients in specific languages like Javascript, Python + PHP.
Response
Response Format
Field |
Data type |
Description |
---|---|---|
latitude |
float |
Requested Latitude |
longitude |
float |
Requested Longitude |
plusCode |
string |
Open Location Code (read more here plus codes) |
localityLanguageRequested |
string |
localityLanguage input parameter received |
continent |
string |
Localised Continent name in the requested language, if available |
continentCode |
string |
Continent code |
countryName |
string |
Localised Country name in the requested language, if available |
countryCode |
string |
Country code as defined by ISO 3166-1 standard |
principalSubdivision |
string | Localised principal subdivision name in the requested language, if available |
principalSubdivisionCode |
string |
Principal subdivision code as defined by ISO 3166-2 standard |
city |
string | Localised city name in the requested language, if available |
locality |
string | Represents the smallest geographic area recognised to which the target belongs. The language, if available, is as defined by ‘localityLanguage’ request parameter |
postcode |
string |
Postcode, if available |
localityInfo |
<LocalityInfo> object |
Detailed reverse geocoded locality information localised to the language as defined by ‘localityLanguage’ request parameter |
API Endpoint
Endpoint: | /data/reverse-geocode-client |
---|---|
Full URL: | https://api.bigdatacloud.net/data/reverse-geocode-client |