Worldmap Panel

[](https://drone.grafana.net/grafana/worldmap-panel)

**Note:** Support for this repository has ended and it will be archived. Please see [Geomap Panel](https://grafana.com/docs/grafana/latest/panels-visualizations/visualizations/geomap/) for ongoing development and support.

Worldmap Panel Plugin for Grafana

The Worldmap Panel is a tile map of the world that can be overlaid with circles representing data points from a query. It can be used with time series metrics, with geohash data from Elasticsearch or data in the Table format.


How The Worldmap Works (Theory and Examples)

The Worldmap panel needs two sources of data:

• a location (latitude and longitude)
• data that has a link to a location

The data comes from a database query: Prometheus, InfluxDB, Graphite, Elasticsearch, MySQL etc. It can be in the Time Series format or in the Table format.

Time Series Format

If it is in the **Time Series format** then the metric name needs to match a key from a list of locations. That key is usually a country code or city name. The list of locations can come from a file or an HTTP endpoint.

The list of locations can be provided in several ways:

• json files with locations and their coordinates (the plugin includes list for countries and US states)
• json endpoints that return a list of locations and their coordinates

Time Series data contains a timestamp, a metric name and a numeric value. In other words, a typical query for a time series database. Here is some time series data from Graphite:

[
  {"target": "SE", "datapoints": [[183255.0, 1529755200]]},
  {"target": "US", "datapoints": [[192224.0, 1529755200]]}
]

Location data should be in the JSON format and should be an array of JSON objects with four properties: