使用已发布的服务
GeoScene REST API 是表示状态传输的简短,它为 GeoScene 提供了一个简单、开放的 Web 界面。帮助的这一部分介绍了 API 的主要部分,允许访问由 GeoScene Server 托管的服务。
REST API 公开的所有资源和操作都可通过使用 GeoScene Server 发布的每个 GIS 服务的终点层次结构或统一资源定位器 (URL) 进行访问。使用 REST API 的 GeoScene Services 部分时,通常从代表服务器目录 的熟知终点开始。请参阅资源层次结构,了解 REST API 中的服务如何结合目录。
GeoScene Server 站点的默认 REST 终点如下所示:
https://<host>:/geoscene/rest/services
例如,获取 GeoScene Online 服务的根目录的URL 如下:
https://www.geosceneonline.cn/geoscene/rest/services
从此基础 URL, 您可以浏览到与该服务关联的任何列出的服务、资源和操作。
REST API 是无状态的,这意味着 REST 不会跟踪从一个请求到下一个请求的事务。每个请求必须包含成功处理所需的所有信息。
Getting started
了解更多关于 REST API 操作的信息,请见开始中的示例。
服务目录
每一个 GeoScene Server 站点都附带一个服务目录。服务目录是可用 REST 资源和 HTML 格式操作的视图。 您可以浏览 GeoScene Server 站点的内容,并获取可用于开发应用程序的信息,例如服务元数据和支持的操作。
资源和操作
REST API 对每种GeoScene Server 服务类型都有一定级别的支持。每个服务都是一个资源,并且具有唯一的 URL。尽管 REST 系统始终只向客户端返回资源的表示形式,但为了简单起见,GeoScene REST API 的资源分为两种类型:资源和操作。有关详细信息,请参阅资源和操作。
包含操作的受支持服务类型包括地图、地理编码、地理处理、几何、要素、网络和图像。另一组服务类型作为资源受支持,但没有关联的操作,包括移动、地理数据服务。
输出格式
REST API 支持多种格式的响应。使用 URL 中的查询参数 f 指定格式。支持的格式列表包括 html(超文本标记语言)、json(JavaScript 对象表示)、图像、kmz(压缩 KML 或钥匙孔标记语言)、帮助、lyr(图层文件)、nmf(GeoScene 资源管理器地图文件)和 jsapi(JavaScript)。更多细节,请见 输出格式。
KML 支持
您可以通过多种方式请求 KML,KML 支持 中总结了这些方式。
版本控制
随着 REST API 的发展,不同版本的 API 将变为可用。有关版本控制规则的信息,请参阅 REST API 版本控制
REST API 管理
除了作为已发布数据的浏览器外,服务目录还提供对管理控制台的访问权限。 在添加、删除和更新服务或更新到新版本的 REST API 后,需要管理页来刷新网站。也可以通过控制台禁用服务目录。更多有关信息,请参见 REST API Admin.