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
{
"$schema": "https://openpresentation.org/schema/opf/v1",
"name": "Revenue by State — Q1 2026",
"slides": [
{
"layout": "chart-1x-title-center",
"title": "Revenue by State — Q1 2026",
"chart": {
"type": "united-states",
"data": {
"columns": [
"Series",
"California",
"Texas",
"New York",
"Florida",
"Illinois",
"Washington",
"Massachusetts"
],
"rows": [
[
"Revenue ($K)",
450,
280,
320,
190,
150,
120,
110
]
]
}
},
"design": {
"titleAlignment": "center",
"contentAlignment": "center"
}
}
],
"catalogs": {
"layouts": {
"records": [
{
"$schema": "https://openpresentation.org/schema/opf-layout/v1",
"id": "chart-1x-title-center",
"name": "Chart 1x Title Center",
"placeholders": [
{
"type": "title"
},
{
"type": "chart"
}
]
}
]
}
}
}
Example: Global Customer Distribution
{
"$schema": "https://openpresentation.org/schema/opf/v1",
"name": "Global Customer Distribution",
"slides": [
{
"layout": "chart-1x-title-center",
"title": "Global Customer Distribution",
"chart": {
"type": "world",
"data": {
"columns": [
"Series",
"United States",
"United Kingdom",
"Germany",
"Japan",
"Australia",
"Brazil",
"India"
],
"rows": [
[
"Customers",
2400,
580,
420,
310,
280,
190,
150
]
]
}
},
"design": {
"titleAlignment": "center",
"contentAlignment": "center"
}
}
],
"catalogs": {
"layouts": {
"records": [
{
"$schema": "https://openpresentation.org/schema/opf-layout/v1",
"id": "chart-1x-title-center",
"name": "Chart 1x Title Center",
"placeholders": [
{
"type": "title"
},
{
"type": "chart"
}
]
}
]
}
}
}
Example: UK Regional Performance
{
"$schema": "https://openpresentation.org/schema/opf/v1",
"name": "Sales by UK Region",
"slides": [
{
"layout": "chart-1x-title-center",
"title": "Sales by UK Region",
"chart": {
"type": "united-kingdom",
"data": {
"columns": [
"Series",
"London",
"South East",
"North West",
"Scotland",
"West Midlands"
],
"rows": [
[
"Sales ($K)",
320,
180,
150,
120,
95
]
]
}
},
"design": {
"titleAlignment": "center",
"contentAlignment": "center"
}
}
],
"catalogs": {
"layouts": {
"records": [
{
"$schema": "https://openpresentation.org/schema/opf-layout/v1",
"id": "chart-1x-title-center",
"name": "Chart 1x Title Center",
"placeholders": [
{
"type": "title"
},
{
"type": "chart"
}
]
}
]
}
}
}
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