@foursquare/map-sdk
The Foursquare Map SDK enables users to display and control maps published from Foursquare Studio in their own web pages.
The Foursquare Map SDK makes it easy to:
- Create bespoke user interfaces for published Foursquare Studio maps.
- Build highly interactive and performant geospatial web applications with minimal effort.
- Integrate Foursquare Studio into company workflows.
- Create deck.gl-powered visualizations without deep understanding of deck.gl programming.
For further details, please refer to the extensive online documentation.
Building
ENVIRONMENT=local VALIDATION_ENV=staging yarn build
Development
ENVIRONMENT=local VALIDATION_ENV=staging yarn start
Refer to Working with Map SDK for developing with Portal.
License
(c) 2024 Foursquare Labs, Inc. Terms available at https://location.foursquare.com/legal/terms/foursquarestudio-terms-of-service/
关于 @foursquare/map-sdk 的常见问题
@foursquare/map-sdk 是什么？
JavaScript SDK for embedding and controlling Foursquare Studio Maps
如何安装 @foursquare/map-sdk？
在项目目录运行 npm install @foursquare/map-sdk，或使用 pnpm add / yarn add / bun add。
@foursquare/map-sdk 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@foursquare/map-sdk 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。
@foursquare/map-sdk 可以商用吗？
@foursquare/map-sdk 使用 SEE LICENSE IN LICENSE.txt 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。
@foursquare/map-sdk 的下载量有多少？
根据 npm 官方下载统计，@foursquare/map-sdk 在 2026/10/16 – 2026/11/14 这 30 天内被下载 7,526 次，日均约 251 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@foursquare/map-sdk 还在维护吗？
最新版本 3.1.0 发布于 2025/03/06（1.7 年前）；至今共发布 8 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/04/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。