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 any region.

One Map Chart Type

OPF has a single map chart type, world, which is the PowerPoint map chart (the Aspose.Slides Map chart type). The region comes from your data, not from the chart type. Countries, US states, UK regions, Canadian provinces and Australian states all use world, and PowerPoint zooms to the places named in the category column. There are no region-specific chart types.

Map charts are Office chartex charts. Aspose.Slides writes them but does not draw them in image, PDF or SVG output. The current OPF exporter writes them as column charts until native chartex export lands.

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": "world",
        "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": "world",
        "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

Tips for Map Charts

1. Include only regions with data. Empty regions display as neutral — no need to include zero values.
2. Use 5-10 data points. Too many regions makes the chart hard to read at presentation scale.
3. Pair with a table or bar chart on the next slide for exact values. Maps are good for patterns, not precision.
4. Choose color schemes carefully. Maps work best with schemes that have a clear gradient feel — forest-green and slate-gray work well.

Next Steps

• Explore specialty charts for more data visualization
• Add KPIs with number slides
• See all chart types