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
Cesium
这是什么东西?CesiumJS 是一个开源 JavaScript 库,不需要任何插件就能在浏览器里创建 3D 地球和 2D 地图——图形由 WebGL 提供硬件加速。
它是一个做好的应用,还是一个供我写代码调用的库?它是一个库,不是独立应用——你需要把它引入自己的网页应用代码里,自己搭建地球或地图界面。
怎么把它加到我的网页应用里?安装 npm 包 'cesium'(可以配合 Webpack、Parcel 或 Rollup 这类打包工具使用),然后在你的代码里引入它;下载页也提供一份构建好的版本,还有一份快速入门指南带你做出第一个应用。
运行它需要什么条件?只需要一个支持 WebGL 的现代浏览器——不用装插件,各种浏览器都能用。只有构建或运行这个代码仓库本身时,才需要 Node.js 22 或更高版本。
它自带影像和地形数据,还是 3D 内容要我自己提供?3D 内容不包含在内:地形、影像和 3D Tiles 都是通过网络流式加载的,通常来自商业化的 Cesium ion 平台——这是最快的上手方式——不过任何符合开放标准的数据源也都可以配合使用。
用它做的应用,手机上的人能用,还是只能在电脑浏览器里用?都可以——CesiumJS 支持各种浏览器,并且就是为在电脑和手机上向用户分享而设计的。
我能在完全离线的情况下,用自己本地托管的数据来运行它吗?可以——Cesium ion 是可选的,CesiumJS 的离线指南会教你如何提供自己的本地数据。
我可以在商业项目里使用它吗?可以——它采用 Apache 2.0 许可证,商业和非商业用途都免费。
它到底能显示什么?它可以把 3D Tiles 和其他标准格式的数据——地形、影像、glTF 模型和 CZML 数据(这两种格式都列在仓库的主题标签里)——加载到一个高精度的 WGS84 地球上,并且能够扩展到海量数据集。
@cesium/engine 和 @cesium/widgets 是什么?这是 CesiumJS 为了方便管理依赖而拆分成的两个带作用域的 npm 包:@cesium/engine 包含核心、渲染和数据 API,而 @cesium/widgets 则提供了一个用于搭建 CesiumJS 应用的组件库。
库本身是免费的,为什么还有一个收费的 Cesium ion?这是一种开放核心模式:运行时引擎是开源的,而可选的商业订阅服务 Cesium ion(负责数据的切片、托管和流式分发)为它提供资金支持——使用 ion 也有助于支持 CesiumJS 的开发。
What are similar projects?gods-eye-view, Leaflet, maplibre-gl-js, kepler.gl, turf, filament, city-roads, mapbox-gl-js
Which topics is it in?gltf, gis, 3d-graphics, geospatial, datasets, maps, computer-graphics, webgl, rendering, visualization, data-visualization, 3d
Creator
CesiumGS
Size
1.2 GB
Stars
15.8K
Updated
CommitOct 17Release1.146Oct 01
Age
14y
Commits · 90 Days