# @foursquare/map-sdk 中文文档

规范地址：https://npmcn.com/package/%40foursquare/map-sdk/

版本：3\.1\.0
npm 元数据更新时间：2025-03-06T11:25:38.795Z
中文译文更新时间：2026-11-15T10:23:42.268Z
软件包许可：SEE LICENSE IN LICENSE\.txt

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40foursquare/map-sdk
原文对照：https://npmcn.com/package/%40foursquare/map-sdk/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：234 kB，29 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2024-04-24T18:41:54.660Z
- 最新版本发布：2025-03-06T11:25:38.598Z
- 近 30 天下载量：7526（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 0 个）

## 中文简介

JavaScript SDK 用于嵌入和控制 Foursquare 工作室地图

## 安装

```sh
npm install @foursquare/map-sdk
```

也可以使用：`pnpm add @foursquare/map-sdk`、`yarn add @foursquare/map-sdk`、`bun add @foursquare/map-sdk`

## README

# @ foursquare/地图- sdk

Foursquare Map SDK使用户能够展示和控制Foursquare Studio在自己的网页上发布的地图.

Foursquare地图 SDK使得它很容易:

-   为已出版的 Foursquare Studio 地图创建用户界面.
-   \* 尽量不费力地建立高度互动和能发挥作用的地理空间网络应用程序.
-   将Foursquare Studio纳入公司工作流程.
-   在不深入理解甲板.gl编程的情况下,创建jadle.gl-动力可视化.

详细情况请参见: [在线文档](https://location.foursquare.com/developer/docs/studio-map-sdk-overview)。 。 。 .

## 大楼

```
ENVIRONMENT=local VALIDATION_ENV=staging yarn build
```

## 发展

```
ENVIRONMENT=local VALIDATION_ENV=staging yarn start
```

参见 [与 Map SDK 合作](https://npmcn.com/package/apps/portal/README.md) 用于与门户网站一起开发.

## 许可证

(c) 2024 四平实验室股份有限公司 现有条款 [https://location.foursquare.com/legal/terms/foursquarestudio-terms-of-service/ 互联网档案馆的存檔,存档日期2014-12-21](https://location.foursquare.com/legal/terms/foursquarestudio-terms-of-service/)

## 常见问题

### @foursquare/map-sdk 是什么？

JavaScript SDK 用于嵌入和控制 Foursquare 工作室地图

### 如何安装 @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 和提交记录判断。