Microreact
  • Introduction
  • Introductory Videos
  • About Microreact
    • Privacy and Terms Of Service
    • Open source software used by Microreact
    • Change Log
  • Instructions
    • Navigating the site
      • Managing Projects
    • Navigating within a project
      • History sidebar
      • Selection sidebar
      • Views Sidebar
    • Creating a Project
      • Supported File Formats
      • Metadata Data
      • Tree Data
      • Map Data
      • Timeline Data
      • Network Data
      • Matrix Data
    • Adding and Editing Panels
      • Data Table
      • Map
      • Timeline
      • Tree
      • Network
      • Data-slicer
      • Chart overview
        • Area Chart
        • Line Chart
        • Bar Chart
        • Circle, Tick, Point Charts
        • Custom charts
        • Pie Chart
        • Multi-variable Chart
        • Heatmap
      • Note Panel
      • Matrix
    • Selecting and Filtering Data
    • Labels, Colours, and Shapes
    • Saving and version control
    • Access Control and Project Sharing
      • Download Project Files
      • URL control options
    • Tips & FAQ
      • How to Link Microreact projects to Google Sheets
  • API
    • API Access Tokens
    • Creating Projects via API
    • Updating Projects via API
    • Deleting Projects via API
    • Sharing Projects via API
    • Migrating to the new API
  • Feedback
    • Contact the Microreact team
Powered by GitBook
On this page
  • ​​Location data formats
  • Latitude and Longitude
  • ISO 3166 Codes
  • GeoJSON boundaries
  • Sourcing a GeoJSON file
  • Troubleshooting

Was this helpful?

  1. Instructions
  2. Creating a Project

Map Data

​Maps are created using MapBox.

PreviousTree DataNextTimeline Data

Last updated 11 months ago

Was this helpful?

Map data are pulled down from MapBox.com, but no information is sent to MapBox. Location data in your Microreact project are not shared with MapBox, but rather they are overlaid onto the maps pulled from MapBox.

​​Location data formats

Locations can be encoded via either geographic coordinates (latitude and longitude) or ISO 3166 codes.

By default, Microreact expects columns for latitude and longitude (in positive and negative numbers). As an alternative to coordinates, a single column for codes can be provided.

Latitude and Longitude

Latitude and Longitude columns must be in +/- values, not East/West/North/South. software can be used to convert west/south values to negative numbers. .

ISO 3166 Codes

Code in double-quotes followed by a comma
longitude followed by a comma
latitude followed by a comma
location/region name in double-quotes

"BE-VLG",
51.0962462,
4.1786291,
"Flemish Region"

GeoJSON boundaries

Sourcing a GeoJSON file

GeoJSON files are shape files in a specific format. The internet has vast amounts of boundary shape data. There are also sites for converting files from one format to another, so you can create a GeoJSON from another shape file format.

Search online for files containing the type of boundary and geographic area you need. Helpful search terms: geojson, shapefile, country polygons, administrative boundaries, regional borders, cartographic boundary

Here are a few ideas (WARNING: CGPS cannot confirm safety or correctness of data from these sites)

Troubleshooting

If your map shows points in an unexpected place, you will need to fix your latitudes & longitudes. There are two main reasons records show in the wrong place.

Lacking a minus sign for S/W coordinates

Ambiguous Geocoding determined lat/long

If you are using Data-flo or another method of geocoding to determine the latitude and longitude, ambiguities like these might be causing misinterpretation of your locations:

  • Manchester is a city in England and also a city in New Hampshire, USA

  • 15220 is a postcode for Vitrac France and also for Pittsburgh, PA USA

  • Washington is the name of one US State, one US District, 21 US Cities, and 30 US Counties

For country level codes, any two-letter code from the official list can be used. For the UK and USA, two-letter codes from the the lists can be used.

Note: if you would like to add more lat/long codes for other country 3166-2 codes (or notice an outdated code) please send a pull request for this (or, if you do not know what a pull request is or cannot send one, submit the request as feedback using the "send feedback" menu in the ). To expedite your request, include the codes and locations in the format below:

In addition to data location data, if a file is imported, then a will be rendered on the map. Adding a GeoJSON file to your Microreact project is the only way to create a choropleth on your map. The colour will be based on an aggregate of the number of IDs within each geoJSON boundary.

Convert other shapefiles to GeoJSON format using an online converter tool like

Microreact requires South and West coordinates to be coded with negative numbers. If you see entries showing in the wrong place (e.g. mapping in China instead of in North America, or in Ethiopia instead of Tanzania), you may need to add a minus sign. This can be .

Being more specific in your geocoding step can fix these problems. For tips on doing this in Data-flo, see .

3166-1
3166-2
file
left sidebar
geojson
choropleth
https://geojson-maps.ash.ms/
United States Census Bureau data
http://www.naturalearthdata.com/downloads/
http://geojson.xyz/
https://datafinder.stats.govt.nz/
https://doc.arcgis.com/
https://data.humdata.org/
https://products.aspose.app/gis/en/conversion/shapefile-to-geojson
ISO 3166
Data-flo
Data configuration for coordinates mapping
Data configuration for ISO 3166 mapping
Principal Subdivisions options
See how
done in Data-flo
these instructions