TileStream 技术文档

1. 安装指南

系统要求

• Node.js v0.10.x 或 v0.8.x

安装步骤

1. 使用 npm 安装 TileStream：

   git clone https://github.com/mapbox/tilestream.git
   cd tilestream
   npm install
   

2. 启动 TileStream：

   ./index.js
   

3. 获取启动选项：

   ./index.js start --help
   

TileStream 现在应该可以通过浏览器访问 http://localhost:8888。

安装注意事项

OS X

• 推荐通过 Homebrew、PKG 安装器 或 nvm 安装 Node.js。

Ubuntu

• 推荐通过 chris-lea PPA 安装 Node.js：

  sudo apt-add-repository ppa:chris-lea/node.js
  sudo apt-get update
  sudo apt-get install nodejs nodejs-dev npm
  

2. 项目的使用说明

启动 TileStream

./index.js start

获取启动选项

./index.js start --help

完整安装

如果安装过程中出现问题，可以尝试以下步骤进行完整安装：

rm -rf node_modules
npm install

自定义端口和目录

./index.js start --uiPort=[80] --tilePort=[80] --tiles=/usr/share/tilestream

自定义配置

• 指定主机名或 IP：

  tilestream --host 127.0.0.1
  tilestream --host yourhost.com
  

• 指定 tileHost 值：

  tilestream --tileHost yourhost.com
  ./index.js start --tileHost="yourhost.com"
  

• 使用 JSON 文件配置：

  ./index.js start --config config.json
  

3. 项目API使用文档

MBTiles 文件放置位置

MBTiles 文件应放置在 ~/Documents/MapBox/tiles 目录中。每个 tileset 可以在 http://localhost:8888/map/[filename] 预览，其中 [filename] 是 tileset 文件名（不带 .mbtiles 扩展名）。

Tileset 文件名规则

• 可以包含字母（大小写）、数字、下划线或破折号。
• 不能包含点、空格、非 ASCII 字符或其他标点符号。

获取可用选项

./index.js start --help

4. 项目安装方式

通过 npm 安装

git clone https://github.com/mapbox/tilestream.git
cd tilestream
npm install

启动 TileStream

./index.js

获取启动选项

./index.js start --help

自定义配置

• 指定主机名或 IP：

  tilestream --host 127.0.0.1
  tilestream --host yourhost.com
  

• 指定 tileHost 值：

  tilestream --tileHost yourhost.com
  ./index.js start --tileHost="yourhost.com"
  

• 使用 JSON 文件配置：

  ./index.js start --config config.json
  

通过以上步骤，您可以顺利安装并使用 TileStream 项目。