Maps are created using MapBox.
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.
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 ISO 3166 codes can be provided.
Data configuration for coordinates mapping
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 file (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 left sidebar)
Data configuration for ISO 3166 mapping
Principal Subdivisions options
In addition to data location data, if a geojson file is imported, then a chloropleth will be rendered on the map. Adding a GeoJSON file to your Microreact project is the only way to create a chloropleth on your map. The colour will be based on an aggregate of the number of IDs within each geoJSON boundary.
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)
- Convert other shapefiles to GeoJSON format using an online converter tool like https://products.aspose.app/gis/en/conversion/shapefile-to-geojson
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.
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 done in Data-flo.
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
Being more specific in your geocoding step can fix these problems. For tips on doing this in Data-flo, see these instructions.