How to import a shapefile into Neo4j Spatial?

Use the ShapefileImporter in Java or spatial procedures in Cypher, like CALL spatial.importShapefileToLayer, as shown in the README examples. Ensure the layer is created first, and the shapefile path is accessible.

Neo4j Spatial vs PostGIS: which should I use for geospatial data?

Neo4j Spatial is best if you need spatial queries integrated with graph data in Neo4j, while PostGIS is a standalone, more mature spatial database. Choose Neo4j Spatial for graph-centric applications, but expect a more niche ecosystem.

How to perform a 'within distance' query in Cypher with Neo4j Spatial?

Use spatial procedures like CALL spatial.withinDistance, passing the layer name and distance parameters. The README shows examples with bbox and intersect, but similar procedures exist for distance queries, though documentation is sparse.

What are the security risks of enabling unrestricted procedures in Neo4j Spatial?

It grants index creation and other write capabilities without standard privileges, potentially allowing unauthorized data modifications. The README recommends reviewing the code to assess risks, as it was a workaround for Neo4j's security model.

Can I use Neo4j Spatial with GeoServer, and how?

Yes, but integration is complex and not regularly tested. Deploy the server plugin JARs and Neo4j libraries into GeoServer's lib directory, then configure a datasource, as per the README's Geoserver Plugin section, but be prepared for version compatibility issues.

How to handle OpenStreetMap data imports in Neo4j Spatial?

Use the OSMImporter from the optional plugin JAR, which requires a two-phase process with batch-inserter, as detailed in the examples. This is more involved than shapefile imports and may need database restarts.

Is Neo4j Spatial suitable for large-scale geographic datasets?

It can handle moderate datasets with its RTree index, but for massive scales, performance might lag compared to specialized spatial databases. The in-graph storage and indexing may require careful tuning and monitoring.

Open-Awesome

Spatial

NOASSERTIONJava2025.10.0

A Neo4j library for importing, storing, and querying spatial data with support for multiple geometry types and spatial indexes.

Visit Website GitHub

819 stars196 forks0 contributors

What is Spatial?

Neo4j Spatial is a library that adds spatial capabilities to the Neo4j graph database, enabling the storage, indexing, and querying of geographic data. It allows developers to perform spatial operations like searching for data within regions or distances, and import data from formats like Shapefiles and OpenStreetMap.

Target Audience

Developers and data engineers working with Neo4j who need to integrate geospatial data and queries into their graph-based applications, such as GIS professionals or those building location-aware services.

Value Proposition

It provides a native, extensible way to handle spatial data within Neo4j, with support for multiple geometry types, coordinate systems, and integration with tools like GeoServer, avoiding the need for separate spatial databases.

Overview

Neo4j Spatial is a library of utilities for Neo4j that faciliates the enabling of spatial operations on data. In particular you can add spatial indexes to already located data, and perform spatial operations on the data like searching for data within specified regions or within a specified distance of a point of interest.

Use Cases

Best For

Adding spatial indexing and querying to existing Neo4j graph data
Importing and querying geographic data from Shapefiles or OpenStreetMap in Neo4j
Building location-aware applications with graph-based relationships
Integrating Neo4j with GIS tools like GeoServer or uDig
Performing complex spatial operations (e.g., within distance, intersects) on graph data
Managing multiple geographic layers with different coordinate systems in a single database

Not Ideal For

Projects not already committed to Neo4j as their primary database
Applications requiring high-performance, standalone spatial databases without graph data context
Teams needing plug-and-play GIS functionality without Java coding or complex configuration
Environments with strict security policies that prohibit unrestricted database procedures

Pros & Cons

Pros

Flexible Data Modeling

Supports multiple geometry encoders like WKT, WKB, and native Neo4j Points, allowing users to model geographic data in various ways as per the README's concept overview.

Multiple Coordinate Systems

Integrates with GeoTools to support various Coordinate Reference Systems (CRS) within layers, enabling handling of diverse geographic data formats.

Spatial Indexing & Querying

Includes an RTree index for fast searches and supports a wide range of spatial queries such as within distance, intersect, and contains, as detailed in the Index and Querying section.

GIS Tool Integration

Can be embedded in GIS tools like uDig and GeoServer via plugins, bridging graph databases with existing GIS ecosystems, as mentioned in the philosophy and examples.

Cons

Complex Setup and Dependencies

Requires manual JAR installation, separate plugins for OpenStreetMap support, and configuration edits in neo4j.conf, making deployment non-trivial compared to drop-in solutions.

Security Configuration Risks

Defaults to unrestricted procedures (dbms.security.procedures.unrestricted=spatial.*), which the README admits could bypass security models, posing potential risks in production environments.

Limited and Outdated Documentation

The README notes that procedures documentation is not yet fully available, and GeoServer integration is not regularly tested, leading to potential compatibility issues and a steeper learning curve.

Performance and Scalability Concerns

Relies on an in-graph RTree index which may not scale as efficiently as dedicated spatial databases for very large datasets, and the OSM importer requires batch-inserter phases, adding complexity.

Frequently Asked Questions

Related Projects

Gephi

Gephi - The Open Graph Viz Platform

[RETIRED] Neo4j graph database driver (REST API client) for Node.js

Stars924

Forks133

Last commit7 years ago

structr

ATTENTION: This repository is a clone of https://gitlab.structr.com/structr/structr. All development/issue tracking has moved there. | Structr is an integrated open-source low-code development and runtime environment that uses a graph database (Neo4j).

Stars823

Forks161

Last commit4 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub