地理信息公共服务平台是指由国家测绘地理信息局主管的、面向全社会提供地理信息公共服务的平台。地理信息公共服务平台服务接口规范是地理信息公共服务平台的重要组成部分,是地理信息公共服务平台与用户之间进行数据交换和信息共享的重要手段。
地理信息公共服务平台服务接口规范主要包括以下内容:
1.地理信息公共服务平台服务接口的基本要素
地理信息公共服务平台服务接口的基本要素包括服务接口的名称、服务接口的描述、服务接口的URL、服务接口的请求方式、服务接口的参数、服务接口的返回值等。
2.服务接口的分类
地理信息公共服务平台服务接口根据其功能和用途可以分为数据查询接口、数据下载接口、数据上传接口、数据更新接口、数据删除接口、数据统计接口、数据分析接口、数据挖掘接口等。
3.服务接口的命名规则
地理信息公共服务平台服务接口的命名规则应符合以下要求:
(1)服务接口的名称应简洁明了,能够准确表达服务接口的功能和用途;
(2)服务接口的名称应使用英文单词或缩写,避免使用中文或拼音;
(3)服务接口的名称应使用动词或动词短语,能够准确表达服务接口的操作。
4.服务接口的参数规范
地理信息公共服务平台服务接口的参数规范应符合以下要求:
(1)服务接口的参数应使用标准的HTTP请求参数格式;
(2)服务接口的参数应使用英文单词或缩写,避免使用中文或拼音;
(3)服务接口的参数应使用小写字母,单词之间使用下划线分隔。
5.服务接口的返回值规范
地理信息公共服务平台服务接口的返回值规范应符合以下要求:
(1)服务接口的返回值应使用标准的HTTP响应格式;
(2)服务接口的返回值应包含状态码、状态信息和返回数据等内容;
(3)服务接口的返回值应使用JSON格式,能够准确表达返回数据的结构和内容。
6.服务接口的安全规范
地理信息公共服务平台服务接口的安全规范应符合以下要求:
(1)服务接口的访问应使用HTTPS协议,确保数据传输的安全性;
(2)服务接口的访问应使用API密钥或OAuth2.0等认证方式,确保访问的合法性;
(3)服务接口的访问应设置访问频率限制,防止恶意攻击和滥用。
7.服务接口的异常处理规范
地理信息公共服务平台服务接口的异常处理规范应符合以下要求:
(1)服务接口的异常应使用标准的HTTP状态码进行返回;
(2)服务接口的异常应包含异常码、异常信息和异常原因等内容;
(3)服务接口的异常应使用JSON格式进行返回,能够准确表达异常信息的结构和内容。
相关标准
GB/T 21081-2007《地理信息元数据》
GB/T 21097-2007《地理信息服务分类与编码》
GB/T 21098-2007《地理信息服务质量》
GB/T 21122-2007《地理信息服务安全》
GB/T 21123-2007《地理信息服务异常处理》