Skip to content
Kohei Otsuka edited this page Jul 24, 2026 · 1 revision

FAQ

Frequently asked questions about MaplatCore.

Table of Contents


Can I use MaplatCore commercially?

Yes. MaplatCore is licensed under Apache License 2.0, which permits commercial use, modification, and redistribution. The patent grant (Patent No. 6684776) is included. See the README License section for details.

What is the difference between MaplatCore and Maplat (@maplat/ui)?

Maplat (@maplat/ui) is the end-user-facing viewer application. It is built on top of MaplatCore (@maplat/core) and adds the PWA shell, UI components (map selector, POI list, info balloon), the app-loader protocol, and i18n.

MaplatCore is the lower-level rendering library. Use @maplat/ui when you are building an end-user web app; use @maplat/core when you need lower-level control over the map lifecycle (custom UI, embedding into an existing app).

What license were past versions under?

Versions before 0.13.2 were published under the "Maplat Limited License 1.1" (a restricted license). Starting from 0.13.2, MaplatCore has reverted to Apache License 2.0. Note that npmjs.com still shows the restricted license notation for past versions — this is an npm display limitation, not a current licensing issue. See known-discrepancies for details.

Does MaplatCore require OpenLayers?

Yes. OpenLayers (ol) is a required peer dependency. MaplatCore uses OpenLayers as its rendering engine for raster tiles and the map viewport. You must install ol (^9.0.0 || ^10.0.0) yourself and import its CSS.

Mapbox GL JS and MapLibre GL JS are optional peer dependencies — only needed if you use vector tiles.

Does MaplatCore work on Node.js (server-side)?

MaplatCore is designed for browser rendering. Installing it from npm in a Node.js project is intended for development/bundling use, not for server-side rendering.

If you need server-side coordinate transform only, use @maplat/tin (which has no OpenLayers dependency) directly.


日本語版はこちら / Read this page in Japanese

See Also

MaplatCore

Language / 言語

Pages / ページ

English

日本語

External / 外部

Clone this wiki locally