Coverage map

The Map screen is an interactive view of where TaxLens has data. Shade tells you how much coverage a country has; click to drill from country to region to city and read the rates, rules, and sources attached at each level.

Reading the map

Open Map in the left navigation. Every country is shaded by the volume of data behind it — the legend in the corner runs from Baseline (no data yet) through Light, Established, and Extensive to Flagship. Amber dots mark individual local jurisdictions (cities and districts); where they cluster, a numbered circle stands in until you zoom closer.

A header card shows global totals — countries, subjurisdictions, active rates, and active rules — so you can gauge overall coverage before drilling in. A Reset button returns the map to the world view at any time.

The world view — shade encodes data volume; dots mark local jurisdictions.

Hover to preview, click to open

Hovering surfaces a quick tooltip without committing to a drill-down:

  • A country shows its name, code, and counts of subjurisdictions, active rates, and active rules.
  • A region (visible once you zoom past the country level) shows its type, child-jurisdiction count, and its directly attached rates and rules.
  • A city marker shows its type and its direct rates and rules.

Clicking opens a dossier panel for that jurisdiction. Clicking a cluster of dots zooms in to expand it instead.

Drilling country → region → city

The dossier panel is where you explore one place in depth. It lists, for the selected jurisdiction:

  • Active rates attached here, with each rate's value and effective window. Inherited rates are labelled with the ancestor they come from.
  • Rules attached here, each with its type and a plain-language summary of its conditions.
  • Subjurisdictions — the child places nested below.
  • Sources — the monitored references the data is drawn from.
  1. 1
    Open a country
    Click a shaded country to open its dossier and see its country-level rates plus its list of subjurisdictions.
  2. 2
    Preview a child
    In the Subjurisdictions list, click Preview on a region or city to load its dossier in place. A Back control returns to the previous one, so you can walk the hierarchy without losing your place.
  3. 3
    Open the full page
    Use Open full page (or the external-link icon on any child) to jump to that jurisdiction in the jurisdictions browser, where rates, rules, and effective rates have dedicated tabs.
Tip
The map is the visual way in; the jurisdictions browser is the detailed way in. They cover the same data — use whichever fits the task.

The data behind it

The map is driven by a single coverage endpoint that returns per-country and per-region rollups plus the city markers. The dossier panels are read-only — the map never changes tax data. You can run the coverage call yourself:

GET/v1/map/coverage
Sign in to run

Returns the country and region rollups plus city-marker GeoJSON that the map renders.

Sign in to run this against the live API. Read-only — nothing is saved.

To see how a single jurisdiction's data is structured, head to the jurisdictions browser or the API's jurisdiction model.