sij/mapnik
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Updated CSV Plugin (markdown)

Dane Springmeyer 2013-11-13 17:28:24 -08:00
parent 29bc9f0392
commit e0e0bbf32a
1 changed files with 2 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
CSV-Plugin.md

@ -2,6 +2,8 @@ _New in Mapnik 2.1_
This plugin can read tabular data with embedded geometries. It auto-detects column types based on common sense type coercion and auto-detects geometry data by looking for header names like `latitude/lat` and `lon/long/lng/longitude` that likely encode point data. It can also handle GeoJSON and WKT encoded geometries and will find these if any column headers are named `geojson` or `wkt` (case-insensitive).
It supports reading CSV data from files if you pass the `file` option. But if you instead pass the `inline` option and provide CSV data as a string then it will read this data instead of looking on the filesystem. An example of this usage is describe in the page on how to author good testcases: [[A-perfect-testcase]].
This plugin reads the entire file upon initialization and caches features in memory so it is extremely fast for rendering from after initial startup (for reasonable size files under 5-10 MB).
For more details on the motivations and design of this plugin see: https://github.com/mapnik/mapnik/issues/902