要使用 Spatial 的地理空间数据与分析服务，首先需要访问其官网并注册一个账号。注册过程非常简单，只需提供邮箱并设置密码，或者直接使用 Google 账号登录。完成注册后，你会进入控制台，在这里可以创建项目并获取 API 密钥。API 密钥是调用 Spatial 所有服务的基础凭证，务必妥善保存。接下来，建议先阅读官方文档中的快速入门指南，了解如何通过 REST API 或 Python SDK 发起首次请求。Spatial 也提供了浏览器端的演示工具，无需编码即可体验数据查询功能，适合初次探索。
Spatial 的核心能力在于提供经纬度级别的数据洞察。使用方法主要集中在向 API 端点发送 HTTP 请求。例如，你可以通过 /v1/places 接口传入一组坐标点或区域边界，获取该位置的人口统计、消费行为、交通流量等属性。官方文档详细列出了每一个端点的参数要求：latitude、longitude、radius（搜索半径，单位为米）以及可选的 limit（返回结果数量）。请求格式通常为 JSON，响应也是 JSON 结构，包含字段如 place_id、demographics、points_of_interest 等。建议使用 Postman 或 curl 工具进行测试，确认返回数据结构后再集成到应用中。
Spatial Insights 是平台内置的分析模块，无需编写代码即可对上传的数据进行地理增强。使用方法如下：在控制台左侧菜单选择“Insights”，然后上传 CSV 或 GeoJSON 文件，文件内需要包含经纬度列（例如 latitude 和 longitude）。上传后，系统会自动匹配 Spatial 的底层数据，并在几秒内生成可视化报告，包括热力图、聚类分布、区域对比等。你可以自定义要分析的数据维度，比如筛选特定年龄段的消费指数，或者查看某区域的家庭收入中位数。分析结果可以直接导出为图表或数据表，用于后续的决策支持。
如果你正在开发地图相关产品，Spatial 提供了 JavaScript SDK 和 Mapbox 插件。使用方法是在前端项目中通过 npm 安装 @spatialai/sdk，然后初始化 SDK 并传入 API 密钥。下一步，定义一个地图容器（例如 Leaflet 或 Mapbox 实例），调用 SDK 的 spatialLayer 方法，即可在地图上叠加 Spatial 的实时数据层。你可以控制图层的透明度、颜色渐变以及点击交互事件。例如，当用户点击地图上的某个点，SDK 会返回该点的完整 Spatial 数据对象。这种方式特别适合零售选址、物流规划等需要实时空间洞察的场景。
对于需要大规模地理空间分析的用户，Spatial 支持批量任务。使用方法：进入控制台的“Batch”选项，创建一个新的批量作业，上传包含数百万坐标点的文件，选择想要关联的数据字段（例如 population_density 或 crime_index）。系统会在数小时至数天内完成处理，处理完成后你可以通过邮件或 Webhook 接收通知。结果文件支持 CSV、Parquet 以及 Spatial 自有格式。此外，所有查询过的数据都可以通过“History”面板回溯和管理，方便重复使用或对比不同时期的空间变化。注意批量任务会消耗配额，请提前规划好预算。
在实际使用 Spatial 的过程中，有几个关键点需要留意。首先，所有 API 调用都会计算请求次数，免费套餐有每日上限，超出后需要升级订阅。其次，传入的经纬度坐标建议使用 WGS84 标准，精度至少保留六位小数，否则返回的数据可能偏差较大。另外，Spatial 的数据并非实时更新，某些统计数据可能滞后数月，适用于趋势分析而非实时监控。最后，如果需要在多台服务器上共享同一个 API 密钥，建议开启 IP 白名单限制，防止密钥泄露导致滥用。遇到技术问题时，官方文档中的“Troubleshooting”章节和社区论坛是最高效的解决途径。
