Koop provider for CSV
Last updated a month ago by haoliang .
MIT · Original npm · Tarball · package.json
$ cnpm install koop-provider-csv 
SYNC missed versions from official npm registry.


npm Build Status

A configurable and reusable CSV provider for Koop, created with Koop CLI

This provider can load a CSV file from a local path or a remote endpoint. The provided CSV file must include columns of latitude and longitude coordinates.


  • fully configurable
  • support multiple CSV sources
  • support local file path or remote endpoint
  • parse boolean and numeric values automatically
  • stream processing


with npm

npm install koop-provider-csv

with Koop CLI for your Koop app

koop add provider koop-provider-csv


Once installed, this provider enables routes like


where id is the unique ID for a source CSV defined in the configuration file.

For example, this route allows to query a CSV file with ID my-csv:



This provider is configured with config and all configuration files are in the config directory.

A configuration looks like this:

  // configuration namespace for this provider plugin
  "koop-provider-csv": {
    // define one or multiple CSV sources
    "sources": {
      // a unique ID for each source, which is used in the query route
      "my-csv": {
        // [required] a file path or a URL for the source CSV
        "url": "path_to_csv",
        // [required] point coordinate columns
        "geometryColumns": {
          "longitude": "longitude_column_name",
          "latitude": "latitude_column_name"
        // [optional] ArcGIS service metadata
        // See https://koopjs.github.io/docs/development/provider/model#adding-provider-metadata-to-the-geojson
        "metadata": {
          "idField": "id_column_name"

See config/example.json for a full example.


Run dev server

$ npm start

A dev server will be running at http://localhost:8080. By default, it will use with NODE_ENV=dev and the dev configuration config/dev.json should be created beforehand.

Run tests

$ npm test



Current Tags

  • 3.1.0                                ...           latest (a month ago)

7 Versions

  • 3.1.0                                ...           a month ago
  • 3.0.1                                ...           a year ago
  • 3.0.0                                ...           a year ago
  • 2.1.0                                ...           a year ago
  • 2.0.0                                ...           2 years ago
  • 1.0.1                                ...           2 years ago
  • 1.0.0                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 2
Last Day 0
Last Week 0
Last Month 12
Dependencies (4)
Dev Dependencies (8)
Dependents (0)

Copyright 2014 - 2016 © taobao.org |