Support — Tile Grid Map Pro

Published by TCViz · tino@tcviz.com · Version 1.0.0.4

Video walkthrough

Full setup, formatting options and the Pro custom TopoJSON workflow — watch on YouTube.

Quick start

Add the visual to your report from Microsoft AppSource.
Drag your Latitude column into the Latitude field well — decimal degrees, e.g. 40.4168.
Drag your Longitude column into the Longitude field well — e.g. -3.7038.
Drop a numeric measure into Value. This is what colours each tile.
In the Format pane, open Map Settings and pick your Country / Region.

The visual works from raw coordinates. There is no region-name or ISO-code lookup — each latitude/longitude pair is snapped to the grid cell that contains it. No shapefiles or GIS setup required.

Field wells

Field well	Required	Max	Description
Latitude	Yes	1	Decimal degrees
Longitude	Yes	1	Decimal degrees
Value	Recommended	1	Numeric measure used for colouring
Label	No	1	City or region name, shown on tiles and tooltips
Tooltips	No	10	Extra measures shown on hover, each aggregated independently

Built-in regions

27 country and region grids are included: Spain, Canarias, Portugal, France, Germany, Italy, Sicily, Sardinia, United Kingdom, Netherlands, Belgium, Poland, Sweden, Norway, Switzerland, Austria, United States, Alaska, Hawaii, Canada, Mexico, Brazil, Argentina, Colombia, Australia, India and Japan.

Need a geography that isn't on the list? Pro supports any TopoJSON boundary file — see below.

Free vs Pro

Feature	Free	Pro
27 built-in country and region grids	✅	✅
Aggregations — Sum, Average, Count, Min, Max	✅	✅
Conditional formatting, 3 rules	✅	✅
Tooltips, up to 10 extra fields	✅	✅
Cell labels and legend	✅	✅
Accessibility and high contrast	✅	✅
Cross-filter, multi-select, context menu	✅	✅
Data points	500	30,000
Sequential colour scale	Fixed palette	Your colours
Diverging scale — min / mid / max	❌	✅
Categorical palette	❌	✅
Custom TopoJSON boundaries	❌	✅
TopoJSON saved inside the .pbix	❌	✅
Load TopoJSON from a public URL	❌	✅

Custom TopoJSON Pro

Set Map Settings → Country / Region to Custom TopoJSON (Pro).
Drag a .json or .topojson file directly onto the visual. The drop zone appears automatically.
Coordinates are assigned to polygons by point-in-polygon testing and coloured by the aggregated value.
The file is stored inside the .pbix, so it survives closing and reopening the report. Remember to save after dropping it.

Alternatively, paste a public HTTPS link into Pro Settings → Custom TopoJSON URL.

Where to find boundary files

geoBoundaries.org — administrative divisions worldwide
Natural Earth — country, state and province outlines
Your national statistics office — most publish TopoJSON or GeoJSON

Tip: simplify large files at mapshaper.org to 5–10% before loading. The shape stays the same and rendering is much faster.

Format pane reference

Section	Options
Map Settings	Country/Region · Value Aggregation · Show Empty Cells · Show Cell Labels · Label Font Size · Label Min Tile Size · Tooltip Decimal Places
Color Scale	Scale Type · Color Min / Mid / Max · No Data Color
Conditional Formatting	Enable Rules · Rule 1 (operator) · Rule 2 (between range) · Rule 3 (operator)
Accessibility	Show Cell Borders · Border Color · Border Width · Selected Ring Color · Selected Ring Width
Legend	Show Legend · Position (Bottom / Right / Top)
Pro Settings	Custom TopoJSON URL · Show Pro Pill

FAQ

Nothing renders, or I get "No data points found".

Your coordinates fall outside the selected region. Check that Country/Region matches your data, and that latitude and longitude aren't swapped in the field wells.

What coordinate format does it expect?

Decimal degrees in WGS84 — 40.4168, not 40°25'00"N. Convert DMS values before loading.

Some tiles are empty.

Those grid cells have no matching coordinates. Turn off Show Empty Cells in Map Settings to hide them.

I see "Free version limited to 500 data points".

Expected on the Free tier. Aggregate your data upstream, or upgrade to Pro for the full dataset.

Tooltip values don't match my card visual.

The visual aggregates per cell using each field's own aggregation, read from its metadata. If a measure is defined differently in the card, set Value Aggregation explicitly in Map Settings to match.

I upgraded to Pro but the features are still locked.

Sign out of Power BI Desktop and sign back in to refresh your license status. The visual resolves the license asynchronously after the first render, so give it a moment.

My dropped TopoJSON disappeared after reopening the report.

It shouldn't — the file is persisted into the .pbix. Make sure you saved the report after dropping the file.

Does the visual send my data anywhere?

No. There is no telemetry, no analytics and no cookies, and your data never leaves the Power BI environment. The only optional outbound request is fetching a TopoJSON file from a URL you type in yourself. See the Privacy Policy.

Report a bug or request a feature

Open an issue on GitHub: github.com/tinocallarisa-web/tile-grid-map-pro/issues
Or email tino@tcviz.com. We aim to reply within two business days.

Changelog: CHANGELOG.md