Documentation

NEXT GIS Platform Docs

Everything you need to integrate, extend, and deploy the NEXT GIS Platform.

Download SDK Developer Portal

Getting Started

Introduction
What is NEXT GIS Platform and how it works
Quickstart
Upload your first layer in 5 minutes
Authentication
API keys and Keycloak OIDC flow
Core Concepts
Layers, tiles, styles, and projections

REST API

Layers API
Create, update, delete, and query layers
Tiles API
Vector and raster tile endpoints (MVT)
Analysis API
Spatial operations and geometry functions
Users API
User management and role assignment
Marketplace API
Plugin discovery and management
Ingestion API
Async file upload pipeline

Python SDK

Installation
pip install nextgis-sdk
Client Reference
Client class and configuration
Layer Operations
CRUD operations on layers
Spatial Analysis
Running server-side analysis
Async Support
asyncio-compatible client

JavaScript SDK

Installation
npm install @nextgis/sdk
TypeScript Types
Full type definitions included
MapLibre Integration
Drop-in MapLibre GL source adapter
React Hooks
useLayer, useMap, useTiles hooks
Node.js / Browser
Works in both environments

Plugin Development

Plugin Architecture
How plugins are loaded and isolated
Manifest Format
plugin.manifest.json specification
Hooks & Events
Available lifecycle hooks
UI Components
Register toolbar buttons and panels
Publishing
Submit to the marketplace

Real-time & Streaming

WebSocket API
Live layer update subscriptions
Event Types
layer.created, feature.updated, …
Kafka Integration
High-throughput event streaming

API Reference

Key endpoints

Base URL: https://nextcarto.it/api/v1

MethodEndpointDescription
GET/api/v1/healthPlatform health check
GET/api/v1/layers/List all layers
POST/api/v1/layers/Create a new layer
GET/api/v1/layers/:id/Get layer details
DELETE/api/v1/layers/:id/Delete a layer
GET/api/v1/tiles/:id/{z}/{x}/{y}.mvtGet vector tile (MVT)
POST/api/v1/ingest/Start file ingestion job
GET/api/v1/marketplace/plugins/List marketplace plugins

Method	Endpoint	Description
GET	`/api/v1/health`	Platform health check
GET	`/api/v1/layers/`	List all layers
POST	`/api/v1/layers/`	Create a new layer
GET	`/api/v1/layers/:id/`	Get layer details
DELETE	`/api/v1/layers/:id/`	Delete a layer
GET	`/api/v1/tiles/:id/{z}/{x}/{y}.mvt`	Get vector tile (MVT)
POST	`/api/v1/ingest/`	Start file ingestion job
GET	`/api/v1/marketplace/plugins/`	List marketplace plugins

Authenticate to see full reference

OpenAPI 3.0 Specification

Full OpenAPI spec available for code generation, Postman import, and automated testing.

Download openapi.json