How do I serve GeoJSON to ArcGIS clients using Node.js?

FeatureServer allows you to set up Express.js endpoints that serve GeoJSON data compliant with the Esri GeoServices REST API. You need to define routes, pass GeoJSON with optional metadata, and handle queries through the provided functions like FeatureServer.route.

What's the difference between FeatureServer and ArcGIS Server?

FeatureServer is an open-source library that implements basic parts of the GeoServices API for compatibility, while ArcGIS Server is a commercial product offering full feature services, editing, and advanced geospatial capabilities. FeatureServer is best for cost-effective bridging, but lacks enterprise features.

How to migrate from FeatureServer to Koop?

Since FeatureServer is deprecated and moved to the Koop monorepo, update your npm package to '@koopjs/featureserver' and consult the Koop documentation for any API changes or setup adjustments, as the core functionality is now integrated there.

Does FeatureServer support editing features in ArcGIS?

No, FeatureServer only supports querying, info retrieval, and rendering methods. It does not implement edit operations, so for full editing capabilities, you would need ArcGIS Server or another solution that handles feature updates.

How to set up authentication with FeatureServer?

FeatureServer includes helper functions like FeatureServer.authenticate for formatting authentication responses, but you must implement the actual authentication logic (e.g., token generation) and integrate it with your Express server, as shown in the README examples.

What are the performance limits with large datasets in FeatureServer?

Performance depends on in-memory GeoJSON handling and server resources. FeatureServer supports query options like pagination and filters to manage large datasets, but it may struggle with very large or real-time data without custom caching or optimization, as noted in the cache example.

Open-Awesome

featureserver

NOASSERTIONJavaScriptv5.0.0

An open-source Node.js implementation of the ArcGIS GeoServices REST API specification for serving geographic data.

Visit Website GitHub

103 stars30 forks0 contributors

What is featureserver?

FeatureServer is an open-source Node.js library that implements the Esri GeoServices REST API specification. It allows developers to serve GeoJSON data through endpoints compatible with ArcGIS clients, enabling interoperability between open geospatial data and proprietary GIS tools without requiring Esri's commercial software.

Target Audience

Geospatial developers and organizations needing to serve geographic data to ArcGIS clients (like ArcMap, ArcGIS Online, or ArcGIS Pro) using open-source tools and standard data formats like GeoJSON.

Value Proposition

It provides a free, self-hosted alternative to ArcGIS Server for serving feature services, reducing licensing costs while maintaining compatibility with the widely adopted Esri ecosystem.

Overview

An open source Geoservices Implementation (deprecated)

Use Cases

Best For

Serving GeoJSON data to ArcGIS Desktop or ArcGIS Pro clients
Building open-source alternatives to ArcGIS Server for feature services
Creating interoperable geospatial APIs that work with both open and proprietary GIS tools
Adding GeoServices-compatible endpoints to existing Node.js/Express.js applications
Migrating from proprietary GIS servers to open-source solutions while maintaining client compatibility
Developing custom geospatial data providers that integrate with the ArcGIS ecosystem

Not Ideal For

Projects requiring active maintenance and long-term support, as FeatureServer is deprecated and unmaintained
Teams working outside the Node.js/Express ecosystem, since it's tightly coupled with Express.js
Applications needing full Esri feature service capabilities like edit operations or advanced spatial analysis
Use cases where ArcGIS client compatibility is unnecessary, as its core value is bridging to proprietary tools

Pros & Cons

Pros

GeoServices API Compliance

Implements the ArcGIS GeoServices REST API specification (v10.51/11.0), enabling seamless integration with Esri clients like ArcMap and ArcGIS Online without proprietary software.

Express.js Integration

Designed as an Express.js plugin, allowing easy addition of GeoServices endpoints to existing Node.js servers with minimal configuration, as shown in the example server setup.

Flexible Data Handling

Accepts GeoJSON input with optional metadata extensions for layer information, statistics, and query optimization, providing fine-grained control over data presentation and filtering.

Query and Rendering Support

Provides robust querying, layer info generation, and renderer creation (class breaks and unique value) per the GeoServices standard, enhancing data visualization for ArcGIS clients.

Cons

Deprecated and Unmaintained

The project is officially deprecated with a 'No Maintenance Intended' badge and has been migrated to the Koop monorepo, meaning no updates, bug fixes, or support.

Limited Feature Set

Only supports specific methods (query, info, generateRenderer), lacking full GeoServices capabilities such as edit operations, attachments, or complex spatial functions.

Manual Configuration Burden

Requires explicit route setup in Express and careful data formatting with metadata objects, which can be error-prone and time-consuming compared to more automated solutions.

Open Source Alternative To

featureserver is an open-source alternative to the following products:

ArcGIS Online Feature Services

Cloud-based feature services hosted on ArcGIS Online that allow sharing, editing, and accessing geographic feature data through web APIs. They enable collaborative mapping and real-time data updates.

ArcGIS Server

A comprehensive GIS server for publishing and managing geographic information services, including maps, data, and analytics. It enables organizations to deliver GIS capabilities across web, mobile, and desktop applications.

Frequently Asked Questions

Related Projects

geojsonio-cli

a cli for geojson.io

Stars170

Forks18

Last commit8 years ago

geojsonio-extension

chrome extension for editing github files in geojson.io

Stars1

Forks2

Last commit12 years ago

geojsonlint

REST interface for GeoJSON validation

Simple interface for simplification and conversion of GeoJSON and TopoJSON