> ## Documentation Index
> Fetch the complete documentation index at: https://tinyanalytics.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Geographic Analytics: Map and Globe

> Explore visitor locations with a dashboard country heat map and an interactive globe with timeline replay, coordinate bubbles, and regional views.

tinyanalytics shows where your visitors are in two places: a **country heat map** on your main dashboard, and a dedicated **globe** page with four ways to explore location — a timeline that replays sessions over time, coordinate bubbles, and country and region choropleths. Both are interactive: click a country or region to filter your whole dashboard to it.

## What does the dashboard map show?

Your main dashboard includes a world map that colors each country by how many sessions came from it — darker means more traffic. It respects your active date range and filters, so it always reflects the same slice of data as the rest of the dashboard. **Click a country** to filter every report to that country; click again to clear it. This is the same drill-down as clicking a country in a breakdown table.

## What are the four globe views?

The globe page is a fuller view of the same location data, with four modes you switch between:

<AccordionGroup>
  <Accordion title="Timeline" icon="clock">
    The default view. Sessions are replayed over your selected window as markers on the map, with a scrubber you can play or drag to watch traffic arrive through the day. Click a session marker to open its full session details.
  </Accordion>

  <Accordion title="Coordinates" icon="location-dot">
    Bubbles placed at visitor locations, sized by how many sessions came from each spot — a quick read of your busiest cities and regions.
  </Accordion>

  <Accordion title="Countries" icon="flag">
    A country heat map, the same choropleth as your dashboard but full-screen. Click a country to filter the dashboard.
  </Accordion>

  <Accordion title="Subdivisions" icon="map">
    A region-level heat map — states, provinces, and other subdivisions — for when country-level is too coarse. Click a region to filter the dashboard.
  </Accordion>
</AccordionGroup>

The globe uses a light or dark basemap that matches your dashboard theme.

## How does tinyanalytics know where visitors are?

Location comes from a **privacy-preserving lookup of the visitor's IP address** to a country, region, and approximate city — the IP address itself is never stored. This is the same geo enrichment behind the Countries, Regions, and Cities breakdowns, so the map and those tables always agree. See [How tinyanalytics works](/docs/how-tinyanalytics-works) for what is and isn't kept.

<Note>
  The timeline view loads sessions in pages and caps very busy ranges; when a range is truncated, the scrubber shows a notice. For an exhaustive list, use the [Sessions](/docs/session-analytics) report with a location filter.
</Note>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does tinyanalytics store my visitors' IP addresses?">
    No. Location comes from a privacy-preserving lookup of the visitor's IP address to a country, region, and approximate city, and the IP address itself is never stored. The same geo enrichment powers the map, the globe, and the Countries, Regions, and Cities breakdowns. See [how tinyanalytics works](/docs/how-tinyanalytics-works).
  </Accordion>

  <Accordion title="How do I filter my dashboard to one country or region?">
    Click the country on your dashboard map, or click a country or region in the globe page's Countries or Subdivisions view. Every report re-scopes to that location; click again to clear it. This is the same drill-down as clicking a country in a breakdown table.
  </Accordion>

  <Accordion title="What's the difference between the dashboard map and the globe page?">
    The dashboard map is a country heat map shaded by sessions, sitting alongside your other metrics. The globe page is a fuller view of the same location data with four modes: Timeline replay, Coordinates bubbles, Countries, and Subdivisions. Both respect your active date range and filters.
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Sessions" icon="list-timeline" href="/docs/session-analytics">
    Open any session from the timeline to see its full detail.
  </Card>

  <Card title="Filter your data" icon="filter" href="/docs/analytics-filters">
    Clicking a country or region sets a filter across the dashboard.
  </Card>

  <Card title="Dashboard overview" icon="gauge" href="/docs/web-analytics-dashboard">
    The country map in the context of all your metrics.
  </Card>

  <Card title="How tinyanalytics works" icon="diagram-project" href="/docs/how-tinyanalytics-works">
    How location is derived without storing IP addresses.
  </Card>
</Columns>


## Related topics

- [Web Analytics Dashboard](/docs/web-analytics-dashboard.md)
- [Custom Analytics Dashboards](/docs/custom-analytics-dashboards.md)
- [Analytics Filters](/docs/analytics-filters.md)