Knowledge Base

Narrative provides many different types of filters for buyers looking to create data forecasts and queries. Location filters are an important part of the forecast/query process. Users can indicate areas of interest by providing rows of locations to match against providers' datasets. However, these location files must come in three specific types and formats in order for them to work with Narrative's system.

File Types

This section outlines the three available file types and includes example files with the desired schemas. Each file covers locations for the top five ice cream shops in the US with different respective formats.

GeoJSON format

Narrative accepts GeoJSON but only in .json, .parquet, or .geojson file formats. Narrative does not accept GeoJSON added into a CSV file. To learn more about GeoJSON and see an external example check out this link.

Within GeoJSON, Narrative only accepts Polygon and MultiPolygon schemas. Other schemas such as LineString and MultiPoint are not accepted. Not sure if your GeoJSON is formatted correctly? Validate the format of your GeoJSON using this external link.

Here is a file that matches our required schema: Ice Cream Shops

WKT in CSV format

Narrative also accepts WKT in CSV format. Narrative does not accept WKT in JSON format. To learn more about WKT use this external link. Here is a file that matches our required schema: Ice Cream Shops

Point Radius

Narrative also accepts Point Radius in TXT, JSON, Parquet and CSV formats. Each row contains a lon/lat point and a radius that extends around the point. Here is a file that matches our required schema in TXT format: Ice Cream Shops 

Resources

Drawing Points: Not sure how to change your desired area into one of our accepted formats? Here is a free tool that allows you to search for your location and create lon/lat coordinates for GeoJSON and Point Radius or WKT for polygons. You can explore any area using the search bar in the top left. Users should make sure they change to the desired format in the bottom left corner when copying over text.

Lat/Lon Order: Not sure which formats accept lat/lon vs lon/lat? Here is a helpful breakdown of all lat/lon formats, including the ones that Narrative accepts.  

Please reach out to support@narrative.io with any questions!