Geolocation libraries may or may not be available on the client’s web browser. The geolocation method of the navigator object returns a boolean indicating whether the browser supports or not geolocation. A simple test is enough:
To obtain the user's current location, you can call the navigator.geolocation.getCurrentPosition() method, which takes from one to three parameters:
- a callback that is executed when the geolocation succeeded
- a callback that is executed in case of error
- a PositionOptions object which has three optional properties: enableHighAccuracy, timeout, and maximumAge
Here is the explanation of the properties for the third parameter:
- enableHighAccuracy is a precision indicator. If set to true, the geolocation method will be the most accurate, but it will be slower.
- timeout is the time in milliseconds after which the position search is stopped, and the error callback function is called.
- maximumAge is related to cache's use, and is expressing the time in milliseconds below which, if a position search has already been done, a new position search is not repeated.
When geolocation succeeds, the first callback is called. This function takes as a parameter a GeolocationPosition object that encapsulates the geolocation information:
- position.coords.altitude returns the altitude
- position.coords.longitude returns the longitude
Here is a full implementation:
Don't reinvent the wheel.
Abstract's APIs are production-ready now.
Abstract's suite of API's are built to save you time. You don't need to be an expert in email validation, IP geolocation, etc. Just focus on writing code that's actually valuable for your app or business, and we'll handle the rest.Get started for free
For obvious reasons of confidentiality, the browser will not communicate geographical coordinates to your scripts without the user’s explicit consent. A call to getCurrentPosition() will necessarily provoke a warning message for the user. This can be seen as an annoyance by the user and prevent you from getting the data you need.
Since 2016-2017 most web browsers require to use the HTTPS protocol to access geolocation, which won’t be available if you do your tests locally and for classic HTTP websites.
Geolocation may not be available on every web browser.
By default, getCurrentPosition() tries to respond as quickly as possible even if the result is not very accurate. Depending on the level of detail you expect, this may be an issue.
Geo-locating a visitor using Abstract API
Abstract provides a convenient way to obtain location details of an IP address through the IP Geolocation API. Calling Abstract API can be done from any web browser, without annoying the user with a warning message, and with a high accuracy level.
Similar to most API resource providers, you will first need to get an API key. At Abstract, this process is extremely simplified, as you only need to create an account (no credit card needed), then your API key is automatically generated. The key is included in the code snippets within the documentation pages, so using it is as simple as copy-paste.
Here is an example of the output for an IP address located in France: