CDNJS bower npm release dependencies license maintained

© 2018, Onur Yıldırım (@onury) MIT License. Please see the Disclaimer and License.

Geolocator.js is a utility for getting geo-location information, geocoding, address look-ups, distance & durations, timezone information and more...


See a Live Demo.

Get Geolocator.js

Link or download via CDNJS.

Download full source code from GitHub releases.

Install via Bower:

bower install geolocator

Install via NPM:

npm install geolocator


Example below, will attempt to get user's geo-location via HTML5 Geolocation and if user rejects, it will fallback to IP based geo-location.

Inside the <head> of your HTML:

<script type="text/javascript" src="geolocator.min.js"></script>
<script type="text/javascript">

        language: "en",
        google: {
            version: "3",
            key: "YOUR-GOOGLE-API-KEY"

    window.onload = function () {
        var options = {
            enableHighAccuracy: true,
            timeout: 5000,
            maximumWait: 10000,     // max wait time for desired accuracy
            maximumAge: 0,          // disable cache
            desiredAccuracy: 30,    // meters
            fallbackToIP: true,     // fallback to IP if Geolocation fails or rejected
            addressLookup: true,    // requires Google API key if true
            timezone: true,         // requires Google API key if true
            map: "map-canvas",      // interactive map element id (or options object)
            staticMap: true         // map image URL (boolean or options object)
        geolocator.locate(options, function (err, location) {
            if (err) return console.log(err);


If you've enabled map option; include the following, inside the <body> of your HTML:

<div id="map-canvas" style="width:600px;height:400px"></div>

Read API documentation for lots of other features and examples.

Important Notes


Currently, Geolocator will use nekudo/shiny_geoip by default which seems to support HTTPS. If you know other free Geo-IP services over HTTPS, let me know and we add/use them as alternatives.

Under the Hood

Geolocator v2 is written in ES2015 (ES6), compiled with Babel, bundled with Webpack and documented with Docma.

Change Log

See version changes here.


MIT. See the Disclaimer and License.