TopoJSON 📊

TopoJSON (Topology-Aware JSON)

Open Beta
.topojson · application/json

TopoJSON е разширение на GeoJSON, осъзнаващо топологията. Използва кодиране със споделени дъги (границите между полигони се съхраняват само веднъж) и целочислена квантизация на координатите — получаваният файл е с 60-80% по-малък от еквивалентния GeoJSON. Стандартен вход за D3.js, Mapshaper и Observable; идеален за интерактивни хороплетни карти и уеб атласи.

Експортирайте TopoJSON сега ✨ Отворена бета версия — безплатно, без ограничения

Основни характеристики

Кодиране със споделени дъги (60-80% по-малко от GeoJSON)
Целочислено квантуване на координатите
Опростяване със запазване на топологията
Запазени свойства на обектите

За формата TopoJSON

TopoJSON was invented by Mike Bostock, the author of D3.js, to solve a simple problem: in GeoJSON neighboring polygons store their shared border twice. TopoJSON moves all the lines into a common array of arcs that the objects then refer to. On top of that, coordinates are rounded to an integer grid and written as increments — the file gets sharply lighter.

The format is taken for web graphics and analytics: choropleths in D3, interactive atlases, boundary maps in Observable, lightweight layers for offline applications. The second motive is simplification: during generalization the shared borders move together, and no gaps appear between neighboring districts.

The output is a single document: every layer becomes a separate object inside it — roads, buildings, water and so on — and object attributes are preserved. Coordinates are in WGS84, up to 100,000 objects per layer. The topology is built by our own code, with no external dependencies.

The price of compactness is the rounding of coordinates. The grid step depends on the size of the area: for a district it is on the order of a meter, for a country hundreds of meters. For a web map that is invisible; for precise measurements take GeoJSON or GeoPackage.

Коя програма отваря файлове TopoJSON

Следните програми и приложения могат да отварят, редактират и работят с файлове TopoJSON (Topology-Aware JSON) (.topojson), експортирани от OSM2CDR:

💻D3.js 💻Mapshaper 💻topojson-server 💻topojson-client 💻Observable 💻ndjson-cli

Format specifications

Кой използва карти в TopoJSON

🏗
Интерактивни хороплетни карти в D3.js
A choropleth in D3.js draws fast: shared district borders are stored and rendered once.
💻
Уеб атласи и публикации, базирани на карти
A web atlas and cartographic publications where page weight matters.
📊
Леки карти на административни граници
Administrative boundary layers that can be simplified without gaps between neighbors.
🎨
Офлайн уеб приложения (PWA)
An offline application or a PWA: the map takes several times less space than in GeoJSON.
🗺
Анализ и визуализация (Observable)
Exploratory analysis in Observable and notebooks — the data loads as a single small file.

Как да експортирате TopoJSON

1
Изберете област
Начертайте правоъгълник или полигон на интерактивната карта на osm2cdr.ru
2
Изберете TopoJSON
Изберете TopoJSON (Topology-Aware JSON) от списъка с 127 налични формата за експорт
3
Експорт
Щракнете върху „Експорт“ и получете файла си .topojson за 1-5 минути
4
Изтегляне
Изтеглете готовия файл TopoJSON и го отворете в D3.js

Как да отворите след експорта

Популярни карти в TopoJSON

Free

Получете експорти на карти в TopoJSON (Topology-Aware JSON)

Изтеглете професионални карти в TopoJSON от OpenStreetMap. Незабавно генериране, всяка област.

Безплатно / експорт
Експортирайте TopoJSON сега →

Често задавани въпроси

По какво се различава TopoJSON от GeoJSON?
Мога ли да преобразувам TopoJSON обратно в GeoJSON?
Защо D3.js предпочита TopoJSON?
Поддържа ли TopoJSON 3D?
How are the layers arranged inside the file?
What is quantization and what does it affect?

Convert to TopoJSON and back

Свързани формати

Често експортирани заедно

Related Articles