How onury/geolocator works
Geolocator.js is a browser-side geolocation utility. A caller invokes its API to obtain a location, optionally falling back from HTML5 geolocation to IP lookup, then can request address/timezone enrichment or mapping and other geographic services. The core also exposes watching, mobile lookup, distance and conversion utilities. The principal entry-point imports are visible in the source index; several feature implementations are unsampled, so their documented capabilities are shown without asserting unverified internal call paths.
Main entry points: geolocator.js Geolocator API · fetch.js HTTP and JSONP · utils.js Shared utilities · geo.helper.js Geo helpers
Components 20
Public API
- Geolocator API
src/core/geolocator.js
Location Acquisition
- HTML5 geolocation
- Position watcher
src/core/geo.watcher.js - IP location
src/core/geolocator.js - GeoJS source config
src/geo-ip-sources/geojs.js - GeoIP DB source
src/geo-ip-sources/geoip-db.js
Geographic Services
- Geocoding lookup
src/core/geolocator.js - Timezone lookup
src/core/geolocator.js - Distance and duration
src/core/geolocator.js - Google Maps features
src/core/geolocator.js - Mobile location
src/core/geolocator.js - Geo calculations
src/core/geo.helper.js
Core Internals
- HTTP and JSONP
src/lib/fetch.js - Geo helpers
src/core/geo.helper.js - Geo errors
src/core/geo.error.js - Shared utilities
src/lib/utils.js - Geo enumerations
src/core/enums.js
Other components
- Browser caller
- GeoJS service
- Google geocoding
Connections 28
- Browser caller → Geolocator API: calls
README.md - Geolocator API → HTML5 geolocation: locates with
README.md - Geolocator API → IP location: falls back to
README.md - Geolocator API → Position watcher: uses
src/core/geolocator.js - Geolocator API → Geocoding lookup: requests
README.md - Geolocator API → Timezone lookup: requests
README.md - Geolocator API → Distance and duration: provides
README.md - Geolocator API → Google Maps features: creates
README.md - Geolocator API → Mobile location: locates by
README.md - Geolocator API → Geo calculations: calculates
README.md - GeoJS source config → GeoJS service: configures
src/geo-ip-sources/geojs.js - IP location → GeoJS source config: uses source
- IP location → GeoIP DB source: supports source
- IP location → HTTP and JSONP: requests via
src/core/geolocator.js - Geocoding lookup → Google geocoding: uses
README.md - Timezone lookup → Google geocoding: uses
README.md - Distance and duration → Google geocoding: uses
README.md - Google Maps features → Google geocoding: loads APIs
README.md - Geolocator API → Geo helpers: imports
src/core/geolocator.js - Geo helpers → HTTP and JSONP: imports
src/core/geo.helper.js - Geolocator API → HTTP and JSONP: imports
src/core/geolocator.js - Geolocator API → Geo errors: imports
src/core/geolocator.js - Geolocator API → Shared utilities: imports
src/core/geolocator.js - Geolocator API → Geo enumerations: imports
src/core/geolocator.js - Geo helpers → Geo enumerations: imports
src/core/geo.helper.js - HTTP and JSONP → Shared utilities: imports
src/lib/fetch.js - Position watcher → Shared utilities: imports
src/core/geo.watcher.js - Geo errors → Shared utilities: imports
src/core/geo.error.js