咨询客服
AmigoCloud API
2026年07月08日 09:13
GISBox是一站式三维GIS数据编辑、转换、发布平台，支持OSGB/GEOTIFF/RVT等多种GIS格式编辑，转换为3DTiles/Terrain等并发布。
简介
AmigoCloud API是一个基于云的地理空间数据服务开放接口，用户通过专属API密钥进行身份认证后，可以对云端GIS数据集进行读取、写入、查询和管理等操作。它兼容GDAL/OGR驱动，支持矢量和栅格等多种空间数据格式，并提供Python开发包方便开发者集成，适用于移动端离线数据采集、多端数据同步等场景。
文件结构
根据公开的GDAL/OGR驱动文档及AmigoCloud API的相关信息，AmigoCloud API的文件/数据结构可从以下几个层面来描述：
- 项目（Project）层级：每个AmigoCloud账户下可创建多个项目，项目ID是访问数据的基本单元，格式通常为 AmigoCloud:<project_id>。
- 数据集（Dataset）层级：项目下包含多个数据集（相当于数据库中的表），每个数据集有唯一的dataset_id和名称，通过 datasets=id1,id2,... 参数指定访问。
- 要素/记录（Feature/Record）层级：数据集内存储的是地理要素（点、线、面），每个要素拥有系统自动生成的amigo_id（GUID）作为唯一标识，同时包含几何字段和属性字段。
- 几何字段（Geometry）：支持多种几何类型（Point、LineString、Polygon等），几何列默认允许为空（GEOMETRY_NULLABLE=YES），可通过配置修改。
- 属性字段（Attributes）：每个要素可携带任意数量的属性列，类型包括字符串、数值、日期等，支持属性过滤查询。
优点
- 无缝对接GDAL/OGR生态：作为GDAL/OGR的原生驱动，可直接用ogrinfo、ogr2ogr等成熟命令行工具访问云端数据，无需额外开发客户端，学习成本低。
- 完整的增删改查能力：通过OGR API即可映射实现INSERT（CreateFeature）、UPDATE（SetFeature）、DELETE（DeleteFeature）、CREATE TABLE（CreateLayer）、DROP TABLE（DeleteLayer）等数据库级操作，功能完备。
- 支持空间与属性双重过滤：可将空间过滤器（SetSpatialFilter）和属性过滤器（SetAttributeFilter）转发到服务端执行，减少数据传输量，提升查询效率。
- 多格式兼容：借助GDAL驱动层支持40余种矢量和栅格格式的导入导出（如Shapefile、GeoJSON、GeoPackage、FlatGeobuf等），格式互转非常方便。
- 提供Python开发包：官方提供Python SDK，便于在脚本和自动化流程中集成云端GIS数据操作。
- 适用离线与多端同步场景：特别适合移动端离线数据采集后回传云端同步的典型GIS工作流。
缺点
- 依赖网络，离线不可用：所有操作必须通过HTTPS请求到云端服务，无网络环境下完全无法使用，不适合纯离线作业。
- 频繁交互时性能受限：文档明确指出，当存在大量客户端/服务器往返交互时（如逐条插入要素），默认同步发布模式会导致性能明显下降，需要批量操作优化。
- 强依赖AmigoCloud平台：服务由AmigoCloud后端定义和控制，所有权限、可用性、服务稳定性均受制于该平台，存在供应商锁定风险。
- 文档与社区资源有限：相比主流云GIS平台（如ArcGIS Online、GeoServer），AmigoCloud的公开文档、社区讨论和第三方教程较少，遇到问题时排查难度较大。
- 功能深度不及专业GIS云平台：缺少高级空间分析、复杂编辑事务、版本管理、细粒度权限控制等企业级GIS功能，更适合轻量级数据管理而非复杂空间处理。
- 几何字段默认允许为空：GEOMETRY_NULLABLE默认为YES，若项目对数据完整性要求严格，需显式配置，否则可能产生无效几何记录。
应用场景
AmigoCloud API适用于需要将空间数据集中存储在云端并多端共享的场景，例如野外移动端离线采集数据后回传至云端进行统一管理和同步。它也适合团队协作式GIS项目，多人可通过API同时对同一数据集进行增删改查操作，实现数据的实时更新与共享。此外，借助其对多种矢量和栅格格式的支持，它还可用于不同格式空间数据之间的云端转换与分发，以及为自动化脚本和轻量级Web应用提供后端空间数据服务。
示例图
1. AmigoCloud地图。
文件打开方式
1. 受污染土地评估。
