cesium README

The project's README from github.com/CesiumGS/cesium. As one markdown file: README.md.

CesiumJS

Build Status npm Docs

Cesium

CesiumJS is a JavaScript library for creating 3D globes and 2D maps in a web browser without a plugin. It uses WebGL for hardware-accelerated graphics, and is cross-platform, cross-browser, and tuned for dynamic-data visualization.

Built on open formats, CesiumJS is designed for robust interoperability and scaling for massive datasets.


Examples :earth_asia: Docs :earth_americas: Website :earth_africa: Forum :earth_asia: User Stories


:rocket: Get started

Visit the Downloads page to download a pre-built copy of CesiumJS.

npm & yarn

If you’re building your application using a module bundler such as Webpack, Parcel, or Rollup, you can install CesiumJS via the cesium npm package:

npm install cesium --save

Then, import CesiumJS in your app code. Import individual modules to benefit from tree shaking optimizations through most build tools:

import { Viewer } from "cesium";
import "cesium/Build/Cesium/Widgets/widgets.css";

const viewer = new Viewer("cesiumContainer");

In addition to the cesium package, CesiumJS is also distributed as scoped npm packages for better dependency management:

What next?

See our Quickstart Guide for more information on getting a CesiumJS app up and running.

Instructions for serving local data are in the CesiumJS Offline Guide.

Interested in contributing? See CONTRIBUTING.md. :heart:

:green_book: License

Apache 2.0. CesiumJS is free for both commercial and non-commercial use.

:earth_americas: Where does the Global 3D Content come from?

The Cesium platform follows an open-core business model with open source runtime engines such as CesiumJS and optional commercial subscription to Cesium ion.

CesiumJS can stream 3D content such as terrain, imagery, and 3D Tiles from the commercial Cesium ion platform alongside open standards from other offline or online services. We provide Cesium ion as the quickest option for all users to get up and running, but you are free to use any combination of content sources with CesiumJS that you please.

Bring your own data for tiling, hosting, and streaming from Cesium ion. Using Cesium ion helps support CesiumJS development.

:white_check_mark: Features

See more in the CesiumJS Features Checklist.

cesium (CesiumGS/cesium)

Searching Database…

15.8K ·GitHub
Что это такое?CesiumJS — это JavaScript-библиотека с открытым исходным кодом для создания трёхмерных глобусов и двумерных карт прямо в браузере, без плагинов — графику с аппаратным ускорением обеспечивает WebGL.
Это готовое приложение или библиотека, которую я подключаю в свой код?Это библиотека, а не отдельное приложение — вы подключаете её в код своего веб-приложения и сами создаёте интерфейс глобуса или карты.
Как добавить её в своё веб-приложение?Установите npm-пакет 'cesium' (он работает с сборщиками вроде Webpack, Parcel или Rollup) и импортируйте его в код своего приложения; готовую собранную копию также можно скачать со страницы Downloads, а Quickstart Guide пошагово проведёт вас через создание первого приложения.
Что нужно, чтобы она работала?Ничего, кроме современного браузера с поддержкой WebGL — плагин не нужен, работает во всех распространённых браузерах. Node.js 22+ требуется только для сборки или запуска самого этого репозитория.
Там уже есть готовые снимки и рельеф, или мне нужно самому предоставить 3D-контент?3D-контент в комплект не входит: рельеф, снимки и 3D Tiles подгружаются по сети, обычно с коммерческой платформы Cesium ion — это самый быстрый способ начать, хотя рядом с ней можно использовать любые источники с открытыми стандартами.
Приложения на её основе будут работать у людей с телефонов или только в браузерах на компьютере?И там, и там — CesiumJS работает во всех распространённых браузерах и изначально рассчитана на использование как на компьютере, так и на мобильных устройствах.
Могу ли я работать с ней полностью офлайн, разместив свои данные локально?Да — Cesium ion необязательна, а CesiumJS Offline Guide рассказывает, как раздавать собственные локальные данные.
Можно ли использовать её в коммерческих проектах?Да — лицензия Apache 2.0, бесплатна как для коммерческого, так и для некоммерческого использования.
Что она вообще умеет показывать?Она подгружает по сети 3D Tiles и другие стандартные форматы — рельеф, снимки, модели glTF и данные CZML (оба формата указаны в темах репозитория) — на глобус с высокой точностью координат WGS84, рассчитанный на работу с огромными объёмами данных.
Что такое @cesium/engine и @cesium/widgets?Два npm-пакета со скоупом, на которые разделена CesiumJS для более удобного управления зависимостями: в @cesium/engine находятся ядро, рендеринг и API данных, а @cesium/widgets добавляет библиотеку виджетов для сборки приложений с CesiumJS.
Зачем платная Cesium ion, если библиотека бесплатная?Это модель open-core: движок для работы приложений открыт, а его развитие финансируется за счёт необязательной коммерческой подписки Cesium ion (нарезка на тайлы, хостинг и раздача ваших данных) — пользуясь ion, вы помогаете развивать CesiumJS.
Creator
CesiumGS
Size
1.2 GB
Stars
15.8K
Age
14y
Commits · 90 Days