# Geolocation
> Documentation for Geolocation in the web tracker.
> Source: https://docs.snowplow.io/docs/sources/web-trackers/previous-versions/browser-tracker-v3-reference/plugins/geolocation/
> Documentation index: https://docs.snowplow.io/llms.txt
> Status: Previous version
> Current version: https://docs.snowplow.io/docs/sources/web-trackers/

If this plugin is enabled, the tracker will attempt to create a context from the visitor’s geolocation information. If the visitor has not already given or denied the website permission to use their geolocation information, a prompt will appear. If they give permission, then all events from that moment on will include their geolocation information.

## Installation

- `npm install @snowplow/browser-plugin-geolocation`
- `yarn add @snowplow/browser-plugin-geolocation`
- `pnpm add @snowplow/browser-plugin-geolocation`

## Initialization

```javascript
import { newTracker, trackPageView } from '@snowplow/browser-tracker';
import { GeolocationPlugin, enableGeolocationContext } from '@snowplow/browser-plugin-geolocation';

newTracker('sp1', '{{collector_url}}', {
   appId: 'my-app-id',
   plugins: [ GeolocationPlugin() ],
});

enableGeolocationContext();
```

### Functions

|                            |                                                                                                                                  |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `enableGeolocationContext` | [Documentation](/docs/sources/web-trackers/previous-versions/browser-tracker-v3-reference/tracker-setup/initialization-options/) |

### Context

Adding this plugin will automatically capture the following context:

| Context                                                                                                                                                                                                       | Example                                                                                                                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [iglu:com.snowplowanalytics.snowplow/geolocation\_context/jsonschema/1-1-0](https://github.com/snowplow/iglu-central/blob/master/schemas/com.snowplowanalytics.snowplow/geolocation_context/jsonschema/1-1-0) | ![Example geolocation context JSON showing latitude, longitude, latitudeLongitudeAccuracy, altitude, altitudeAccuracy, bearing, speed, and timestamp fields](/assets/images/Screenshot-2021-03-30-at-22.25.13-cb191812e711f44b07c6505b4dcd507f.png) |
