Overview
Map charts display data geographically, making them ideal for regional sales, market penetration, and demographic analysis. The pptx.dev API supports map charts for several regions.
Available Map Types
| Chart type |
Region |
WORLD |
World map with country-level data |
UNITED_STATES |
US map with state-level data |
UNITED_KINGDOM |
UK map with region-level data |
CANADA |
Canada map with province-level data |
AUSTRALIA |
Australia map with state-level data |
Example: US Revenue by State
{
"layout": "chart-1x-title-center",
"content": {
"heading": "Revenue by State — Q1 2026",
"chart": {
"type": "UNITED_STATES",
"categories": ["California", "Texas", "New York", "Florida", "Illinois", "Washington", "Massachusetts"],
"series": [
{ "name": "Revenue ($K)", "values": [450, 280, 320, 190, 150, 120, 110] }
]
}
}
}
Example: Global Customer Distribution
{
"layout": "chart-1x-title-center",
"content": {
"heading": "Global Customer Distribution",
"chart": {
"type": "WORLD",
"categories": ["United States", "United Kingdom", "Germany", "Japan", "Australia", "Brazil", "India"],
"series": [
{ "name": "Customers", "values": [2400, 580, 420, 310, 280, 190, 150] }
]
}
}
}
Example: UK Regional Performance
{
"layout": "chart-1x-title-center",
"content": {
"heading": "Sales by UK Region",
"chart": {
"type": "UNITED_KINGDOM",
"categories": ["London", "South East", "North West", "Scotland", "West Midlands"],
"series": [
{ "name": "Sales ($K)", "values": [320, 180, 150, 120, 95] }
]
}
}
}
When to Use Map Charts
| Use case |
Map type |
| International sales |
WORLD |
| US market analysis |
UNITED_STATES |
| UK regional strategy |
UNITED_KINGDOM |
| Canadian market |
CANADA |
| Australian operations |
AUSTRALIA |
Tips for Map Charts
- Include only regions with data. Empty regions display as neutral — no need to include zero values.
- Use 5-10 data points. Too many regions makes the chart hard to read at presentation scale.
- Pair with a table or bar chart on the next slide for exact values. Maps are good for patterns, not precision.
- Choose color schemes carefully. Maps work best with schemes that have a clear gradient feel —
forest-green and slate-gray work well.
Next Steps