ArcGIS Velocity 中的 Samdesk 源可连接到 Samdesk API，用于从 Samdesk 全球事件检测平台获取实时危机和事件警报。 Samdesk 通过监控社交媒体、新闻及其他开放信息源，在一个或多个地理位置内查找新出现的各类事件，例如自然灾害、威胁、火灾及其他公共安全事件。
示例
以下是源的使用示例：
- 公共安全机构利用 Samdesk 源实时监控新出现的事件，以便应急指挥中心在事件演进过程中进行分类与资源调配。
- 物流与供应链运营商利用 Samdesk 源检测港口、配送中心及运输通道周边发生的干扰事件。
- 国防或情报机构利用 Samdesk 源维护国家及地区层面的全球事件态势感知。
- 风险与保险分析师则利用 Samdesk 源追踪可能影响承保资产与感兴趣区域的事件。
用法说明
使用源时，请注意以下内容：
- Samdesk 使用源配置期间生成的 API 密钥以及该源项目的 URL 向该源推送数据。 请妥善保管 API 密钥以备后用。 如果密钥丢失，可在源配置中重新生成新的 API 密钥，并将新密钥提供给 Samdesk。
- 每个 Samdesk 源必须使用唯一的 API 密钥。
- 必须从 Samdesk 获取搜索流 ID 参数值才能配置源。
- Velocity 将自动处理此数据方案。 不支持添加新字段，因为方案是由 Samdesk 预先确定的。 可以移除或重命名现有字段。
- Samdesk 数据采用 JSON 格式，并且在识别关键字段时会自动处理位置参数。
- Velocity 将自动处理日期和时间与追踪部分的关键字段参数。 开始时间参数设置为 event_time，追踪 ID 参数设置为 event_id。
- Velocity 自动根据每个警报位置的 lat 和 lng 字段构建点几何。
- Velocity 中的最小轮询间隔为五秒。
- Samdesk 默认 API 速率限制为每个账户每分钟 5 个请求。 如果轮询间隔快于约 12 秒，或使用同一 API 密钥运行多个 Samdesk 源，则可能超出该限制。 如有需要，可联系 Samdesk 为您的账户申请更高的速率限制。
参数
以下是源的参数：
| 参数 | 描述 | 数据类型 |
|---|---|---|
| API 版本 （必填） | 选择用于此连接的 Samdesk API 版本。 目前仅支持版本 1。 | API 版本号 |
| API 密钥 （必填） | 用于对发送到 Samdesk API 的请求进行身份验证的 API 密钥。 示例为 https://api.samdesk.io/1/search_streams/{SEARCH_STREAM_ID}/alerts?api_key={API_KEY}。 单击生成 API 密钥选项为源生成 API 密钥。 将 API 密钥与源项目的 URL 一并提供给 Samdesk，以开始接收数据。 | Samdesk 格式类型 |
| 搜索流 ID （必填） | Samdesk 搜索流的唯一标识符。 搜索流存储用于确定哪些事件生成警报的关键字、感兴趣区域、事件类型、主题、严重性阈值和标签。 登录 Samdesk 仪表盘以找到您要轮询的搜索流的 ID。 | 字符串 |
| 其他日志记录 （可选） | 指定是否记录 Velocity 向 Samdesk 发出的原始 HTTP 请求和响应。 注：打开此参数以进行故障排除，并在完成故障排除时关闭。 在打开此参数后启动源，调试级别日志即会出现在源日志页面上。 如有必要，请联系 Esri Technical 支持 以获得故障排除方面的帮助。 | 布尔 |