Scatter maps plot individual data points on a map using latitude and longitude coordinates. You can optionally size and color the points based on field values.
Your data must include latitude and longitude coordinates. If your data contains addresses instead of coordinates, you’ll need to geocode them to latitude/longitude values using a third-party geocoding service before using them in a map.
Area maps color geographic regions based on data values. You can use built-in region shapes for countries or US states, or provide custom GeoJSON for other boundaries.
Toggle to use a custom GeoJSON file instead of built-in regions.
Map region
World or US (when custom region is off).
Custom GeoJSON URL
URL to your GeoJSON file (when custom region is on).
Map join field
Property from the GeoJSON file to join on (when custom region is on).
Data join field
Field in your data containing values that match the map join field. Label changes based on map type: “Country code field (ISO3)” for world, “State field” for US.
When you enable Custom region, you can provide a URL to any GeoJSON file that defines your region boundaries. After entering the URL, Lightdash loads the available properties from the GeoJSON and displays them in the Map join field dropdown. Select the property that contains values matching your data.For example, if your GeoJSON has a postal_code property and your data has a zip_code field:
Enable Custom region and enter your GeoJSON URL
Select postal_code from the Map join field dropdown
Your data must include latitude and longitude coordinates. If your data contains addresses instead of coordinates, you’ll need to geocode them to latitude/longitude values using a third-party geocoding service before using them in a map.
