SuperMap iServer REST API介绍

2024-02-25 10:48
文章标签 介绍 api rest supermap iserver

本文主要是介绍SuperMap iServer REST API介绍,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

作者:MR

    SuperMap iServer (以下简称iServer)采用 REST 架构,提供了基于标准 HTTP 协议的应用编程接口——iServer REST API,这些接口封装了大部分的 GIS 功能,包括地图功能、数据功能、分析功能、三维功能等。SuperMap iServer 将这些 GIS 功能以资源的形式提供给客户端,客户端使用 iServer REST API 对资源进行操作,能够获取到相应的 GIS 能力。

    使用 iServer REST API 大致要分为以下三个步骤:

  1. 查询 SuperMap iServer REST API 帮助,确定应用所需的 REST 资源,确定每个所需传递的参数和资源的响应结构;
  2. 按照资源的 URI 和所需传递的参数构建 HTTP 请求访问资源。
  3. 参照资源的响应结构,解析服务器响应,提取所需的信息。

    已知的iServer REST API主要应用:各种版本的iClientiServer管理页面(浏览器访问 http://{IP}:{端口}/iserver/manager 开头的页面)、iServer JAVA API(部分)等,帮助文档示例位置在 开始 > iServer 开发与扩展指南 > 使用 iServer API > 使用 REST API 目录下。

    主要应用场景:

  1. iServer服务管理资源(需要安全认证),比如不通过iServer管理页对服务进行管理,包括发布、修改、删除服务;切图任务;监控;服务器配置(不包括重启)等等。
  2. 现有iClient不能满足开发需求的,比如其他后端语言使用REST API、对接现有或扩展的iServer服务等。

    iServer REST API访问被保护资源点此。

    iServer REST API分为服务资源管理资源

###一、服务资源
    服务资源即iServer发布的各种服务,iClient对接的就是这个资源。服务资源层次结构点此,服务资源根节点点此。
    除了使用iClient来访问iServer服务资源,也可以使用iServer JAVA API。

    这里简单举一个例子,比如,在浏览器直接访问以下地址:

http://support.supermap.com.cn:8090/iserver/services.rjson

    会返回support.supermap.com.cn:8090/iserver这个iServer发布的所有服务的RJSON表述(缩进的JSON字符串,便于查看,支持HTML、JSON等表述,iServer支持的表述格式点此),而上述URL末尾不写 .rjson 则默认返回html表述,也就是我们平常看到的服务列表页。
    参考services服务资源的帮助,可以知道,该资源支持HTTP GET、HEAD方法,GET方法没有需要设置的参数。其他资源以此类推,基本每个资源在帮助文档中都有请求示例。
###二、管理资源
    管理资源即对iServer进行管理的服务资源,代表应用就是iServer管理页面。管理资源层次结构点此,管理资源根节点点此
    前面的服务资源根据设置可能需要安全认证也可能不需要,但是管理资源时一定需要安全认证的,并且需要设置的认证用户有对应的权限,比如, PUBLISHER 角色的用户只能发布服务,无权创建切图任务等。
    安全认证的方式有两种,一种是token(使用iServer用户名密码生成),另一种是先使用登陆服务,再设置请求头,多为后端进行,因为浏览器有限制。

    使用JAVA访问iServer管理资源设置请求头通过安全验证的代码如下:

	/*** 登陆iServer* * @param ipport*            iServer服务根目录,比如:"http://localhost:8090"* @param username*            登陆iServer的用户名* @param passwor*            登陆iServer的密码* @return String cookie*/private String login( String ipport, String username, String passwor ){try{String json = "{\"username\": \"" + username + "\",\"password\": \"" + passwor+ "\",\"rememberme\": \"true\"}";URL url = new URL( ipport + "/iserver/services/security/login.json" );HttpURLConnection connection = (HttpURLConnection) url.openConnection( );connection.setDoInput( true );connection.setDoOutput( true );connection.setRequestMethod( "POST" );connection.setUseCaches( false );connection.setInstanceFollowRedirects( true );connection.setRequestProperty( "Content-Type", "application/x-www-form-urlencoded; charset=UTF-8" );connection.connect( );DataOutputStream out = new DataOutputStream( connection.getOutputStream( ) );out.writeBytes( json );out.flush( );out.close( );BufferedReader reader = new BufferedReader( new InputStreamReader( connection.getInputStream( ) ) );String lines;StringBuffer sbf = new StringBuffer( );while ( ( lines = reader.readLine( ) ) != null ){lines = new String( lines.getBytes( ), "utf-8" );sbf.append( lines );}System.out.println( "//" + sbf + "//" );String cookie = connection.getHeaderField( "set-cookie" );reader.close( );connection.disconnect( );return cookie;} catch ( MalformedURLException e ){e.printStackTrace( );} catch ( IOException e ){e.printStackTrace( );}return "";}

    拿到cookie后,使用别的iServer管理资源时设置请求头"cookie"(connection.setRequestProperty("cookie", cookie);)为拿到的cookie就可以正常使用iServer管理资源了。当然,使用token也是可以的。
    其他,某些REST API没有列出的iServer管理资源可以在iServer管理页对应页面抓网络请求获取。

这篇关于SuperMap iServer REST API介绍的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/745239

相关文章

基于Flask框架添加多个AI模型的API并进行交互

《基于Flask框架添加多个AI模型的API并进行交互》:本文主要介绍如何基于Flask框架开发AI模型API管理系统,允许用户添加、删除不同AI模型的API密钥,感兴趣的可以了解下... 目录1. 概述2. 后端代码说明2.1 依赖库导入2.2 应用初始化2.3 API 存储字典2.4 路由函数2.5 应

MySQL中慢SQL优化的不同方式介绍

《MySQL中慢SQL优化的不同方式介绍》慢SQL的优化,主要从两个方面考虑,SQL语句本身的优化,以及数据库设计的优化,下面小编就来给大家介绍一下有哪些方式可以优化慢SQL吧... 目录避免不必要的列分页优化索引优化JOIN 的优化排序优化UNION 优化慢 SQL 的优化,主要从两个方面考虑,SQL 语

C++中函数模板与类模板的简单使用及区别介绍

《C++中函数模板与类模板的简单使用及区别介绍》这篇文章介绍了C++中的模板机制,包括函数模板和类模板的概念、语法和实际应用,函数模板通过类型参数实现泛型操作,而类模板允许创建可处理多种数据类型的类,... 目录一、函数模板定义语法真实示例二、类模板三、关键区别四、注意事项 ‌在C++中,模板是实现泛型编程

Python实现html转png的完美方案介绍

《Python实现html转png的完美方案介绍》这篇文章主要为大家详细介绍了如何使用Python实现html转png功能,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 1.增强稳定性与错误处理建议使用三层异常捕获结构:try: with sync_playwright(

Java使用多线程处理未知任务数的方案介绍

《Java使用多线程处理未知任务数的方案介绍》这篇文章主要为大家详细介绍了Java如何使用多线程实现处理未知任务数,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 知道任务个数,你可以定义好线程数规则,生成线程数去跑代码说明:1.虚拟线程池:使用 Executors.newVir

JAVA SE包装类和泛型详细介绍及说明方法

《JAVASE包装类和泛型详细介绍及说明方法》:本文主要介绍JAVASE包装类和泛型的相关资料,包括基本数据类型与包装类的对应关系,以及装箱和拆箱的概念,并重点讲解了自动装箱和自动拆箱的机制,文... 目录1. 包装类1.1 基本数据类型和对应的包装类1.2 装箱和拆箱1.3 自动装箱和自动拆箱2. 泛型2

C#集成DeepSeek模型实现AI私有化的流程步骤(本地部署与API调用教程)

《C#集成DeepSeek模型实现AI私有化的流程步骤(本地部署与API调用教程)》本文主要介绍了C#集成DeepSeek模型实现AI私有化的方法,包括搭建基础环境,如安装Ollama和下载DeepS... 目录前言搭建基础环境1、安装 Ollama2、下载 DeepSeek R1 模型客户端 ChatBo

Java调用DeepSeek API的最佳实践及详细代码示例

《Java调用DeepSeekAPI的最佳实践及详细代码示例》:本文主要介绍如何使用Java调用DeepSeekAPI,包括获取API密钥、添加HTTP客户端依赖、创建HTTP请求、处理响应、... 目录1. 获取API密钥2. 添加HTTP客户端依赖3. 创建HTTP请求4. 处理响应5. 错误处理6.

Deepseek R1模型本地化部署+API接口调用详细教程(释放AI生产力)

《DeepseekR1模型本地化部署+API接口调用详细教程(释放AI生产力)》本文介绍了本地部署DeepSeekR1模型和通过API调用将其集成到VSCode中的过程,作者详细步骤展示了如何下载和... 目录前言一、deepseek R1模型与chatGPT o1系列模型对比二、本地部署步骤1.安装oll

浅析如何使用Swagger生成带权限控制的API文档

《浅析如何使用Swagger生成带权限控制的API文档》当涉及到权限控制时,如何生成既安全又详细的API文档就成了一个关键问题,所以这篇文章小编就来和大家好好聊聊如何用Swagger来生成带有... 目录准备工作配置 Swagger权限控制给 API 加上权限注解查看文档注意事项在咱们的开发工作里,API