Cesium Ion高精度地形服务Token机制解析与免费使用指南

1次阅读

共计 2778 个字符，预计需要花费 7 分钟才能阅读完成。

地形数据是三维场景的骨架。根据 Cesium 官方测试数据，使用 30 米精度的全球地形时，加载性能比 90 米精度提升 400%，而 1 米精度的城市级地形可使建筑布局精度提升 90%。传统方案如 Google Elevation API 每月免费额度仅 2.5 万次请求，而 Cesium Ion 免费层级提供：

每月 50 万次地形瓦片请求
无商用限制的 CDN 加速
支持 Quantized-Mesh 和 CTB 格式

免费账户需特别注意以下限制（对比付费账户）：

功能	免费账户	付费账户
QPS	5 次 / 秒	可定制
并发连接数	10 个	无限制
数据存储	500MB	按需扩展

访问 cesium.com/ion 点击 ”Sign Up”
选择 ”Developer Account” 类型
在 Dashboard 点击 ”Access Tokens”
生成默认 Token 或创建命名 Token（建议命名）
复制 Token 字符串（以 eyJ 开头的 JWT 格式）

const axios = require('axios');

// 环境变量配置（实际项目请用 dotenv）const ION_CLIENT_ID = process.env.CESIUM_ION_CLIENT_ID;
const ION_SECRET = process.env.CESIUM_ION_SECRET;

async function getAccessToken() {
  const response = await axios.post(
    'https://cesium.com/oauth/token',
    {
      grant_type: 'client_credentials',
      client_id: ION_CLIENT_ID,
      client_secret: ION_SECRET
    },
    {headers: { 'Content-Type': 'application/json'}
    }
  );
  return response.data.access_token;
}

async function requestTerrainTile(token, z, x, y) {
  const MAX_RETRIES = 3;
  let retryCount = 0;

  while (retryCount < MAX_RETRIES) {
    try {
      const response = await axios.get(`https://assets.cesium.com/${z}/${x}/${y}.terrain`, 
        {headers: { Authorization: `Bearer ${token}` },
          responseType: 'arraybuffer'
        }
      );
      return response.data;
    } catch (err) {if (err.response?.status === 429) {const delay = Math.pow(2, retryCount) * 1000;
        await new Promise(resolve => setTimeout(resolve, delay));
        retryCount++;
      } else {throw err;}
    }
  }
  throw new Error('Max retries exceeded');
}

// 初始化地形缓存
const dbPromise = indexedDB.open('CesiumTerrainCache', 1);
dbPromise.onupgradeneeded = (event) => {
  const db = event.target.result;
  if (!db.objectStoreNames.contains('tiles')) {db.createObjectStore('tiles', { keyPath: ['z', 'x', 'y'] });
  }
};

// 缓存优先读取
async function getCachedTile(z, x, y) {
  const db = await dbPromise;
  return new Promise((resolve) => {const tx = db.transaction('tiles', 'readonly');
    const store = tx.objectStore('tiles');
    const request = store.get([z, x, y]);
    request.onsuccess = () => resolve(request.result?.data);
  });
}

const TOKEN_POOL = [/* 多个 Token 数组 */];
let currentTokenIndex = 0;

function getNextToken() {currentTokenIndex = (currentTokenIndex + 1) % TOKEN_POOL.length;
  return TOKEN_POOL[currentTokenIndex];
}

// 在请求失败时自动切换
async function smartTerrainRequest(z, x, y) {
  try {return await requestTerrainTile(getNextToken(), z, x, y);
  } catch {return await requestTerrainTile(getNextToken(), z, x, y);
  }
}

方案一：通过后端代理转发请求（推荐）

location /cesium-terrain/ {
  proxy_pass https://assets.cesium.com/;
  proxy_set_header Authorization "Bearer $CESIUM_ION_TOKEN";
}

方案二：动态 Token 注入（SSR 场景）

<script>
  window.CESIUM_ION_TOKEN = '<%= process.env.BROWSER_TOKEN %>';
</script>

# .env 文件示例
CESIUM_ION_CLIENT_ID="your_client_id"
CESIUM_ION_SECRET="your_secret"

# 生产环境建议使用：# 1. AWS Secrets Manager
# 2. HashiCorp Vault
# 3. Kubernetes Secrets

当需要支持 1000+ QPS 时，可考虑：