globeletjs.org

What It Is

GlobeletJS is a lightweight JavaScript map rendering library inspired by Leaflet. Its goal is to display vector maps and GIS data on a 3D globe in the browser, avoiding the distortions introduced by flat map projections. It emphasizes simplicity, performance, and usability rather than trying to be a full 3D GIS platform. If you need complex features such as 3D buildings, the documentation explicitly recommends using CesiumJS instead.

Core Capabilities

Integration is straightforward: you can use an ESM import or an IIFE bundle, and include the corresponding CSS. The main entry point is globeletjs.initGlobe(params). Parameters include the container, information panel, MapLibre style, Mapbox token, viewport width and height, center point, camera altitude, minimum/maximum altitude, and latitude/longitude movement limits. The returned API after initialization covers map loading progress, showing or hiding layers, feature selection, zoom level, starting and stopping animations, camera and cursor state, adding/removing markers, showing/hiding the information panel, and destroy-based cleanup. This is enough to support lightweight interactive globe applications.

Ecosystem and Limitations

GlobeletJS supports MapLibre style documents, and its examples use Natural Earth data and Mapbox Outdoors Style. If you need Mapbox services, you must provide a mapboxToken. Rendering is delegated to tile-setter and is constrained by dependencies such as tile-stencil and tile-gl. The official documentation notes that many style specification features are not yet supported, positioning it as an “80/20” solution: covering the main mapping needs with a smaller codebase. This means it is well suited to lightweight visualization, but not to complex cartographic specifications or advanced 3D GIS scenarios.

Pricing and Open Source

The documentation does not list any paid plans. The site marks it as open source and encourages improvements through its contributing guidelines. In practical use, GlobeletJS itself can be treated as a free, open-source tool. However, if your styles or tiles depend on third-party services such as Mapbox, the relevant tokens, quotas, and costs need to be evaluated separately.

Pros, Cons, and Who It’s For

Its strengths are a clear concept, simple integration, and API documentation on the homepage that covers the main workflow. It is suitable for frontend developers who want to quickly build global point visualizations, natural geography displays, or lightweight GIS layer presentations. Its drawbacks are incomplete style support, documentation that reads more like an API list, and limited information about production deployment, compatibility, and advanced use cases. It fits teams that need a “lightweight 3D globe for the web.” If you need full geospatial analysis, 3D buildings, or mature commercial support, you should compare it with alternatives such as CesiumJS, MapLibre GL JS, and Leaflet.

Access from China

The captured text does not provide information about access from China, mirrors, or payment. The examples rely on the unpkg CDN and may use Mapbox services; access stability for these can be uncertain in mainland China. For real deployments, it is recommended to evaluate CDN reachability, consider self-hosting static assets, or choose tile and style services that are reliably accessible from China.